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:bi​zstep: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:di​sp:in_transit is required for ObjectEvent shipping !!! The error occurs if the source does not equal "urn:epcglobal:cbv:di​sp: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.