ESM Shipment Errors (EPCIS v1.2)

The following errors may be encountered with the TL_EPCIS_SOM_ESM_Ship_1_2_IB message:

Data Element Error Message Description
Class 1
AggregationEvent | parentID Invalid EPC format !!! The error occurs if the serial number cannot be translated to GS1 Application Identifier format.
Invalid EPC format !!! The error occurs if the source has unrecognized content.
@Authority Valid Receiver/Identifier Authority is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
Valid Sender/Identifier Authority is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
bizLocation | id Event location in the aggregation event is required !!! The error occurs if the source is empty or null.
Event location in the commissioning event is required !!! The error occurs if the source is empty or null.
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:bi​zstep:shipping".
bizStep urn:epcglobal:cbv:bi​zstep:packing is required for the AggregationEvent !!! The error occurs if the source does not equal "urn:epcglobal:cbv:bi​zstep:packing".
bizStep urn:epcglobal:cbv:bi​zstep:commissioning is required for ObjectEvent commissioning !!! The error occurs if the source does not equal "urn:epcglobal:cbv:bi​zstep:commissioning".
bizTransaction | @type Valid bizTransaction type is required if bizTransaction is populated !!! The error occurs if cmn:BizTransaction is populated, but the source is empty or null.
bizTransactionList Biz transaction list is required in shipping event !!! The error occurs if the source is empty or null.
cbvmda:itemExpirationDate Expiration date is required !!! The error occurs if the source is empty or null. Required for GTIN, NTIN, and China.
cbvmda:lotNumber Lot number is required !!! The error occurs if the source is empty or null. Required for GTIN, NTIN, and China.
destination Valid sold-to business lookup identifier type is required !!! The error occurs if the source is empty or null.
Ship-to party identifier must match an identifier in VocabularyElement | @id !!! The error occurs if no match is found between destinationList | destination and VocabularyElement | @id in the party master data header when party master address data is populated in the header.
Valid ship-to business lookup identifier type is required !!! The error occurs if the source is empty or null.
"urn:epcglobal:cbv:sdt:possessing_party" type in destinationList/destination is invalid !!! "urn:epcglobal:cbv:sdt:location" is required if location present in source !!! The error occurs if ship-to party address info is not present in the header master data extensions and if destination | @type = "urn:epcglobal:cbv:sdt:possessing_party".
disposition Dispositio​n urn:epcglobal:cbv:di​sp:in_progress is required for the AggregationEvent !!! The error occurs if the source does not equal "urn:epcglobal:cbv:di​sp:in_progress".
Dispositio​n 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".
Dispositio​n urn:epcglobal:cbv:di​sp:active is required for ObjectEvent commissioning !!! The error occurs if the source does not equal "urn:epcglobal:cbv:di​sp:active".
epc Invalid EPC format !!! The error occurs if the serial number cannot be translated to GS1 Application Identifier format.
Invalid EPC format !!! The error occurs if the source has unrecognized content.
At least one serial number in epcList is required !!! The error occurs if the source is empty or null.
readPoint | id Event location in the shipping event is required !!! The error occurs if the source is empty or null.
ObjectEvent Only one shipping event is required !!! The error occurs if more than one shipping event is present.
Shipping event data is required !!! The error occurs if the source is empty or null.
source Valid sold-from business lookup identifier type is required !!! The error occurs if the source is empty or null.
Valid ship-from business lookup identifier type is required !!! The error occurs if the source is empty or null.
Ship-from party identifier must match an identifier in VocabularyElement | @id !!! The error occurs if no match is found between sourceList | source and VocabularyElement | @id in the party master data header when party master address data is populated in the header.
Carrier party identifier must match an identifier in VocabularyElement | @id !!! The error occurs if no match is found between sourceList | source and VocabularyElement | @id in the party master data header when party master address data is populated in the header.
Valid carrier business lookup identifier type is required !!! The error occurs if the source is empty or null.
"urn:epcglobal:cbv:sdt:possessing_party" type in sourceList/source is invalid !!! "urn:epcglobal:cbv:sdt:location" is required if location present in source !!! The error occurs if ship-from party address info is not present in the header master data extensions and if source | @type = "urn:epcglobal:cbv:sdt:possessing_party".
tl:lineManagerName Line manager name for China product is required !!! The error occurs if epcList | epc prefix = "http://epcis.tracelink.com/hc/cn-edmc/obj/", but the source is empty or null.
tl:orderItem | choice%1 One of internalMaterialCode or packagingItemCode is required !!! The error occurs if both tl:internalMaterialCode and tl:packagingItemCode are empty or null.
tl:packagingItemCode | @type Packaging item code type is required !!! The error occurs if the source is empty or null, or source is not a valid value from the enumeration list, and tl:packagingItemCode is populated.
tl:packagingLevel Packaging Level is required !!! The error occurs if the source is empty or null. Required for GTIN, NTIN, and China.
tl:productionLineId Production line ID for China product is required !!! The error occurs if epcList | epc prefix = "http://epcis.tracelink.com/hc/cn-edmc/obj/", but the source is empty or null.
tl:quantity Quantity is required !!! The error occurs if OrderItemList is populated, but the source is empty or null.
tl:salesDistributionType Valid sales distributionType is required !!! The error occurs if the source is empty or null, or is not a valid value from the enumeration list.
tl:shipFromCountryCode Valid ISO country code is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
Ship from country for export products is required !!! The error occurs if SalesDistributionType = EXPORTSALE, EXPORTTRANSFER, or EXPORTRETURN, but the source is empty or null.
tl:shippingEventExtensions shippingEventExtensions required if shipping event populated !!! The error occurs if shipping event is populated, but the source is empty or null.
tl:shipToCountryCode Valid ISO country code for ship-to country is required !!! The error occurs if the source is empty or null, or is not a valid value from the enumeration list.
tl:supplyType Valid supply type code is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
tl:transactionDate Transaction date is required !!! The error occurs if the source is empty or null.
tl:unitPrice | @currencyCode Valid ISO currency code is required !!! The error occurs if the source is empty or null, or is not a valid value from the enumeration list.
tl:warehouseOperatorName Warehouse operator name for China product is required !!! The error occurs if epcList | epc = "urn:epc:id:cnedmc:", but the source is empty or null.
VocabularyElement Sold to party identifier is required !!! The error occurs if soldTo party does not exist as a VocabularyElement | @id. SoldTo party must match destinationList owning party.
Ship from party info required in VocabularyElement if present in sourceList !!! The error occurs if shipFrom party is present in sourceList, but missing in source.
Sold from party identifier is required !!! The error occurs if soldFrom party does not exist as a VocabularyElement | @id.
Ship to party info required in VocabularyElement if present in destinationList !!! The error occurs if shipTo party is present in sourceList, but missing in source.
Carrier party info required in VocabularyElement if present in sourceList !!! The error occurs if carrier party is present in sourceList, but missing in the source.
VocabularyElement | attribute Ship from location street address is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Carrier business party street address is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Sold from business party city is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Ship to business party name is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Sold to business party name is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Ship from business party name is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Sold from business party name is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Carrier business party name is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Sold to business party street address is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Valid ship from location identifier type is required !!! The error occurs if the source is empty or null, or is not a valid value from the enumeration list.
VocabularyElement | attribute Ship to location street address is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Party type is required if additional business party identifier is populated !!! The error occurs if additionalBusinessParty is populated, but the source is empty or null.
VocabularyElement | attribute Valid carrier business party identifier type is required !!! The error occurs if the source is empty or null, or is not a valid value from the enumeration list.
VocabularyElement | attribute Valid business classification code is required !!! The error occurs if the source is empty or null, or is not a valid value from the enumeration list.
VocabularyElement | attribute Valid ship to location identifier type is required !!! The error occurs if the source is empty or null, or is not a valid value from the enumeration list.
VocabularyElement | attribute Ship from location country is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Valid sold from business party identifier type is required !!! The error occurs if the source is empty or null, or is not a valid value from the enumeration list.
VocabularyElement | attribute Valid Ship to location country is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | attribute Valid Sold to business party country is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | attribute Valid sold to business party identifier type is required !!! The error occurs if the source is empty or null, or is not a valid value from the enumeration list.
VocabularyElement | attribute Party type is required if additional facility identifier is populated !!! The error occurs if additionalIdentifierType is populated, but the source is empty or null.
VocabularyElement | attribute Sold to business party city is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Sold from business party street address is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Ship from location city is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Packaging Level is required if header master data is populated !!! The error occurs if master data is populated in the header extension, but the source is empty or null.
VocabularyElement | attribute Valid packagingLevel code required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | attribute Ship to location city is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Ship to location state or region is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Sold from business party state or region is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Carrier business party city is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Ship from location state or region is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Carrier business party state or region is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Carrier business party country is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Valid Carrier business party country is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | attribute Sold from business party country is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Valid Sold from business party country is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | attribute Sold to business party country is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Ship to location country is required !!! The error occurs if the source is empty or null.
VocabularyElement | attribute Sold to business party state or region is required !!! The error occurs if the source is empty or null.
VocabularyElement | @id Item code is required in source VocabularyElement | @id !!! The error occurs if the source is empty or null.
SGTIN or NTIN or CN-EDMC in VocabularyElement id is required !!! The error occurs if the source is not an SGTIN, NTIN, or CN-EDMC and master data is present in the header extension.
Valid carrier business party identifier type is required !!! The error occurs if the source is empty or null.
Valid sold from business party identifier type is required !!! The error occurs if the source is empty or null.
Valid ship from business party identifier type is required !!! The error occurs if the source is empty or null.
Valid sold to business party identifier type is required !!! The error occurs if the source is empty or null.
Valid ship to business party identifier type is required !!! The error occurs if the source is empty or null.
Class 2
bizTransaction | @date Transaction Identifier Date is required if Ship To Country Code = RU. The error occurs if tl:shipToCountryCode = "RU" but the source is empty or null.
destinationList SOM Shipment inbound processing could not be completed. The ReceiverInfo with either ToBusinessPartyLookupId or ToBusinessPartyInfo for the ShipFromCountryCode of <ShipFromCountryCode> and ShipToCountryCode of <ShipToCountryCode> must be specified. The error occurs if the source is empty or null and:
  • Transfer or sale occurs in non-EU FMD markets where the ShipToCountryCode is not an EU FMD country and the ShipFromCountryCode is not an EU FMD country.
  • Transfer or sale export occurs from the EU FMD markets where the ShipToCountryCode is China, US, South Korea, or Russia and the ShipFromCountryCode is an EU FMD country.
