-
Notifications
You must be signed in to change notification settings - Fork 34
api Error Messages
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, consiging, 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: 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>
|
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>
|
FTLI | urn:ibm:ift:location:loc:1234567890123.store-123 urn:ibm:ift:location:loc: <Company Prefix>.<Location Reference>
|
FTLI_CUSTOM | urn:ibm:ift:location::loc: urn:ibm:ift:location:unlocode:loc:usnyc |
SFTLI | urn:ibm:ift:location:extension:loc:1234567890123.store-123.toy-department urn:ibm:ift:location:extension:loc: <Company Prefix>.<Location Reference>.<Extension>
|
SFTLI_CUSTOM | urn:ibm:ift:location::ext:loc:. urn:ibm:ift:location:unlocode:ext:loc:usnyc.import |
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 |
WELCOME!
Modules
Membership
Languages
Browsers
ONBOARDING
Onboarding Steps
Data Requirements
Data Types
Supplier Data
Payload Data
Insights Data
HOW-TO
Join by Invitation
Log in as New User
Authenticate Human Users
Authenticate System Users
Java Sample
Typescript Sample
IIB Sample
Assign User Roles
Upload Data
Automate Data Upload
Convert Spreadsheets
Convert Data
Whitelist Custom URLs
APIs-Swagger
Connector API
Documents API
Converter API
Trace API
Insights API
APIs-Usage
APIs
Insights API
Insights API Usage
Trace API
Connector API Errors
API Error Codes
REFERENCE
GS1
GS1 Identifier Reuse
Authentication
Identifiers
Message Codes
Cryptographic
Signatures
Signature Header
Access Control
Firewall Settings
XML to JSON
EPCIS Aggregation Add
EPCIS Aggregation Delete
EPCIS Object Add
EPCIS Object Delete
EPCIS Object Observed
EPCIS Transformation
Purchase Order
Despatch Advice
Receiving Advice
Master Data Item
Master Data Facility
Standard Business
Document Header