ESM Receipt Errors (EPCIS v1.2)

The following errors may be encountered with the Serialized Operations Manager Receipt (EPCIS v1.2) inbound message:

Data Element Error Message Description
Class 1
AggregationEvent | action Action ADD is required for is required for the AggregationEvent !!! The error occurs if bizStep = "urn:epcglobal:cbv:bi​zstep:packing", but the source does not equal "ADD" for an aggregation event.
AggregationEvent | bizLocation | id Event location in the aggregation event is required !!! The error occurs if the source is empty or null.
AggregationEvent | bizStep 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" for an aggregation event.
AggregationEvent | childEPCs | epc Invalid EPC format !!! The error occurs if the source could not be translated.
AggregationEvent | 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" for an aggregation event.
AggregationEvent | parentID Invalid EPC format !!! The error occurs if the source is empty or null.
bizTransaction | @type Valid bizTransaction type is required if bizTransaction is populated !!! The error occurs if bizTransaction is populated, but the source is empty or null.
attribute(1) Ship to business party name is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Ship from business party name is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Carrier business party name is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Sold to business party name is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Sold from business party name is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Valid packagingLevel code required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
attribute(2) Party type is required if additional facility identifier is populated !!! The error occurs if attribute | @id = "http://epcis.tracelink.com/mda/additionalIdentifier", but the source is empty or null.
Party type is required if additional business party identifier is populated !!! The error occurs if attribute | @id = "http://epcis.tracelink.com/mda/additionalIdentifier", but the source is empty or null.
Party type is required if additional business party identifier is populated !!! The error occurs if attribute | @id = "http://epcis.tracelink.com/mda/additionalIdentifier", but the source is empty or null.
Party type is required if additional facility identifier is populated !!! The error occurs if attribute | @id = "http://epcis.tracelink.com/mda/additionalIdentifier", but the source is empty or null.
attribute(3) Valid carrier business party identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
Valid sold to business party identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
Valid ship to location identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
Valid sold from business party identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
attribute(4) Valid business classification code is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
Valid business classification code is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
attribute(5) Carrier business party street address is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Sold from business party street address is required !!! The error occurs if VocabularyElement | attributefields are present, but the source is empty or null.
Sold to business party street address is required !!! The error occurs if VocabularyElement | attributefields are present, but the source is empty or null.
Ship from location street address is required !!! The error occurs if VocabularyElement | attributefields are present, but the source is empty or null.
Ship to location street address is required !!! The error occurs if VocabularyElement | attributefields are present, but the source is empty or null.
attribute(8) Ship to location city is required !!! The error occurs if VocabularyElement | attributefields are present, but the source is empty or null.
Sold from business party city is required !!! The error occurs if VocabularyElement | attributefields are present, but the source is empty or null.
Carrier business party city is required !!! The error occurs if VocabularyElement | attributefields are present, but the source is empty or null.
Ship from location city is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Sold to business party city is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
attribute(10) Sold from business party state or region is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Sold to business party state or region is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Ship to location state or region is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Carrier business party state or region is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Ship from location state or region is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
attribute(12) 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.
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.
Carrier business party country is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
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.
Valid Ship from location country is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
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.
Ship to location country is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Sold to business party country is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Ship from location country is required !!! The error occurs if VocabularyElement | attribute fields are present, but the source is empty or null.
Sold from business party country is required !!! The error occurs if VocabularyElement/attribute fields are present, but the source is empty or null.
cbvmda:itemExpirationDate Expiration date is required !!! The error occurs if the serial number type is China, GTIN, or NTIN, but the source is empty or null.
cbvmda:lotNumber Lot number is required !!! The error occurs if the serial number type is China, GTIN, or NTIN, but the source is empty or null.
choice%1 One of internalMaterialCode or packagingItemCode or countryDrugCode is required !!!