destinationList | destination | @type Could not perform Master Data lookup to populate receiver business address fields. <ToBusinessPartyLookupId / type> <ToBusinessPartyLookupId> is not configured in your Company or Partner Company Master Data. Please configure <ToBusinessPartyLookupId / type> <ToBusinessPartyLookupId> in Company or Partner Company Master Data, and reprocess the file. The error occurs if cmn:ToBusinessPartyLookupId | @type or cmn:ToBusinessPartyLookupId is empty or null in Company or Partner Company Master Data.
Could not perform Location Master Data lookup to populate receiver shipping address fields. <ShipToLocationLookupId / type> <ShipToLocationLookupId> is not configured in your Company or Partner Location Master Data. Please configure <ShipToLocationLookupId / type> <ShipToLocationLookupId> in Company Partner Location Master Data and reprocess the file. The error occurs if cmn:ShipToLocationLookupId | @type or the source is empty or null in Company or Partner Location Master Data.
sourceList SOM Shipment inbound processing could not be completed. The SenderInfo with either FromBusinessPartyLookupId or FromBusinessPartyInfo for the ShipFromCountryCode of <ShipFromCountryCode> and ShipToCountryCode of <ShipToCountryCode> must be specified. The error occurs if the source is empty or null and:
  • Transfer or sale occurs in non-EU FMD markets where the ShipToCountryCode is not an EU FMD country and the ShipFromCountryCode is not an EU FMD country.
  • Transfer or sale export from the EU FMD markets where the ShipToCountryCode is China, US, South Korea, or Russia and the ShipFromCountryCode is an EU FMD country.
