api Error Messages - IBM/IFT-Developer-Zone GitHub Wiki
When posting data to an IBM Food Trust™ endpoint you may receive an error indicating a supplied ID value does not match the expected IBM Food Trust or GS1 identifier patterns.
{
"message": "EPCISBody.eventList.aggregationEvents[0].parentID: Type must match one of the following patterns: [EPC_SSCC, EPC_SGTIN, FTLPN, SSCC_LA, SFTPI]. Visit this url to look up the pattern error codes. https://github.com/IBM/IFT-Developer-Zone/wiki/api-Error-Messages"
}
You can use the following table to reference the accepted pattern codes specified in the error.
| Code | 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>.<ItemRefAndIndicator>.*(13 Digits + '*') |
| GS1-GTIN |
40987650000223 <Indicator><CompanyPrefix><ItemRef><CheckDigit>(14 Digits) |
| GS1-SSCC |
204623406700001014 <Extension><CompanyPrefix><SerialReference><CheckDigit>(18 Digits) |
| GS1-GLN |
6056234000013 <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 |
| FTPI | urn:ibm:ift:product:class:1234567890123.product-123 urn:ibm:ift:product:class: <Company Prefix>.<Item Reference>
|
| FTLI_CUSTOM | urn:ibm:ift:location:<TYPE>:loc:<ID> urn:ibm:ift:location:unlocode:loc:usnyc |
| LFTPI | urn:ibm:ift:product:lot:class:1234567890123.product-123.lot4 urn:ibm:ift:product:lot:class: <Company Prefix>.<Item Reference>.<Lot Number>
|
| SFTPI | urn:ibm:ift:product:serial:obj:1234567890123.product-123.serial-number-4567 urn:ibm:ift:product:serial:obj: <Company Prefix>.<Item Reference>.<Serial Number>
|
| SFTLI_CUSTOM | urn:ibm:ift:location:<TYPE>:ext:loc:<ID>.<EXT> urn:ibm:ift:location:unlocode:ext:loc:usnyc.import |
| FTLI | urn:ibm:ift:location:loc:1234567890123.store-123 urn:ibm:ift:location:loc: <Company Prefix>.<Location Reference>
|
| SFTLI | urn:ibm:ift:location:extension:loc:1234567890123.store-123.toy-department urn:ibm:ift:location:extension:loc: <Company Prefix>.<Location Reference>.<Extension>
|
| FTLPN | urn:ibm:ift:lpn:obj:1234567890123.pallet-12345678 urn:ibm:ift:lpn:obj: <Company Prefix>.<Serial Reference>
|
| SSCC_LA | urn:ibm:provenance:ids:supplychain:aggregation:lpn:5012345.xyz123 urn:ibm:provenance:ids:supplychain: <Document Type>:lpn:<Company Prefix>.* |
| IFT_ENTITY | urn:ibm:ift:bt:1234567890123.store-123.1234 urn:ibm:ift:bt: <Company Prefix>.<Location Reference>.<Transaction Id>
|
| IFT_DISPOSITION | urn:ibm:ift:bv:disp:destroyed urn:ibm:ift:bv: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 |
| HTTP_URI |
http://client.domain.com/path/custom_biz_step_1 https://client.domain.com/path/custom_biz_step_2 Accepts any valid URI that begins with http:// or https://
|