The error occurs if tl:internalMaterialCode, tl:packagingItemCode, and tl:countryDrugCode are empty or null.
destinationList | 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.
destinationList | destination Valid ship-to business lookup identifier type is required !!! The error occurs if the source is empty or null.
EPCISMasterData Party master data is required in receiving message !!! The error occurs if VocabularyList in the source is empty or null.
ObjectEvent (Commissioning Events) | action Action ADD is required for ObjectEvent commissioning !!! The error occurs if bizStep = "urn:epcglobal:cbv:bi​zstep:commissioning", but the source does not equal "ADD" for a commissioning event.
ObjectEvent (Commissioning Event) | bizLocation | id Event location in the commissioning event is required !!! The error occurs if the source is empty or null.
ObjectEvent (Commissioning Events) | bizStep 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" for a commissioning event.
ObjectEvent (Commissioning Events) | disposition 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" for a commissioning event.
ObjectEvent (Commissioning Events) | epcList | epc Invalid EPC format !!! The error occurs if the source is empty or null.
ObjectEvent (Receiving Events) Receiving event data is required !!! The error occurs if receiving event is not present in source.
Only one receiving event is required !!! The error occurs if more than one receiving event is present.
ObjectEvent (Receiving Events) | action Action OBSERVE is required for ObjectEvent receiving !!! The error occurs if bizStep = "urn:epcglobal:cbv:bi​zstep:in_progress", but the source does not equal "OBSERVE" for a receiving event.
ObjectEvent (Receiving Events) | bizStep bizStep urn:epcglobal:cbv:bizstep:receiving is required for ObjectEvent receiving !!! The error occurs if the source does not equal "urn:epcglobal:cbv:bizstep:receiving" for a receiving event.
ObjectEvent (Receiving Events) | bizTransactionList Biz transaction list is required in receiving event !!! The error occurs if the source is empty or null.
ObjectEvent (Receiving Events) | disposition Dispositio​n urn:epcglobal:cbv:disp:in_progress is required for ObjectEvent receiving !!! The error occurs if the source does not equal "urn:epcglobal:cbv:disp:in_progress" for a receiving event.
ObjectEvent (Receiving Events) | epcList | epc At least one serial number in epcList is required !!! The error occurs if the source is empty or null.
ObjectEvent (Receiving Events) | extension | sourceList | 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.
ObjectEvent (Receiving Events) | readPoint | id Event location in the receiving event is required !!! The error occurs if the source is empty or null.
sbdh:Receiver | sbdh:Identifier | @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.
sbdh:Sender | sbdh:Identifier | @Authority Valid Sender/Identifier Authority is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
tl:countryDrugCode | @type Country drug code type is required if country drug code is populated !!! The error occurs if countryDrugCode is populated but the source is empty or null, or is not a valid value from the enumeration list.
tl:countryMarket Valid ISO country code is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
tl:fieldName Field name is required if ExtensionField group present in source !!! The error occurs if ExtensionField group is populated, but the source is empty or null.
tl:fieldValue Field value is required if ExtensionField group present in source !!! The error occurs if ExtensionField group is populated, but the source is empty or null.
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:packagingLevel Packaging Level is required !!! The error occurs if the serial number type is China, GTIN, or NTIN, but the source is empty or null.
tl:packagingItemCode | @type Packaging item code type is required !!! The error occurs if packagingItemCode is populated but the source is empty or null, or is not a valid value from the enumeration list.
Packaging item code type required if packagingItemCode is populated !!! The error occurs if packagingItemCode is populated but the source is empty or null, or is not a valid value from the enumeration list.
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 value greater than 0 is required !!! The error occurs if the source = "0", OrderItemList is present and the source is less than 0, or the source is empty or null.
tl:receiptDistributionType Valid receipt distributionType is required !!! The error occurs if the source is empty or null, or is not a valid value from the enumeration list.
tl:receivingEventExtensions receivingEventExtensions required if receiving event populated !!! The error occurs if receiving event is populated, but the source is empty or null.
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.
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 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 unitPrice is populated but 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 = "http://epcis.tracelink.com/hc/cn-edmc/obj/", but the source is empty or null.
VocabularyElement Ship to party info required in VocabularyElement if present in sourceList !!! The error occurs if ship to is present in sourceList, but not in VocabularyElement.
Ship to party info required in VocabularyElement if present in destinationList !!! The error occurs if ship to is present in destinationList, but not in VocabularyElement.
Sold to party identifier is required !!! The error occurs if the source is empty or null.
Sold from party identifier is required !!! The error occurs if the source is empty or null.
Ship from party info required in VocabularyElement if present in sourceList !!! The error occurs if ship from party is present in sourceList, but not in VocabularyElement.
Carrier party info required in VocabularyElement if present in sourceList !!! The error occurs if carrier party is present in sourceList, but not in VocabularyElement.
VocabularyElement | @id Valid carrier business party lookup identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | @id Valid ship to location identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | @id Valid ship to location lookup identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | @id Valid sold to business party identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | @id Item code is required in source VocabularyElement[@id] !!! The error occurs if the source is empty or null.
VocabularyElement | @id 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.
VocabularyElement | @id Valid sold to business party lookup identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | @id Valid ship from business party identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | @id Valid carrier business party identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | @id Valid sold from business party lookup identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
VocabularyElement | @id Valid sold from business party identifier type is required !!! The error occurs if the source is present, but there is no matching entry in the lookup file.
Class 2
@currencyCode CurrencyCode for shipping event for delivery <DeliveryNumber> not found. The error occurs if UnitPrice is populated, but the source is empty or null.
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.
destination | destinationList SOM Receiving 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.
destination | destinationList | @type Could not perform Location Master Data lookup to populate receiver shipping address fields. <ShipToLocationLookupId / type> <ShipToLocationLookupId> is not configured in your Company Location Master Data nor in your Partner Location Master Data. Please configure <ShipToLocationLookupId / type> <ShipToLocationLookupId> in Company Location Master Data or in Partner Location Master Data (if the ship to location is a partner location) and reprocess the file. The error occurs if cmn:ShipToLocationLookupId | @type or cmn:ShipToLocationLookupId is empty or null in Company or Partner Location Master Data.
destination | destinationList | @type Could not perform Company Master Data lookup to populate receiver business address fields. <ToBusinessPartyLookupId / type> <ToBusinessPartyLookupId> is not configured in your Company Master Data. Please configure <ToBusinessPartyLookupId / type> <ToBusinessPartyLookupId> in 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.
epcList | epc Serial Number <ParentSerial> reference in aggregation but not present in ReceivingEvent / NumberList The error occurs if the source is not present in ReceivingEvent | NumberList.
N/A Serial Number <ParentSerial> reference in aggregation but not present in ReceivingEvent / NumberList The error occurs if all top-most parent serial numbers are not present in ReceingEvent | NumberList elements.
Cannot perform operation on serial number <serial number> with serial number item state <item state>. This operation can only be performed when the serial number is Pending Receipt or Shipped. The error occurs if Serial Number was not shipped.
Could not commission parent serial number <ParentSerial> because it is not an SSCC Number The error occurs if ParentSerial is not an SSCC Number.
source | sourceList | @type 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 cmn:CarrierBusinessPartyLookupId is empty or null in Company or Partner Company Master Data.
source | sourceList | @type Could not perform Master Data lookup to populate sender shipping address fields. <ShipFromLocationLookupId / type> <ShipFromLocationLookupId> is not configured in your Company or Partner Location Master Data. Please configure <ShipFromLocationLookupId / type> <ShipFromLocationLookupId> in Company or Partner Location Master Data, 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.
source | sourceList | @type Could not perform Master Data lookup to populate sender business address fields. <FromBusinessPartyLookupId / type> <FromBusinessPartyLookupId> is not configured in your Company or Partner Master Data. Please configure <FromBusinessPartyLookupId / type> <FromBusinessPartyLookupId> in Company or Partner 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.
sourceList SOM Receiving 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 occurs from the EU FMD markets where the ShipToCountryCode is China, US, South Korea, or Russia and the ShipFromCountryCode is an EU FMD country.
tl:contractType ContractType for receiving event for delivery <DeliveryNumber> not found. The error occurs if ShipToCountryCode = "KR" and ReceiptDistributionType = "InCountryReturn", but the source is empty or null.
tl:contractType ContractType for receiving event for delivery <DeliveryNumber> not found. The error occurs if ShipToCountryCode = "KR", but the source does not equal either "PrivateContract" or "CompetitiveBid".
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:orderItem OrderItemList for shipping event for delivery <DeliveryNumber> not found. The error occurs if ShipToCountryCode = "KR" and ReceiptDistributionType = "InCountryReturn", but the source is empty or null.
tl:orderItem OrderItems for receiving event for delivery <DeliveryNumber> not found. The error occurs if ShipToCountryCode = "KR" and ReceiptDistributionType = "InCountryReturn", but the source is empty or null.
tl:shipFromCountryCode SOM Receiving 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 SOM Receiving 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:supplyType SupplyType for receiving event for delivery <DeliveryNumber> not found. The error occurs if ShipToCountryCode = "KR" and ReceiptDistributionType = "InCountryReturn", but the source is empty or null.
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 UnitPrice is for receiving event for delivery <DeliveryNumber> not found. The error occurs if ShipToCountryCode = "KR" and ReceiptDistributionType = "InCountryReturn", 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.
tl:receivingEventExtensions | tl:deliveryCompleteFlag Expected [Quantity] for Item [Item Code], Lot [Lot Number] but [each-level Serial Number Count] item serial numbers were found.

The error occurs if the quantity of serial numbers received:

  • Is greater than the quantity of serial numbers specified in the order item details and tl:deliveryCompleteFlag = false.

  • Does not match the quantity of serial numbers specified in the order item details and tl:deliveryCompleteFlag = true.

The error is thrown when incrementally receiving serial numbers.
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.