sourceList | source | @type Could not perform Master Data lookup to populate sender business address fields. <FromBusinessPartyLookupId / type> <FromBusinessPartyLookupId> is not configured in your Company or Partner Company Master Data. Please configure <FromBusinessPartyLookupId / type> <FromBusinessPartyLookupId> in Company or Partner Company Master Data, and reprocess the file. The error occurs if cmn:FromBusinessPartyLookupId | @type or cmn:FromBusinessPartyLookupId is empty or null in Company or Partner Company Master Data.
Could not perform Location Master Data lookup to populate sender shipping address fields. <ShipFromLocationLookupId / type> <ShipFromLocationLookupId> is not configured in your Company Location Master Data nor in your Partner Location Master Data. Please configure <ShipFromLocationLookupId / type> <ShipFromLocationLookupId> in Company Location Master Data or in Partner Location Master Data (if the ship from location is a partner location), and reprocess the file. The error occurs if cmn:ShipFromLocationLookupId | @type or cmn:ShipFromlocationLookupId is empty or null in Company or Partner Location Master Data.
Could not perform Master Data lookup to populate transportation carrier business address fields. <CarrierBusinessPartyLookupId / type> <CarrierBusinessPartyLookupId > is not configured in your Company or Partner Company Master Data. Please configure <CarrierBusinessPartyLookupId / type> <CarrierBusinessPartyLookupId > in Company or Partner Company Master Data, and reprocess the file. The error occurs if cmn:CarrierBusinessPartyLookupId | @type or the source is empty or null in Company or Partner Company Master Data.
tl:commissionEventExtensions | tl:internalMaterialCode Item Codes do not match between aggregation levels The error occurs if all packaging levels are not consistent between either tl:internalMaterialCode, tl:countryDrugCode, or both.
tl:countryDrugCode Item Codes do not match between aggregation levels The error occurs if all packaging levels are not consistent between either tl:internalMaterialCode, tl:countryDrugCode, or both.
tl:fundingSource Funding Source is required if Ship To Country Code is RU and Ship From Country Code is RU. The error occurs if both tl:shipToCountryCode and tl:shipFromCountryCode = "RU", but the source is empty or null.
tl:OrderItemList Delivery <Delivery Number> could not be processed. Expected <Pick Quantity> for Item <Item Code>, Lot <Lot Number> but <EA Level Serial Number Count> item serial numbers were found. The error occurs if AllowShortVerificationCount = true, but derived quantity is greater than OrderItemQuantity.
Delivery <Delivery Number> could not be processed. Expected <Pick Quantity> for Item <Item Code>, Lot <Lot Number> but <EA Level Serial Number Count> item serial numbers were found. The error occurs if AllowShortVerificationCount = false, but derived quantity does not equal OrderItemQuantity.
tl:salesDistributionType Serial Numbers with Recalled status cannot be shipped. The error occurs if salesDistrubutionType = INCOUNTRYSALE or EXPORTSALE for sales shipments, but one or more serial numbers have a Recalled reason code.
tl:shipFromCountryCode SOM Shipment inbound processing could not be completed. Both the ShipToCountryCode and ShipFromCountryCode must be specified when the Sender Info and ReceiverInfo are not specified. The error occurs if the sourceList and destinationList are both omitted, and tl:shipToCountryCode and tl:ShipFromCountrycode are empty or null.
tl:shipToCountryCode
tl:transactionIdentifier | @date Order Item Transaction Identifier Date is required if Ship To Country Code = RU. The error occurs if tl:shipToCountryCode = "RU" but the source is empty or null.
tl:unitPrice Unit Price is required if Ship To Country Code is RU and Ship From Country Code is any of RU, AM, BY, KZ, KG. The error occurs if tl:shipToCountryCode = "RU" and tl:shipFromCountryCode = "AM", "BY", "KG", "KZ", or "RU", but the source is empty or null.
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.