doc GS1 - IBM/IFT-Developer-Zone GitHub Wiki
Global Standards One (GS1) is a not-for-profit global business organization that develops and maintains standards and services for supply chain participants. GS1 standards enable businesses that use divergent processes and procedures to interact and transact with clarity and efficiency.
GS1 provides a method for registering identifiers for company prefixes, locations, and products. Each registered identifier is a unique ID (UUID) that can be used on any supply chain, worldwide. The following list of GS1 Identifier Types are commonly used in IBM Food Trust™. A complete list of GS1 ID types is available on the GS1 site. GS1 ID types.
| Identifier | Description | Examples |
|---|---|---|
| GTIN | Global Trade Item Number (products and services) | Milk, mangoes, tomatoes |
| GLN | Global Location Number (parties and locations) | Businesses, warehouses, retail stores |
| SSCC | Serial Shipping Container Code or Logistics units | Pallets, containers |
As shown in Table 1, IBM Food Trust uses GS1 URNs, which follow the GS1 Tag Data Standard:
Table 1. GS1 URNs
| Element | Example and Syntax |
|---|---|
| EAN-13 / GTIN-13 formats | Attention: IBM Food Trust does not support EAN-13 / GTIN-13 formats; please add a leading zero (0) to construct a GTIN-14 URN. |
| EPC-SSCC |
urn:epc:id:sscc:5012345.0678901234 urn:epc:id:sscc:<CompanyPrefix>.<ExtensionAndSerialRef>(17 Digits) |
| EPC-SGTIN |
urn:epc:id:sgtin:0614141.107346.2017 urn:epc:id:sgtin:<CompanyPrefix>.<IndicatorDigit><ItemRef>.<SerialNumber>(13 Digits + Serial Number) |
| EPC-SGLN |
urn:epc:id:sgln:0614141.00777.0 urn:epc:id:sgln:<CompanyPrefix>.<LocationReference>.<Extension>(12 Digits + Extension) |
| EPC-LGTIN |
urn:epc:class:lgtin:0614141.107346.101 urn:epc:class:lgtin:<CompanyPrefix>.<IndicatorDigit><ItemRef>.<Lot>(13 digits + Lot) |
| EPC-GTIN |
urn:epc:idpat:sgtin:0614141.107346.* urn:epc:idpat:sgtin:<CompanyPrefix>.<IndicatorDigit><ItemRef>.*(13 Digits + '*') |
| GS1-GTIN |
40987650000223 <Indicator><CompanyPrefix><ItemRef><CheckDigit>(14 Digits) |
| GS1-SSCC |
409876506700001010 <Extension><CompanyPrefix><SerialReference><CheckDigit>(18 Digits) |
| GS1-GLN |
4098765000010 <CompanyPrefix><LocationReference><CheckDigit>(13 Digits) |
| GS1_ENTITY | urn:epcglobal:cbv:bt:1234567890123:T1234 urn:epcglobal:cbv:bt: <GS1-GLN>:<Transaction ID>
|
| GS1_ENTITY_TYPE | urn:epcglobal:cbv:btt:po urn:epcglobal:cbv:btt: <Business Transaction Type> Valid Business Transaction Types = bol, desadv, inv, pedigree, po, poc, prodorder, recadv, rma |
| GS1_BIZSTEP | urn:epcglobal:cbv:bizstep:receiving urn:epcglobal:cbv:bizstep: <bizStep> Valid bizSteps = accepting, arriving, assembling, collecting, commissioning, consigning, creating_class_instance, cycle_counting, decommissioning, departing, destroying, disassembling, dispensing, encoding, entering_exiting, holding, inspecting, installing, killing, loading, other, packing, picking, receiving, removing, repackaging, repairing, replacing, reserving, retail_selling, shipping, staging_outbound, stock_taking, stocking, storing, transforming, transporting, unloading, unpacking, void_shipping Note: Custom bizSteps are also supported in the format of a valid HTTP URL starting with either http:// or https://. The recommended format is http://<client-controlled-domain-name>/<path>/<biz_step_name>
|
| GS1_DISPOSITION | urn:epcglobal:cbv:disp:destroyed urn:epcglobal:cbv:disp: <Disposition> Valid Dispositions = active, container_closed, damaged, destroyed, dispensed, disposed, encoded, expired, in_progress, in_transit, inactive, no_pedigree_match, non_sellable_other, partially_dispensed, recalled, reserved, retail_sold, returned, sellable_accessible, sellable_not_accessible, stolen, unknown |
| GS1_SOURCE_DEST_TYPE | urn:epcglobal:cbv:sdt:possessing_party urn:epcglobal:cbv:sdt: <Source Destination Type> Valid Source Destination Types = owning_party, possessing_party, location |
For EPCIS Events on a vehicle or ship in transit, GS1 read point geo-coordinates are supported using RFC5870 compliant URNs. Valid geographic coordinates for <readPoint><geo> XML are comma-separated latitude,longitude coordinates or comma-separated latitude,longitude,altitude coordinates, as shown in the following examples:
<readPoint><geo>geo:13.4125,-103.8667</geo></readPoint>
<readPoint><geo>geo:13.4125,103.8667,9.098</geo></readPoint>
IBM Food Trust surfaces read point data through the Trace API only, it is not available through the UI. For an example of IBM Food Trust read point upload syntax, see the annotated Commission Event XML. For GS1 read point details, refer to section 7.3.4 of the GS1 EPCIS Standard, at https://www.gs1.org/sites/default/files/docs/epc/EPCIS-Standard-1.2-r-2016-09-29.pdf.