Capture Interface


The EPCWeb application exposes a capture Interface in compliance with the standards. The standard EPCIS Capture Interface acquires EPCIS events to populate an Event Repository. The proposed RESTful Capture Interface accepts a POST request whose payload is the current standard XML representation of an EPCIS event. This request triggers the creation of the corresponding IDN-Document in the IDN infrastructure. The POST response returns an HTTP URI referencing the newly created resource. To support the data reuse, when an event is POSTed to the Capture Interface, the system is queried for the related entity elements (EPC, location or reader) to be processed. If an element is found it is reused, otherwise it is created and indexed by the Serach service. For data having a URN associated, the URN is used as a keyword in the indexing procedure so that it is always possible to retrieve the HTTP URI from the URN. In this sense, the Search service serves as the ONS. The URI templates for the resources are listed hereafter:



where authority refers to the authoritative VR service for the IDN-Document addressed in the URI. Each player in the reference scenario can choose its own trusted VR service to be authoritative over the data produced within its domain.

How to

Entering a new event in the system it is as easy as preparing an HTTP request as follows:


Sample XML Events

In the following are presented some somples of XML events accepted by the the application.

Object Event

The sample includes a list of two differnet object events

<EPCISDocument xmlns:epcis="urn:epcglobal:epcis:xsd:1" schemaVersion="1" creationDate="2006-07-11T11:30:47.0Z">
	<EPCISBody>
		<EventList>
			<ObjectEvent>
				<eventTime>2006-04-03T20:33:31.116-05:00</eventTime>
				<recordTime>2006-04-03T20:33:31.116-05:00</recordTime>
				<eventTimeZoneOffset>+2</eventTimeZoneOffset>
				<epcList>
					<epc>urn:epc:id:sgtin:0614141.107346.2017</epc>
				</epcList>
				<action>OBSERVE</action>
				<bizStep>urn:epcglobal:epcis:bizstep:fmcg:shipped</bizStep>
				<disposition>urn:epcglobal:epcis:disp:fmcg:transit</disposition>
				<readPoint>
					<id>urn:epc:id:sgln:0614141.07347.124</id>
				</readPoint>
				<bizLocation>
					<id>urn:epc:id:sgln:0614141.33254.0</id>
				</bizLocation>
				<bizTransactionList>
					<bizTransaction type="urn:epcglobal:fmcg:btt:po">http://transaction.acme.com/po/54847</bizTransaction>
				</bizTransactionList>
			</ObjectEvent>
			<ObjectEvent>
				<eventTime>2006-04-04T20:33:31.116-05:00</eventTime>
				<recordTime>2006-04-03T20:33:31.116-05:00</recordTime>
				<eventTimeZoneOffset>+2</eventTimeZoneOffset>
				<epcList>
					<epc>urn:epc:id:sgtin:0614141.107346.2017</epc>
				</epcList>
				<action>OBSERVE</action>
				<bizStep>urn:epcglobal:epcis:bizstep:fmcg:received</bizStep>
				<disposition>urn:epcglobal:epcis:disp:fmcg:processing</disposition>
				<readPoint>
					<id>urn:epc:id:sgln:0614141.07473.384</id>
				</readPoint>
				<bizLocation>
					<id>urn:epc:id:sgln:0614141.33482.0</id>
				</bizLocation>
				<bizTransactionList>
					<bizTransaction type="urn:epcglobal:fmcg:btt:po">http://transaction.acme.com/po/54847</bizTransaction>
				</bizTransactionList>
			</ObjectEvent>
		</EventList>
	</EPCISBody>
</EPCISDocument>   	          
   	        

Aggregation Event

The sample includes a single aggregation event

<EPCISDocument creationDate="2008-06-17T03:03:16.703Z" schemaVersion="1" xmlns:epcis="urn:epcglobal:xsd:1">
	<EPCISBody>
		<EventList>
			<AggregationEvent>
			<eventTime>2008-06-17T19:03:16.109Z</eventTime>
			<eventTimeZoneOffset>-05:00</eventTimeZoneOffset>
			<parentID>urn:epc:tag:sgtin-96:2.1234567.100150.1</parentID>
			<childEPCs>
				<epc>urn:epc:tag:sgtin-96:0.1234567.200150.0</epc>
			</childEPCs>
			<action>OBSERVE</action>
			<bizStep>urn:epcglobal:bizstep:fmcg:received</bizStep>
			</AggregationEvent>
		</EventList>
	</EPCISBody>
</EPCISDocument>
			

Transaction Event

The sample includes a single transaction event

<EPCISDocument xmlns:epcis="urn:epcglobal:epcis:xsd:1" schemaVersion="1" creationDate="2006-07-11T11:30:47.0Z">
	<EPCISBody>
		<EventList>
			<TransactionEvent>
				<eventTime>2006-04-03T20:33:31.116-05:00</eventTime>
				<recordTime>2006-04-03T20:33:31.116-05:00</recordTime>
				<eventTimeZoneOffset>+02:00</eventTimeZoneOffset>
				<bizTransactionList>
					<bizTransaction type="urn:epcglobal:fmcg:btt:po">
						http://transaction.acme.com/po/54847
					</bizTransaction>
				</bizTransactionList>
				<parentID>urn:epc:tag:sgtin-96:2.1234567.100150.1</parentID>
				<epcList>
					<epc>urn:epc:id:sgtin:0614141.107346.2017</epc>
				</epcList>
				<action>OBSERVE</action>
				<bizStep>urn:epcglobal:epcis:bizstep:fmcg:shipped</bizStep>
				<disposition>
					urn:epcglobal:epcis:disp:fmcg:transit
				</disposition>
				<readPoint>
					<id>urn:epc:id:sgln:0614141.07347.124</id>
				</readPoint>
				<bizLocation>
					<id>urn:epc:id:sgln:0614141.33254.0</id>
				</bizLocation>
			</TransactionEvent>
		</EventList>
	</EPCISBody>
</EPCISDocument>   	        
   	        

Quantity Event

The sample includes a single quantity event

<EPCISDocument xmlns:epcis="urn:epcglobal:epcis:xsd:1" schemaVersion="1" creationDate="2006-07-11T11:30:47.0Z">
	<EPCISBody>
		<EventList>
			<QuantityEvent>
				<eventTime>2006-04-03T20:33:31.116-05:00</eventTime>
				<recordTime>2006-04-03T20:33:31.116-05:00</recordTime>
				<eventTimeZoneOffset>+03:00</eventTimeZoneOffset>
				<epcClass>urn:epcglobal:epcis:vtype:EPCClass</epcClass>
				<quantity>15</quantity>
				<bizStep>urn:epcglobal:epcis:bizstep:fmcg:shipped</bizStep>
				<disposition>urn:epcglobal:epcis:disp:fmcg:transit</disposition>
				<readPoint>
					<id>urn:epc:id:sgln:0614141.07347.124</id>
				</readPoint>
				<bizLocation>
					<id>urn:epc:id:sgln:0614141.33254.0</id>
				</bizLocation>
				<bizTransactionList>
					<bizTransaction type="urn:epcglobal:fmcg:btt:po">http://transaction.acme.com/po/54847</bizTransaction>
				</bizTransactionList>
			</QuantityEvent>
		</EventList>
	</EPCISBody>
</EPCISDocument>