ESM Shipment Errors (EPCIS v1.0)
The following errors may be encountered with the TL_EPCIS_SOM_ESM_Ship_1_0_IB message:
| Data Element | Error Message | Description |
|---|---|---|
| Class 1 | ||
| bizStep | bizStep urn:epcglobal:cbv:bizstep:shipping is required for ObjectEvent shipping !!! | The error occurs if the source does not equal "urn:epcglobal:cbv:bizstep:shipping" for a shipping event. |
| @currencyCode | Currency Code is required if Unit Price exists !!! | The error occurs if UnitPrice is populated, but the source is empty or null. |
| disposition | Disposition urn:epcglobal:cbv:disp:in_transit is required for ObjectEvent shipping !!! | The error occurs if the source does not equal "urn:epcglobal:cbv:disp:in_transit". |
| epc | Invalid EPC format !!! | The error occurs if the epc number cannot be translated. |
| epc | Invalid EPC format !!! | The error occurs if source has any unrecognized content. |
| epc | Serial number in source epc is required !!! | The error occurs if the source is empty or null. |
| eventTimeZoneOffset | EventTimeZoneOffset occurs fewer times than its minimum number of occurrences!!! | The error occurs if the source is empty or null. |
| id | Event Location is required !!! | The error occurs if the source is empty or null. |
| ObjectEvent | Shipping event is required !!! | The error occurs if source is missing a Shipment message. |
| readpoint | id | Business transaction type is required !!! | The error occurs if the source is empty or null. |
| sbdh:Identifier | Sender GLN in source MessageSender is required !!! | The error occurs if the source is empty or null. |
| Receiver GLN in source MessageRecipient is required !!! | The error occurs if the source is empty or null. | |
| sbdh:InstanceIdentifier | The output string is shorter than minimum length specified for the target field. | The error occurs if the source is empty or null. |
| Source error: "Data Error: InstanceIdentifier occurs fewer times than its minimum number of occurrences." | The error occurs if the source is empty or null. | |
| tl:businessClassification | Sold from BusinessClassification is required if ShipFromCountryCode is "KR" and SalesDistributionType is <SalesDistributionType> !!! | The error occurs if ShipFromCountryCode = KR and SalesDistributionType = EXPORTSALE or INCOUNTRYSALE, but source is empty or null. |
| tl:businessId | Carrier business party ID is required !!! | The error occurs if the source is empty or null. |
| Transfer from business party ID is required !!! | The error occurs if the source is empty or null. | |
| Transfer to business party ID is required !!! | The error occurs if the source is empty or null. | |
| tl:businessId | @type | Transfer from business party ID type is required !!! | The error occurs if the source is empty or null. |
| Transfer to business party ID type is required !!! | The error occurs if the source is empty or null. | |
| Carrier business party ID type is required !!! | The error occurs if the source is empty or null. | |
| tl:businessName | Transfer to business party's name is required !!! | The error occurs if the source is empty or null. |
| Ship from party name is required !!! | The error occurs if the source is empty or null. | |
| Transfer to business party name is required !!! | The error occurs if the source is empty or null. | |
| Transfer from business party name is required !!! | The error occurs if the source is empty or null. | |
| Ship to party name is required !!! | The error occurs if the source is empty or null. | |
| tl:city | Transfer to business party city is required !!! | The error occurs if the source is empty or null. |
| Ship from party city address is required !!! | The error occurs if the source is empty or null. | |
| Ship to party city address is required !!! | The error occurs if the source is empty or null. | |
| Transfer to business party city is required !!! | The error occurs if the source is empty or null. | |
| Transfer from business party city is required !!! | The error occurs if the source is empty or null. | |
| tl:contractType | ContractType is required if ShipFromCountryCode is "KR" and SalesDistributionType is <SalesDistributionType> !!! | The error occurs if ShipFromCountryCode = KR and SalesDistributionType = EXPORTSALE or INCOUNTRYSALE, but source is empty or null. |
| Valid Contract Type is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. | |
| tl:country | Ship to party country is required !!! | The error occurs if the source is empty or null. |
| Ship from party country is required !!! | The error occurs if the source is empty or null. | |
| Transfer to business party country is required !!! | The error occurs if the source is empty or null. | |
| Transfer to business party's name is required !!! | The error occurs if the source is empty or null. | |
| Transfer from business party country is required !!! | The error occurs if the source is empty or null. | |
| tl:district | 3-digit numeric District code required for country India !!! | The error occurs if tl:country = IN, but source is not a 3-digit numeric code. |
| tl:facilityId | Ship to party facility ID is required !!! | The error occurs if the source is empty or null. |
| Ship from party facility ID is required !!! | The error occurs if the source is empty or null. | |
| tl:facilityId | @type | Ship to party facility ID type is required !!! | The error occurs if the source is empty or null. |
| Ship from party facility ID type is required !!! | The error occurs if the source is empty or null. | |
| Valid Ship to party facility ID type is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. | |
| Valid Ship from party facility ID type is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. | |
| tl:name | Contact name is required if source contactInfo is populated !!! | The error occurs if the source is empty or null. |
| tl:packagingItemCode | @type | Product type attribute is required when source PackagingItemCode is populated !!! | The error occurs if cmn:PackagingItemCode is populated, but the source is empty or null. |
| Valid Item Code Type is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. | |
| tl:quantity | Quantity is required if IsSerialized = "false". | The error occurs if IsSerialized = false, but source is empty or null. |
| tl:salesDistributionType | Valid Sales Distribution Type is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. |
| tl:shipFromCountryCode | Valid ShipFrom Country Code is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. |
| tl:shipToCountryCode | Valid ShipTo Country Code is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. |
| Ship to country code is required !!! | The error occurs if the source is empty or null. | |
| tl:stateOrRegion | Transfer to business party state or region is required !!! | The error occurs if the source is empty or null. |
| Ship from party state or region code is required !!! | The error occurs if the source is empty or null. | |
| Ship to party state or region code is required !!! | The error occurs if the source is empty or null. | |
| Transfer from business party state or region is required !!! | The error occurs if the source is empty or null. | |
| Transfer to business party's state or region is required !!! | The error occurs if the source is empty or null. | |
| tl:street1 | Transfer to business party street address is required !!! | The error occurs if the source is empty or null. |
| Ship from party street address is required !!! | The error occurs if the source is empty or null. | |
| Ship to party street address is required !!! | The error occurs if the source is empty or null. | |
| Transfer to business party street address is required !!! | The error occurs if the source is empty or null. | |
| Transfer from business party street address is required !!! | The error occurs if the source is empty or null. | |
| tl:supplyType | Valid Supply Type is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. |
| SupplyType is required if ShipFromCountryCode is "KR" and SalesDistributionType is <SalesDistributionType> !!! | The error occurs if ShipFromCountryCode = KR and SalesDistributionType = EXPORTSALE or INCOUNTRYSALE, but source is empty or null. | |
| tl:telephone | User Command Error: Contact Telephone of ShipTo is required !!! | The error occurs if the source is empty or null. |
| tl:transactionDate | Transaction date is required !!! | The error occurs if the source is empty or null. |
| tl:unitPrice | UnitPrice is required if ShipFromCountryCode is "KR" and SalesDistributionType is <SalesDistributionType> !!! | The error occurs if ShipFromCountryCode = KR and SalesDistributionType = EXPORTSALE or INCOUNTRYSALE, but source is empty or null. |
| tl:warehouseOperatorName | Warehouse operator name for China product is required !!! | The error occurs if epcList | epc equals "http://epcis.tracelink.com/obj/cn-edmc/", but source is empty or null. |
| Class 2 | ||
| tl:internalMaterialCode | Item Codes do not match between aggregation levels | The error occurs if packaging levels do not have the same tl:internalMaterialCode. |
| aggragateParams.items | no serial number found in the feed | The error occurs if no serial number is found in the feed. |
| body.getShippingEvent | More than one ShippingEvent found | The error occurs if more than one ShippingEvent was found. |
| ci.getMessageBody | message body is null | The error occurs if the source is empty or null. |
| CommissionCommonAttributes, EventLocation, EventTimeZoneOffset, EventDateTime, NumberList | Required field <x> is null | The error occurs if a required field is empty or null. |
| DeliveryNumber, EventDateTime, EventTimeZoneOffset, SenderInfo, ReceiverInfo, TransactionDate, TransactionIdentifier | Required field <x> is null (DeliveryNumber, EventDateTime, EventTimeZoneOffset, SenderInfo, ReceiverInfo, TransactionDate, TransactionIdentifier) | The error occurs if a required field is empty or null. |
| EventTimeZoneOffset | invalid EventTimeZoneOffset | The error occurs if source is invalid. |
| expirationDate | Required ExpirationDate is empty | The error occurs if the source is empty or null. |
| item.currencyCode, receipt.receiptFromCountryCode, item.unitPrice | CurrencyCode for receiving event for delivery <receipt.deliveryNumber> not found. format(receipt.deliveryNumber) | The error occurs if the CurrencyCode is not found. |
| item.unitPrice, receipt.receiptFromCountryCode, receipt.receiptType | UnitPrice for receiving event for delivery <receipt.deliveryNumber> not found. format(receipt.deliveryNumber) | The error occurs if the UnitPrice not found. |
| lotNumber | Required LotNumber is empty | The error occurs if the source is empty or null. |
| ParentSerial | invalid ParentSerial | The error occurs if source is invalid. |
| ParentSerial, EventLocation, EventTimeZoneOffset, EventDateTime, NumberList | Required field <x> is null (ParentSerial, EventLocation, EventTimeZoneOffset, EventDateTime, NumberList) | The error occurs if a required field is empty or null. |
| receipt.contractType, receipt.receiptFromCountryCode, receipt.receiptType | ContractType for receiving event for delivery <receipt.deliveryNumber> not found. format(receipt.deliveryNumber) | The error occurs if the ContractType is not found. |
| receipt.contractType, receipt.receiptFromCountryCode, receipt.receiptType | ContractType for receiving event for delivery <receipt.deliveryNumber> has invalid value. format(receipt.deliveryNumber) | The error occurs if the ContractType is invalid. |
| receipt.orderItems, receipt.receiptFromCountryCode, receipt.receiptType | OrderItemList for receiving event for delivery <receipt.deliveryNumber> not found. format(receipt.deliveryNumber) | The error occurs if the OrderItemList is not found. |
| receipt.receiptFromLocation.district | <ShipFromLocation> district field for <receiving> event for delivery <receipt.deliveryNumber> must contain exactly 3 numeric digits. ("ShipFromLocation", "receiving", receipt.deliveryNumber) | The error occurs if source does not contain exactly 3 numeric digits. |
| receipt.receiptFromParty.district | <FromBusinessParty> district field for <receiving> event for delivery <receipt.deliveryNumber> must contain exactly 3 numeric digits. ("FromBusinessParty", "receiving", receipt.deliveryNumber) | |
| receipt.receiptToLocation.district | <ShipToLocation> district field for <receiving> event for delivery <receipt.deliveryNumber> must contain exactly 3 numeric digits. ("ShipToLocation", "receiving", receipt.deliveryNumber) | |
| receipt.receiptToParty.district | <ToBusinessParty> district field for <receiving> event for delivery <receipt.deliveryNumber> must contain exactly 3 numeric digits. ("ToBusinessParty", "receiving", receipt.deliveryNumber) | |
| receipt.supplyType, receipt.receiptFromCountryCode, receipt.receiptType | SupplyType for receiving event for delivery <receipt.deliveryNumber> not found. format(receipt.deliveryNumber) | The error occurs if the SupplyType is not found. |
| receipt.supplyType, receipt.receiptFromCountryCode, receipt.receiptType | SupplyType for receiving event for delivery <receipt.deliveryNumber> contains invalid value. format(receipt.deliveryNumber) | The error occurs if the SupplyType is invalid. |
| receipt.transportationCarrier.district | <CarrierBusinessParty> district field for <receiving> event for delivery <receipt.deliveryNumber> must contain exactly 3 numeric digits. ("CarrierBusinessParty", "receiving", receipt.deliveryNumber) | The error occurs if source does not contain exactly 3 numeric digits. |
| shippingParamsList.size | More than one ShippingParam found | The error occurs if more than one ShippingParam is found. |
| txn.orderID | invalid transaction identifier value: i.getValue | The error occurs if the source is invalid. |
| txn.orderType | invalid transaction identifier type: i.getType | The error occurs if the source is invalid. |
| Class 3 | ||
| The following is thrown for all Class 3 errors: “INTERNALERROR=Internal error from server [server details].” Please contact Support if this error is encountered. | ||