api Error Messages

API Error Codes

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://