Product release APIs
Why do I use these messages?
Use the following messages to update the status of serial numbers within a lot to Quality Released, indicating that the lot is ready to be released to the market (e.g. it has passed quality inspection).
Serial numbers can be released before being commissioned in TraceLink. If serial numbers are not associated with the item code and lot number specified in the message, TraceLink preserves the item code and lot number association and updates serial numbers for the lot with the Product Release item attribute when they are commissioned.
Which reports do these messages generate?
These messages generate one of the following reports in the Russia Compliance application if their contents meet the report conditions:
- OMS Foreign Utilisation and 915 - Multi Pack (generated together) – The OMS Foreign Utilisation report captures information about serialized items that are manufactured in a country other than Russia before being imported to Russia for distribution and the 915 - Multi Pack report captures the aggregation hierarchy of those items.
- 313 - Register Product Emission – The 313 - Register Product Emission captures information about serialized items that are manufactured and released in Russia.
Product Release (XML)

Message Type: SOM_PRODUCT_RELEASE.
Info Exchange Display Name: Product Release

Data Element | Occurs Length |
Type | Description | ||||
---|---|---|---|---|---|---|---|
som:SOMProductReleaseMessage | - |
1...1- | Required. This is the root element of the Product Release message. | ||||
som:ControlFileHeader | - |
1...1- | Required. The ControlFileHeader element is where the message document's header information resides. | ||||
cmn:FileSenderNumber | 1/20 |
1...1String | Required. The company identifier of the file’s sender (e.g. 8888882028655). | ||||
cmn:FileReceiverNumber | String | Required. The company identifier of the file’s recipient (e.g. 8888882028677). | |||||
cmn:FileControlNumber | String | Required. This field indicates the message’s unique file control ID number. A file control ID number is mandatory for all messages (e.g. 20130821063132). | |||||
cmn:FileDate | Date | Required. This field indicates the date that the message is sent. The date is in YYYY-MM-DD format when generated in XML (e.g. 2013-08-21). | |||||
cmn:FileTime | Time | Required. This field indicates the time that the message is sent. The date is in HH:MM:SSZ format when generated in XML. The system expects the "Z" to be appended; however if it is not included, the system assumes that the time is GMT and therefore appends the Z (e.g. 06:31:32Z). | |||||
som:MessageBody | - |
1...1- | Required. The message body contains the main contents of the message. | ||||
cmn:LocationId | 0/34 |
0...1String | This value specifies the identifier of the facility/warehouse to scope the Product Release status update for the serial numbers matching the specified item code and lot number, only at the specified location. If the location is omitted, the Product Release status update will be applied globally to all matching serial numbers in the system (e.g. 8888882028655). | ||||
choice%1 | - - |
Choice | Required. One of the following options must be chosen, but not both:
|
||||
cmn:InternalMaterialCode | 1/* |
0...1String | Conditionally required if cmn:CountryDrugCode is not present. This is Option 1 for the MessageBody. It is used to identify the product using the internal material number configured in the Product Master Data. Specifying an internal material number will update all serial numbers at all packaging levels (e.g. item, case) that are linked to the internal material number and specified lot number (e.g. 100253). | ||||
cmn:CountryDrugCode | 1/* |
0...1String | Conditionally required if cmn:InternalMaterialCode is not present. This is Option 2 for the MessageBody. Use to identify the product using the national drug code (e.g. NDC, Swissmedic, PZN) configured in Product Master Data. Specifying a national drug code will update all serial numbers at all packaging levels (e.g. item, case) that are linked to the national drug code and specified lot number (e.g. 0069-4220-66). | ||||
@type | 1/* |
1...1String | Required. Country drug code type.
See the CountryDrugCode enumeration list for valid values. |
||||
cmn:LotNumber | 1/* |
1...1String | Required. The lot number associated with the cmn:InternalMaterialCode or cmn:CountryDrugCode specified above to identify the serial numbers to be updated (e.g. A12345). | ||||
cmn:QualityControlEntityId | 0/* |
0...1String | Conditionally required if bizTransactionList in the ObjectEvent for Product Release Events is populated, or if at least one Target Market in Product Master Data = "RU" and the lot was commissioned outside of Russia. Business or location identifier for the entity responsible for quality control (e.g. 0882028677010). | ||||
@type | 1/* |
1...1String | Required. Business or location type of the quality control entity identifier (e.g. GLN). See the BusinessAndLocationId enumeration list for valid values. |
||||
cmn:TransactionIdentifier | 0/* |
0...*String | Optional. The transaction identifier associated with the released product (e.g. 45006290016). | ||||
@type | 1/* |
1...1String | Required. The transaction identifier type (e.g. CERTIFICATECONFORMITY). Valid values:
See the TransactionId enumeration list for valid values. |
||||
@date | 0/* |
0...1Date | Conditionally required if at least one Target Market in Product Master Data = RU and the lot was commissioned in Russia. The transaction identifier date in YYYY-MM-DD format (e.g. 2019-03-18). |
||||
cmn:EventDateTime | 0/* |
0...1DateTime | Timestamp of the date and time of the product release with the UTC time zone indicator in XML YYYY-MM-DDTHH:MM:SS:mmZ format (e.g. 2019-03-18T22:08:021Z). | ||||
cmn:ProductionQuantity | - |
0...*- | Production quantity element group. | ||||
choice1 | - |
1...1Choice | Required. Choice element of either PackagingItemCode or CompanyPrefix. | ||||
cmn:PackagingItemCode | 0/* |
0...1String | Conditionally required if cmn:CompanyPrefix is not populated. Option 1 for choice1. Identifies the product using the packaging level item code configured in Product Master Data (e.g. 50300694220667). | ||||
@type | 0/* |
0...1String | Required. Packaging item code type (e.g. GTIN-14). See the ItemCode enumeration list for valid values. |
||||
cmn:CompanyPrefix | 0/* |
0...1String | Conditionally required if cmn:PackagingItemCode is not populated. Option 2 for choice1. Identifies the company prefix assigned by GS1 for the released product (e.g. 503006). | ||||
cmn:PackagingLevel | 1/* |
1...1String | Required. The packaging level of the commissioned item (e.g. EA). See the PackagingLevel enumeration list for valid values. |
||||
cmn:QuantityReported | - |
1...1Integer | Required. Reported quantity of the released product (e.g. 100). |

<?xml version="1.0" encoding="UTF-8"?> <SOMProductReleaseMessage xmlns="urn:tracelink:mapper:sl:serialized_operations_manager" xmlns:cmn="urn:tracelink:mapper:sl:commontypes" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <ControlFileHeader> <cmn:FileSenderNumber>8888882028655</cmn:FileSenderNumber> <cmn:FileReceiverNumber>8888882028677</cmn:FileReceiverNumber> <cmn:FileControlNumber>0000000001</cmn:FileControlNumber> <cmn:FileDate>2012-06-30</cmn:FileDate> <cmn:FileTime>06:30:32Z</cmn:FileTime> </ControlFileHeader> <MessageBody> <cmn:LocationId>8888882028655</cmn:LocationId> <cmn:InternalMaterialCode>100253</cmn:InternalMaterialCode> <cmn:LotNumber>A12345</cmn:LotNumber> <cmn:QualityControlEntityId type="GLN">0882028677010</cmn:QualityControlEntityId> <cmn:TransactionIdentifier type="CERTIFICATECONFORMITY" date="2019-03-18">45006290016</cmn:TransactionIdentifier> <cmn:TransactionIdentifier type="DECLARATIONCONFORMITY" date="2019-03-18">66006290017</cmn:TransactionIdentifier> <cmn:EventDateTime>2019-03-18T22:08:021Z</cmn:EventDateTime> <cmn:ProductionQuantity> <cmn:PackagingItemCode type="GTIN-14">50300694220667</cmn:PackagingItemCode> <!-- <cmn:CompanyPrefix>503006</cmn:CompanyPrefix> --> <cmn:PackagingLevel>EA</cmn:PackagingLevel> <cmn:QuantityReported>100</cmn:QuantityReported> </cmn:ProductionQuantity> </MessageBody> </SOMProductReleaseMessage>

Data Element | Error Message | Description |
---|---|---|
Class 1 | ||
choice1 | Only one of either packaging item code or company prefix may be present !!! | The error occurs if both cmn:PackagingItemCode and cmn:CompanyPrefix are populated, or both are empty or null. |
cmn:FileControlNumber | Data Error: FileControlNumber occurs fewer times than its minimum number of occurrences | The error occurs if the source is empty or null. |
cmn:FileDate | Data Error: FileDate occurs fewer times than its minimum number of occurrences | |
cmn:FileReceiverNumber | Data Error: FileReceiverNumber occurs fewer times than its minimum number of occurrences | |
cmn:FileSenderNumber | Data Error: FileSenderNumber occurs fewer times than its minimum number of occurrences. | |
cmn:FileTime | Data Error: FileTime occurs fewer times than its minimum number of occurrences | |
cmn:InternalMaterialCode | Only one of either InternalMaterialCode or CountryDrugCode must be present in source !!! | The error occurs if both cmn:InternalMaterialCode and cmn:CountryDrugCode are either populated or null. |
cmn:LotNumber | Lot number is required !!! | The error occurs if the source is empty or null. |
cmn:PackagingLevel | Valid packaging level code required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. |
cmn:QualityControlEntityId | Quality control entity Id is required if TransactionIdentifier is populated !!! | The error occurs if cmn:TransactionIdentifier is populated, but the source is empty or null. |
cmn:QualityControlEntityId | @type | Valid party type required if QualityControlEntityId is populated !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. |
cmn:QuantityReported | Quantity reported is required !!! | The error occurs if the source is empty or null. |
cmn:TransactionIdentifier | @type | Valid transaction identifier type is required if TransactionIdentifier is populated !!! | The error occurs if cmn:TransactionIdentifier is populated but the source is empty or null, or is not a valid value from the enumeration list. |
som:ControlFileHeader | Data Error: ControlFileHeader occurs fewer times than its minimum number of occurrences. | The error occurs if the source is empty or null. |
som:MessageBody | choice%1 | Only one of either InternalMaterialCode or CountryDrugCode must be present in source !!! | The error occurs if both cmn:InternalMaterialCode and cmn:CountryDrugCode are either populated or null. |
som:SOMProductReleaseMessage | Unable to read input data for business object SOMProductReleaseMessage due to a XML Error. | The error occurs if the source is empty or null. |
Class 2 | ||
cmn:QualityControlEntityId | Quality Control Entity ID is required for products that are commissioned outside of Russia and sold in Russia. | The error occurs if a Target Market in Product Master Data for the released product = "RU" and the lot was commissioned outside of Russia., but the source is empty or null. |
cmn:TransactionIdentifier | A Transaction Identifier for either 'Declaration of Conformity' or 'Certificate of Conformity' is required for products that are commissioned and sold in Russia. | The error occurs if a Target Market in Product Master Data for the released product = "RU" and the lot was commissioned and sold in Russia, but the source is empty or null. |
cmn:TransactionIdentifier | @date | Transaction Identifier Date is required for products that are commissioned and sold in Russia. | The error occurs if a Target Market in Product Master Data for the released product = "RU" and the lot was commissioned in Russia, but the source is empty or null. |
cmn:TransactionIdentifier | @type | A Transaction Identifier for either 'Declaration of Conformity' or 'Certificate of Conformity' is required for products sold in Russia. | The error occurs if a Target Market in Product Master Data for the released product = "RU" , but the source does not equal "CERTIFICATECONFORMITY" or "DECLARATIONCONFORMITY". |
country drug code type | Unsupported Country Drug Code Type. | The error occurs if source is not supported. |
inFilename, origFilename, origCompanyname, origFileDate, cntrlID | File <inFilename> is a potential duplicate match with file <origFilename> sent from <origCompanyname> received on <origFileDate>, based on both files having the same File Control Number <cntrlID>. | The error occurs if file is a duplicate. |
item code type | Unsupported Packaging Item Code Type. | The error occurs if source is not supported. |
paramcount (countrydrugcode, internalmaterialcode, packagingitemcode) | Incorrect number of item codes specified - found <n>, expected 1. format(paramcount.toString). | The error occurs if more than one item code is specified at a time (e.g. country drug code, internal material code, item code). |
persona credential | No API Key exists for user <username> of service <servicename>. format(user.getOrElse("null"),service.serviceName). | The error occurs if source is not found by service id. |
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. |
Product Release Event (EPCIS v1.2)

Use this message to exchange data between a CMO and a Pharmaceutical Manufacturer. This message communicates Commission, Aggregation, and Product Release data in a single message.
Message Type: SOM_PRODUCT_RELEASE_EVENT
Info Exchange Display Name: Product Release


- Ex: urn:epc:id:sgtin:415001647778.0.100000000022
- Format: urn:epc:id:sgtin:[company prefix].[indicator digit][item ref].[serial number]
Data Element | Occurs Length |
Type | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
epcis:EPCISDocument | - |
1…1- | Required. EPCIS message root element. | ||||||||||
@schemaVersion | 0/* |
1…1Decimal | Required. The version of the EPCIS
schema used to populate the EPCIS document elements. Must equal 1.2 .1 |
||||||||||
@creationDate | 1/* |
1…1DateTime | Required. Date the message was created.2 | ||||||||||
EPCISHeader | - |
0…1- | Required. XML file control header
record. The following use cases are supported in this message:
![]() |
||||||||||
sbdh:StandardBusinessDocumentHeader | - |
1…1- | Required.
Business header information including EPCIS Header Version, Sender, and Receiver information, along with the document identification. |
||||||||||
sbdh:HeaderVersion | 0/* |
1…1String | Required. The version number of the
SBDH standard used. The sbdh:HeaderVersion must equal 1.0 .3 |
||||||||||
sbdh:Sender | - |
1…*- | Required. A unique identification key for the Sender party of the message, representing the organization which created the standard business document. The sbdh:Sender element must be used only once with GS1 XML messages. | ||||||||||
sbdh:Identifier | 1/* |
1…1String | Required. The value of the Identifier element may be a GLN, SGLN, or any other supported business party type.4 SGLN and all other party types should be sent with a GS1-conformant uri prefix. For example:
![]() See the MDPartyTypeAttributes enumeration list for valid values. |
||||||||||
@Authority | 1/* |
1…1String | Required. The Authority was previously expected to be set to GLN for GS1 XML messages. Update made in December 2016 changed this to take additional values.5See the MDPartyTypeEnums enumeration list for valid values. |
||||||||||
sbdh:Receiver | - |
1…*- | Required. A unique identification key for the direct Receiver party of the message, representing the organization which receives the standard business document. The sbdh:Receiver element must be used only once with GS1 XML messages. | ||||||||||
sbdh:Identifier | - |
1…*String | Required. The value of the sbdh:Identifier element may be a GLN, SGLN, or any other supported business party type.6 SGLN and all other party types should be sent with a GS1-conformant uri prefix. For example:
![]() See the MDPartyTypeAttributes enumeration list for valid values. |
||||||||||
@Authority | 1/* |
1…1String | Required. The Authority was previously expected to be set to GLN for GS1 XML messages. Update made in December 2016 changed this to take additional values.7See the MDPartyTypeEnums enumeration list for valid values. |
||||||||||
sbdh:DocumentIdentification | - |
1…1- |
Required. Contains the identification group for the message. |
||||||||||
sbdh:Standard | 0/* |
1…1String | Required. The name of the document
standard contained in the payload. The sbdh:Standard value must equal
EPCglobal .8 |
||||||||||
sbdh:TypeVersion | 0/* |
1…1String | Required. The version of the document
included in the payload of SBDH. This is the "complete" version of the
document itself and is different than the
sbdh:HeaderVersion. The sbdh:TypeVersion must equal 1.0 .9 |
||||||||||
sbdh:InstanceIdentifier | 1/* |
1…1String | Required. Description which contains reference information which uniquely identifies this instance of the Standard Business Document between the Sender and the Receiver. This identifier identifies this document as being distinct from others.10 | ||||||||||
sbdh:Type | 0/* |
1…1String | Required. This element identifies the
type of the document. The sbdh:Type must equal Events .11 |
||||||||||
sbdh:CreationDateAndTime | 0/* |
1…1DateTime | Required. Date and time of the SBDH document creation.12 | ||||||||||
extension | - |
0…1- | Header extension area with master data attributes. | ||||||||||
EPCISMasterData | - |
0…1- | Master data extension header.
May contain product master data attributes for Commissioning event and/or location address information for Decommissioning and/or Destroy events. Optional. Valid values:
![]() |
||||||||||
VocabularyList | - |
1…1- | Required. Vocabulary list group master data elements. | ||||||||||
Vocabulary | - |
0…*- | Looping vocabulary element with discrete item master and/or party master data element groups. Vocabulary will occur only once for all item master entries present in message, if group is populated.
Group is optional. If it does not appear in master data header extension, no error will be thrown. |
||||||||||
@type | 0/* |
1…1String | Required. Vocabulary type identifying product master data elements. Product master data is defined by VocabularyElement | @id. Valid value:
|
||||||||||
VocabularyElementList | - |
0…1- | List of vocabulary elements containing master data attributes for each unique product code. | ||||||||||
VocabularyElement | - |
0…*- | Looping vocabulary element identifying each unique SGTIN, NTIN, or China Product Code for product master data embedded in the epc serial number in the Commissioning and Transformation events.
SSCC codes not included in VocabularyElement product master data. ![]() |
||||||||||
@id | 0/* |
1…1String | Required. Identifies the product code for which master data is being sent in the VocabularyElement loop.14 VocabularyElement | @id = SGTIN, NTIN, or China Product Code with GS1-conformant urn or http prefix. These are the only values supported in this element. All other product identifier types will be sent as additional trade item types. SSCC codes are not identified in any part of the VocabularyElement group. Must match the product code embedded within the serial number in the epc code in one or more commissioning events. SGTIN (strongly recommended for GS1-conformance)
|
||||||||||
attribute(1) | 1/* |
1…1String | Conditionally required if item master data attributes are sent in VocabularyElement. Instance 1 of attribute for packaging level value identified by @id attribute.15 See the PackagingLevel enumeration list for valid values. |
||||||||||
@id | 0/* |
1…1String | Required. Attribute identifying packaging level. Valid value: See the MDAttributes enumeration list for valid values. |
||||||||||
attribute(2) | 0/* |
0…1String | Instance 2 of attribute for internal material number in Pharmaceutical Manufacturer's internal system identified by @id attribute. Identified by the value in the next attribute element in the current loop = MANUFACTURER_PART_NUMBER .17 |
||||||||||
@id | 0/* |
1…1String | Required. Id attribute identifying internal material code. Valid value:
|
||||||||||
attribute(3) | 0/* |
0…1String | Conditionally required if the previous name/value pair attribute(2) | @id is populated. Instance 3 of attribute for internal material number identifier type for the product. Id attribute identifying internal material code. Valid value:
Sequence of fields for internal material number is:
![]() |
||||||||||
@id | 0/* |
1…1String | Required. Id attribute identifying internal material code. Valid value:
|
||||||||||
attribute(4) | 0/* |
0…1String | Instance 4 of attribute for country drug code for all national drug code types, identified by the enum value in the next attribute element in the current loop and by the attribute @id value as an additional trade item.21 Country drug code type defined by value in next attribute element where @id = |
||||||||||
@id | 0/* |
1…1String | Required. Id attribute identifying internal material code. Valid value:
|
||||||||||
attribute(5) | 0/* |
0…1String | Conditionally required if the previous name/value pair attribute | @id is populated with the country drug code value. Instance 5 of attribute for Country drug code identifier type. Must follow attribute with country drug value. Id attribute identifying internal material code.23 Sequence of fields for country drug code is: GS1:
TraceLink:
![]() The following qualifiers have been defined by GS1 as additional trade item types:
To identify these material number types, use attribute | @id string:
For all other country drug code types, use attribute | @id string:
See the CountryDrugCode enumeration list for valid values. |
||||||||||
@id | 0/* |
1…1String | Required. Id attribute identifying internal material code. Valid values:24
|
||||||||||
EPCISBody | - |
1…1- | Required. Contains all of the EPCIS events for this message. | ||||||||||
EventList | - |
1…1- | Required. The EventList
includes the following events:
![]() |
||||||||||
choice%1 | - |
1…*- | Required. Only one of the following
choice options may be selected in any one loop on EPCISBody | EventList:
|
||||||||||
ObjectEvent | - |
0…*- | Choice 1 for EventList. Data
= ObjectEvent for the Commissioning Events. EventList = ObjectEvent Commissioning when all of the following is true:
|
||||||||||
eventTime | 1/* |
1…1DateTime | Required. Timestamp of date/time when the event occurred. Must include a time zone indicator as specified in Section 9.5 of [EPCIS1.0.1] in XML datetime format YYYY-MM-DDTHH:MM:SS.mmZ.25 | ||||||||||
recordTime | 0/* |
0…1dateTime | Not used. | ||||||||||
eventTimeZoneOffset | 1/* |
1…1String | Required. Time zone offset in effect at time and place where the event occurred, consistent with what choice was made for eventTime. Per Section 7.2.8 of [EPCIS1.0.1].26 | ||||||||||
epcList | - |
1…1- | Required. The EPCs of each item, case, and/or pallet commissioned. | ||||||||||
epc | 1/* |
1…*String | Required. The EPC identifier in EPC Pure Identity URI format:27 CN EDMC:
SGTIN:
SSCC:
|
||||||||||
action | 0/* |
1…1String | Required. The action value must equal ADD .28 |
||||||||||
bizStep | 0/* |
0…1AnyURI | Required. The bizStep value must equal urn:epcglobal:cbv:bizstep:commissioning .29 |
||||||||||
disposition | 0/* |
0…1AnyURI | Required. The disposition value must equal urn:epcglobal:cbv:disp:active .30 |
||||||||||
readPoint | - |
0…1- | The location where the commissioning event occurred.![]() 0 .Optional for a commissioning event. |
||||||||||
id | 0/* |
1…1AnyURI | Required. The SGLN EPC of the location
from where the event occurred. This may be a site-level SGLN, or a
finer-grain location identifier.31 See the MDPartyTypeAttributes enumeration list for valid values. |
||||||||||
bizLocation | - |
1…1- |
Required. Mandatory for a commissioning event. |
||||||||||
id | 1/* |
1…1AnyURI | Required. The SGLN EPC of the location from where the event occurred. This may be a site-level SGLN, or a finer-grain location identifier.32 | ||||||||||
extension | - |
0…1- | Main extension body for commission event. | ||||||||||
ilmd | - |
0…1- | Instance lot master data specific to product being commissioned. | ||||||||||
cbvmda:lotNumber | 0/* |
0…1String | The lot or batch code for the serialized item in an alphanumeric string.33 | ||||||||||
cbvmda:itemExpirationDate | 0/* |
0…1Date | The expiration date for the serialized item, formatted in YYYY-MM-DD format.34 | ||||||||||
tl:commissionEventExtensions | - |
0…1- | Extensions used for Commission ObjectEvent. | ||||||||||
tl:filterValue | - |
0…1Integer |
tl:filterValue is used only if it is mandatory by a trade partner to convert SSCC to GS1 HEX or Tag URI format. See the FilterValue enumeration list for valid values. |
||||||||||
tl:packagingLevel | 0/* |
0…1String | The packaging level of the
commissioned item using the supported enumeration values.35![]() ![]() See the PackagingLevel enumeration list for valid values. |
||||||||||
tl:epcAttributes | - |
0…*- | Supports optional inclusion
of human readable barcode content associated with each epc number in a
commission event. ![]() |
||||||||||
@epc | 1/* |
1…1String | Required. The EPC serial number to
which the tl:barcodeContent is associated. The epc must be an EPC Pure Identity
URI as specified in Section 6 of [TDS1.5].36
|
||||||||||
tl:barcodeContent | 1/* |
1…1String | Required. The human readable barcode contents encoded in the 2D barcode WITH parentheses for the AI keys.37 | ||||||||||
tl:plantLocationId | 0/* |
0…1String | Identifier of plant where products were commissioned.38 | ||||||||||
tl:productionLineId | 1/* |
0…1String | Identifier of production line where products were commissioned.39 | ||||||||||
tl:lineManagerName | 0/* |
0…1String | Name of the person responsible as the production line manager for the commissioned products.40 | ||||||||||
tl:internalMaterialCode | 0/* |
0…1String | Internal material number for the product in the
Pharmaceutical Manufacturer's internal systems (e.g. ERP).41![]() |
||||||||||
tl:packagingItemCode | 1/* |
1…1String | The product code for the commissioned item (e.g. GTIN-14).42 | ||||||||||
@type | 1/* |
1…1String | Conditionally required if tl:packagingItemCode is populated. The product code type. Valid values:43
See the ItemCode enumeration list for valid values. |
||||||||||
tl:countryDrugCode | 0/* |
0…1String | The national drug code for
the commissioned item (e.g. NDC number for US products).44![]() |
||||||||||
@type | 0/* |
0…1String | The national drug code type
using the supported enumeration values and any formatting instructions
provided.45![]() See the CountryDrugCode enumeration list for valid values. |
||||||||||
tl:manufacturingDate | 0/10 |
0…1Date | The date of manufacture for the serialized item, formatted in YYYY-MM-DD format.46 | ||||||||||
tl:extensionField | - |
0…*- | Customer extension point to
pass in 1 or more name/value pairs containing additional data attributes not
already supported in this message. If this element group is populated
both tl:fieldName and tl:fieldValue must be populated.
These extensions are not stored by TraceLink and are used only for outbound mapping purposes when there is a requirement to provide additional data to a trade partner for this message, such as when a CMO is required to provide additional data fields to the brand owner. In this case, TraceLink would have a custom map for that trade partner to map these fields outbound. Different trade partners may have different field requirements and may therefore require that tl:extensionField be populated differently per trade partner. |
||||||||||
tl:fieldName | 1/* |
1…1String | Conditionally required if the tl:extensionField element group is populated. Populate with the field name provided by the trade partner that will be receiving the mapped outbound message. The field name must match the field name provided by the trade partner exactly, including case, so it is properly detected in the outbound mapping. | ||||||||||
tl:fieldValue | 1/* |
1…1String | Conditionally required if the tl:extensionField element group is populated. Populate with the field value content that corresponds to tl:fieldName. | ||||||||||
ObjectEvent | - |
0…*- | ObjectEvent describing
decommissioning events.
EventList = ObjectEvent Decommissioning when all of the following is true:
|
||||||||||
eventTime | 1/* |
1…1DateTime | Required. Timestamp of date/time when the event occurred. Must include a time zone indicator as specified in Section 9.5 of [EPCIS1.0.1] in XML datetime format YYYY-MM-DDTHH:MM:SS.mmZ.47 | ||||||||||
eventTimeZoneOffset | 1/* |
1…1String | Required. Time zone offset in effect at time and place where the event occurred, consistent with what choice was made for eventTime. Per Section 7.2.8 of [EPCIS1.0.1].48 | ||||||||||
epcList | - |
1…1- | Required. The EPCs of each item, case, and/or pallet decommissioned. | ||||||||||
epc | 1/* |
1…*String | Required. The EPC identifier in EPC Pure Identity URI format:49 CN EDMC:
SGTIN:
SSCC:
|
||||||||||
action | 0/* |
1…1String | Required. The action value must equal DELETE .50 |
||||||||||
bizStep | 0/* |
0…1AnyURI | Required. The bizStep value must equal urn:epcglobal:cbv:bizstep:decommissioning .51 |
||||||||||
disposition | 0/* |
0…1AnyURI | Required. The disposition value must equal urn:epcglobal:cbv:disp:inactive .52 |
||||||||||
readPoint | - |
1…1- | Required. Location where event occurred. Defined with GS1-conformant party identifier types with full urn or http prefix. SGLN is strongly preferred but other party types supported as well. Links to location party address data if present in VocabularyElement | @id. If does not link to location identifier in VocabularyElement | @id, readPoint used for master data lookup. | ||||||||||
id | 0/* |
1…1AnyURI | Required. This location identifier links to the VocabularyElement | @id if the location address info is populated in the EPCISMasterData header extension. If the location address is not present in VocabularyElement, the TraceLink system uses this identifier for master data lookup.53 See the MDPartyTypeAttributes enumeration list for valid values. |
||||||||||
bizLocation | - |
1…1- | The location where the event occurred. | ||||||||||
id | 1/* |
1…1AnyURI | The SGLN EPC of the location of where the event occurred. This may be a site-level SGLN, or a finer-grain location identifier. | ||||||||||
bizTransactionList | - |
0…1- | Conditionally required if at least one Target Market in Product Master Data = RU . Business transaction list group. |
||||||||||
bizTransaction | 0/* |
1…*AnyURI | Conditionally required if at least one Target Market in Product Master Data = RU . The transaction identifier associated with the released product.54 |
||||||||||
@type | 1/* |
1…1String |
Required. The transaction identifier type. Valid values:
![]() RU , one instance of bizTransaction | @type with a value of http://epcis.tracelink.com/hc/btt/removal must be present. |
||||||||||
@date | 0/* |
0…1Date | Conditionally required if at least one Target Market in Product Master Data = RU . Transaction identifier date attribute in XML YYYY-MM-DD format.55 |
||||||||||
tl:locationId | - |
0…1String | Serialized Operations Manager External Partner Location identifier. Type of identifier defined by @type enum below.56 When transactions are submitted by an external Serialized Operations Manager Partner, the system uses the subscriber company integration user to perform the action and log this in the audit trail so that all transactions executed by the external Serialized Operations Manager Partner are attributed to that company. |
||||||||||
@type | 1/* |
1…1String | Conditionally required if locationId is populated. Attribute identifies the location types. See the LocationIdType enumeration list for valid values.57 | ||||||||||
tl:decommissionEventExtensions | - |
0…1- | Extensions used for ObjectEvent Decommissioning. | ||||||||||
tl:transactionDate | 0/* |
0…1Date | Date associated with the business transaction document in bizTransactionList in XML date format YYYY-MM-DD. This date may or may not be the same as the eventTime.58 | ||||||||||
tl:disaggregateFromParent | - |
0…1Boolean | When set to true ,
instructs back end to disaggregate a serial number from its parent container
(if it is aggregated) when setting the PackagingSerialNumberStatus of the
serial number to DECOMMISSIONED or DESTROYED .59If not set, or set to |
||||||||||
tl:marketCountryCode | 0/2 |
0…1String | Market country code.60 | ||||||||||
tl:businessPartyInfo | - |
0…1- | The address of the authorizing party for the decommissioning event. The readPoint contains the location. | ||||||||||
tl:businessId | 0/* |
0…*String | The identifier associated with the authorizing party. | ||||||||||
@type | 0/* |
0…1String | The type of the BusinessId identifier. | ||||||||||
tl:businessClassification | 0/* |
0…1String | The classification of the business. | ||||||||||
tl:BusinessPartyDetail | - |
0…1- | Business name and address of the authorizing business entity. | ||||||||||
tl:businessName | 0/* |
1…1String | Required. Business name of the entity that is authorizing the decommission of the serial numbers. | ||||||||||
tl:street1 | 0/* |
1…1String | Required. First line of the address for the company indicated in tl:businessName. | ||||||||||
tl:street2 | 0/* |
0…1String | Second line of the address for the company indicated in tl:businessName. | ||||||||||
tl:city | 0/* |
1…1String | Required. City for the company indicated in tl:businessName. | ||||||||||
tl:village | 0/* |
0…1String | Name of the village in which the company is located. | ||||||||||
tl:houseNumber | 0/* |
0…1String | Building, house, or unit number of the company. House numbers are usually only separated from the street address in China. For all addresses outside of China, continue to enter the building, house, or unit number in tl:street1. | ||||||||||
tl:township | 0/* |
0…1String | Name of the township in which the company is located. | ||||||||||
tl:district | 0/* |
0…1String | District code.
|
||||||||||
tl:stateOrRegion | 0/* |
1…1String | Required. The state, province, or region of the business entity indicated in the businessName field, using the standard two-letter abbreviation specified in the ISO 3166-2:1998 country subdivision code. | ||||||||||
tl:postalCode | 1/* |
0…1String | Postal code for the company indicated in tl:businessName. | ||||||||||
tl:country | 0/* |
1…1String |
Required. The country where the company indicated in the businessName field is located. The country uses the standard two-letter abbreviation specified in the ISO 3166-1alpha-2:1997 country code. See the ISOCountryCode enumeration list for valid values. |
||||||||||
tl:corporateFax | 1/* |
0…1String | Company fax number. | ||||||||||
tl:addressObjectGUID | 0/36 |
0…1String | The global identifier assigned by the Russian Federation Information Address System (FIAS).61![]() |
||||||||||
tl:houseGUID | 0/36 |
0…1String | The global house identifier assigned by the Russian Federation Information Address System (FIAS).62![]() |
||||||||||
tl:taxRegistrationCode | 0/* |
0…1String | The code used to identify this entity for tax or other legal reporting purposes (e.g. a Russia KPP Registration Code). | ||||||||||
tl:premisesCode | 0/* |
0…1String | Identifier representing a physical area within the company location (e.g. a location's second floor). | ||||||||||
tl:warehouseOperatorName | 0/* |
0…1String | Name of the person responsible for warehouse operations.63 | ||||||||||
tl:decommissionReasonCode | 0/* |
0…1String | Conditionally required if at least one Target Market in Product Master Data = RU . Reason code for decommissioning.64See the DecommissionReasonCode enumeration list for valid values. |
||||||||||
tl:reasonDescription | 0/* |
0…1String | Description for decommission reason code.65 | ||||||||||
tl:destructionMethod | 0/* |
0…1String | Conditionally required if at least one Target Market in Product Master Data = RU . Method of destruction.66See the DestructionMethod enumeration list for valid values. |
||||||||||
ObjectEvent | - |
0…*- | ObjectEvent recording
destroying events.
EventList = ObjectEvent Destroy when all of the following is true:
|
||||||||||
eventTime | 1/* |
1…1DateTime | Required. Timestamp of date/time when the event occurred. Must include a time zone indicator as specified in Section 9.5 of [EPCIS1.0.1] in XML datetime format YYYY-MM-DDTHH:MM:SS.mmZ.67 | ||||||||||
eventTimeZoneOffset | 1/* |
1…1String | Required. Time zone offset in effect at time and place where the event occurred, consistent with what choice was made for eventTime. Per Section 7.2.8 of [EPCIS1.0.1].68 | ||||||||||
epcList | - |
1…1- | Required. The EPCs of each item, case, and/or pallet commissioned. | ||||||||||
epc | 1/* |
1…*String | Required. The EPC identifier in EPC Pure Identity URI format:69 CN EDMC:
SGTIN:
SSCC:
|
||||||||||
action | 0/* |
1…1String | Required. The action value must equal DELETE .70 |
||||||||||
bizStep | 0/* |
0…1AnyURI | The bizStep value must equal urn:epcglobal:cbv:bizstep:destroying .71 |
||||||||||
disposition | 0/* |
0…1AnyURI | The disposition value must equal urn:epcglobal:cbv:disp:destroyed .72 |
||||||||||
readPoint | - |
1…1- | Required. Location where event occurred. Defined with GS1-conformant party identifier types with full urn or http prefix. SGLN is strongly preferred but other party types supported. Links to location party address data if present in VocabularyElement | @id. If does not link to location identifier in VocabularyElement | @id, readPoint used for master data lookup. | ||||||||||
id | 0/* |
1…1AnyURI | Required. The party identifier of the location where the decommissioning event occurred. SGLN is strongly preferred for GS1 conformance. This may be a site-level SGLN, or a finer-grain location identifier.73 GS1-conformant supported prefixes are listed in MDPartyTypeAttributes lookup. See the MDPartyTypeAttributes enumeration list for valid values. |
||||||||||
bizLocation | - |
0…1- | The location where the event occurred. | ||||||||||
id | 1/* |
1…1AnyURI | Required. The SGLN EPC of the location from where the event occurred. This may be a site-level SGLN, or a finer-grain location identifier.74 | ||||||||||
bizTransactionList | - |
0…1- | Conditionally required if at least one Target Market in Product Master Data = RU . Business transaction list group. |
||||||||||
bizTransaction | 0/* |
1…*AnyURI | Conditionally required if at least one Target Market in Product Master Data = RU . The transaction identifier associated with the destroyed product.75 |
||||||||||
@type | 1/* |
1…1String |
Required. The transaction identifier type. Valid values:
![]() RU , one instance of bizTransaction | @type with a value of http://epcis.tracelink.com/hc/btt/removal must be present. |
||||||||||
@date | 0/* |
0…1Date | Conditionally required if at least one Target Market in Product Master Data = RU . Transaction identifier date attribute in XML YYYY-MM-DD format.76 |
||||||||||
tl:locationId | - |
0…1String | Serialized Operations Manager External Partner Location identifier. Type of identifier defined by enum below. When messages are submitted by an external Serialized Operations Manager Partner, the system uses the partner company integration user to perform the action. This is logged in the audit trail so that all messages executed by the external Serialized Operations Manager Partner are attributed to that company.77 | ||||||||||
@type | 1/* |
1…1String | Conditionally required if tl:locationId is populated. Attribute identifies the
location types.78 See the MessagePartyIDType enumeration list for valid values. |
||||||||||
tl:destroyEventExtensions | - |
0…1- | Extensions used for ObjectEvent Destroying. | ||||||||||
tl:transactionDate | 0/* |
0…1Date | Date associated with the business transaction document in bizTransactionList in XML date format YYYY-MM-DD. This date may or may not be the same as the eventTime.79 | ||||||||||
tl:disaggregateFromParent | - |
0…1Boolean | When set to true ,
instructs back end to disaggregate a serial number from its parent container
(if it is aggregated) when setting the PackagingSerialNumberStatus of the
serial number to DECOMMISSIONED or DESTROYED .80If not set, or set to |
||||||||||
tl:marketCountryCode | 0/2 |
0…1String | Market country code.81 | ||||||||||
tl:businessPartyInfo | 0/* |
0…1- | Authorizing party information for the destroying event. | ||||||||||
tl:businessId | 0/* |
1…*String | Required. Identifier associated with the authorizing business entity. | ||||||||||
@type | 0/* |
1…1String |
Required. The business identifier type. See the BusinessAndLocationId enumeration list for valid values. |
||||||||||
tl:businessClassification | 0/* |
0…1String |
The classification of the business. See the BusinessClassification enumeration list for valid values. |
||||||||||
tl:BusinessPartyDetail | - |
0…1- | Business name and address of the authorizing business entity. | ||||||||||
tl:businessName | 0/* |
1…1String | Required. Business name of the entity that is authorizing the destruction of the serial numbers. | ||||||||||
tl:street1 | 0/* |
1…1String | Required. First line of the address for the company indicated in tl:businessName. | ||||||||||
tl:street2 | 0/* |
0…1String | Second line of the address for the company indicated in tl:businessName. | ||||||||||
tl:city | 0/* |
1…1String | Required. City for the company indicated in tl:businessName. | ||||||||||
tl:village | 0/* |
0…1String | Name of the village in which the company is located. | ||||||||||
tl:houseNumber | 0/* |
0…1String | Building, house, or unit number of the company. House numbers are usually only separated from the street address in China. For all addresses outside of China, continue to enter the building, house, or unit number in tl:street1. | ||||||||||
tl:township | 0/* |
0…1String | Name of the township in which the company is located. | ||||||||||
tl:district | 0/* |
0…1String | District code.
|
||||||||||
tl:stateOrRegion | 0/* |
1…1String | Required. The state, province, or region of the business entity indicated in the businessName field, using the standard two-letter abbreviation specified in the ISO 3166-2:1998 country subdivision code. | ||||||||||
tl:postalCode | 1/* |
0…1String | Postal code for the company indicated in tl:businessName. | ||||||||||
tl:country | 0/* |
1…1String |
Required. The country where the company indicated in the businessName field is located. The country uses the standard two-letter abbreviation specified in the ISO 3166-1alpha-2:1997 country code. See the ISOCountryCode enumeration list for valid values. |
||||||||||
tl:corporateFax | 1/* |
0…1String | Company fax number. | ||||||||||
tl:addressObjectGUID | 0/36 |
0…1String | The global identifier assigned by the Russian Federation Information Address System (FIAS).82![]() |
||||||||||
tl:houseGUID | 0/36 |
0…1String | The global House identifier assigned by the Russian Federation Information Address System (FIAS).83![]() |
||||||||||
tl:taxRegistrationCode | 0/* |
0…1String | The code used to identify this entity for tax or other legal reporting purposes (e.g. a Russia KPP Registration Code). | ||||||||||
tl:premisesCode | 0/* |
0…1String | Identifier representing a physical area within the company location (e.g. a location's second floor). | ||||||||||
tl:warehouseOperatorName | 0/* |
0…1String | Name of the person responsible for warehouse operations.84 | ||||||||||
tl:decommissionReasonCode | 0/* |
0…1String | Conditionally required if at least one Target Market in Product Master Data = RU . Reason code for decommissioning.85See the DecommissionReasonCode enumeration list for valid values. |
||||||||||
tl:reasonDescription | 0/* |
0…1String | Description for destroy reason code.86 | ||||||||||
tl:destructionMethod | 0/* |
0…1String | Conditionally required if at least one Target Market in Product Master Data = RU . Method of destruction.87See the DestructionMethod enumeration list for valid values. |
||||||||||
AggregationEvent | - |
0…*- | AggregationEvent is option 2
for the EventList choice for the Aggregation events.
EventList = AggregationEvent when all of the following is true:
|
||||||||||
eventTime | 1/* |
1…1DateTime | Required. Timestamp of date/time when the event occurred. Must include a time zone indicator as specified in Section 9.5 of [EPCIS1.0.1] in XML datetime format YYYY-MM-DDTHH:MM:SS.mmZ.88 | ||||||||||
eventTimeZoneOffset | 1/* |
1…1String | Required. Time zone offset in effect at time and place where the event occurred, consistent with what choice was made for eventTime. Per Section 7.2.8 of [EPCIS1.0.1].89 | ||||||||||
parentID | 1/* |
1…1AnyURI | Required. Identifier of the parent
container in EPC Pure Identity URI format (e.g.
f or an item-to-case aggregation, the EPC of the case.
For a case-to-pallet aggregation, the EPC of the pallet).90 CN EDMC:
SGTIN:
SSCC:
|
||||||||||
childEPCs | - |
1…1- | Required. List of identifiers of the child items in the parent container in EPC Pure Identity URI format (e.g. for an item-to-case aggregation, the EPCs of the items; for a case-to-pallet aggregation, the EPCs of the cases). | ||||||||||
epc | 1/* |
1…*String | Required. Serial number expressed in the GS1 Application Identifier format without parentheses for the AI keys.
Non-GS1 serial numbers (e.g. China) are expressed in native format. See EPC Pure Identifier Format Examples.
Identifier of the child items in the parent container in EPC Pure Identity URI format.91 CN EDMC:
SGTIN:
SSCC:
|
||||||||||
action | 1/* |
1…1String | Required. The action value must equal ADD for the aggregation event.92 |
||||||||||
bizStep | 0/* |
0…1AnyURI | The bizStep value must equal urn:epcglobal:cbv:bizstep:packing .93 |
||||||||||
disposition | 0/* |
0…1AnyURI | The disposition value must equal urn:epcglobal:cbv:disp:in_progress .94 |
||||||||||
readPoint | - |
0…1- | Location where the event occurred.![]() 0 .Optional for AggregationEvent. |
||||||||||
id | 0/* |
1…1AnyURI | Required. The SGLN EPC of the location of where the event occurred. This may be a site-level SGLN, or a finer-grain location identifier.95 | ||||||||||
bizLocation | - |
0…1- | Required. The location where the event occurred. | ||||||||||
id | 0/* |
1…1AnyURI | Required. The SGLN EPC of the location from where the event occurred. This may be a site-level SGLN, or a finer-grain location identifier.96 | ||||||||||
tl:aggregationEventExtensions | - |
0…1- | Extensions used for Aggregation Event. | ||||||||||
tl:packedStatus | 0/* |
0…1String |
The packout of the item or container using the supported enumeration values.97 See the PackedStatus enumeration list for valid values. |
||||||||||
tl:quantity | - |
0…1Integer | The quantity of child serial numbers aggregated to the parent container in this aggregation.98 | ||||||||||
tl:resetContainerAggregation | - |
0…1Boolean | Reset container aggregation flag.99 | ||||||||||
ObjectEvent | - |
1…1- | Required.EventList. Data = ObjectEvent
for Product Release Events. EventList = ObjectEvent Product Release when all of the following is true:
|
||||||||||
eventTime | 1/* |
1…1DateTime | Required. Timestamp of date/time when the event occurred. Must include a time zone indicator as specified in Section 9.5 of [EPCIS1.0.1] in XML datetime format YYYY-MM-DDTHH:MM:SS.mmZ.100 | ||||||||||
eventTimeZoneOffset | 1/* |
1…1String | Required. Time zone offset in effect at time and place where the event occurred, consistent with what choice was made for eventTime. Per Section 7.2.8 of [EPCIS1.0.1].101 | ||||||||||
epcList | - |
1…1- | Required. List of the EPCs of top-most containers (e.g. pallets, cases) in the shipment. | ||||||||||
epc | 1/* |
1…*String | Required. The EPC identifier in EPC Pure Identity URI format. Will not be populated or processed for product release event. | ||||||||||
action | 0/* |
1…1String | Required. The action value must equal OBSERVE .102 |
||||||||||
bizStep | 0/* |
0…1AnyURI | Required. The bizStep value must equal http://epcis.tracelink.com/bizstep/releasing .103 |
||||||||||
disposition | 0/* |
0…1AnyURI | Required. The disposition value must equal http://epcis.tracelink.com/disp/released .104 |
||||||||||
readPoint | - |
0…1- | Required. Refers to the location of where the commissioning event occurred.![]() 0 . |
||||||||||
id | 0/* |
1…1AnyURI | Required. The SGLN EPC of the location
from where the event occurred. This may be a site-level SGLN, or a
finer-grain location identifier.105 See the MDPartyTypeAttributes enumeration list for valid values. |
||||||||||
bizTransactionList | - |
0…1- | Business transaction list group.![]() |
||||||||||
bizTransaction | 0/* |
1…*AnyURI | The transaction identifier associated with the released product.106 | ||||||||||
@type | 1/* |
1…1String | Required. The transaction identifier type. Valid values:
|
||||||||||
@date | 0/* |
0…1Date | Conditionally required if at least one Target Market in Product Master Data = RU and the lot was commissioned in Russia. Transaction identifier date attribute in XML YYYY-MM-DD format.107 |
||||||||||
extension | - |
0…1- | Main extension body for commission event. | ||||||||||
ilmd | - |
1…1- | Required. Instance lot master data specific to product being commissioned. | ||||||||||
cbvmda:lotNumber | 0/* |
1…1String | Required. The lot number associated with the InternalMaterialCode or CountryDrugCode.108 | ||||||||||
tl:commissionEventExtensions | - |
0…1- | Extensions used for Commission ObjectEvent. Not populated in product release event. | ||||||||||
tl:productReleaseEventExtensions | - |
1…1- | Extensions used for TraceLink Product Release event. | ||||||||||
choice%1 | - |
1…1- | Required. Only one of the following choice options must be selected:
An error will be thrown if neither of the two fields are populated. An error will also be thrown if both of the two option fields are populated. |
||||||||||
tl:internalMaterialCode | 0/* |
0…1String | Conditionally required if tl:countryDrugCode is not populated. The internal material number configured in Product Master Data associated with the serialized items that are updated with the Product Release status. Specifying an internal material number will update all serial numbers at all packaging levels (e.g. item, case) that are linked to the internal material number and specified lot number.109 | ||||||||||
tl:countryDrugCode | 0/* |
0…1String | Conditionally required if tl:internalMaterialCode is not populated. The national drug code (e.g. NDC, Swissmedic, PZN, etc.) associated with the serialized items that will be updated with the Product Release status. Specifying a country drug code will update all serial numbers at all packaging levels (e.g. item, case) that are linked to the country drug code and specified lot number. | ||||||||||
@type | 1/* |
1…1String |
Required. The national drug code type using the supported enumeration values and any formatting instructions provided. See the CountryDrugCode enumeration list for valid values. |
||||||||||
tl:qualityControlEntityId | 0/* |
0…1String | Conditionally required if tl:bizTransactionList in the ObjectEvent for Product Release Events is populated, or at least one Target Market in Product Master Data = RU and the lot was commissioned outside of Russia. Business or location identifier for the entity responsible for quality control.110 |
||||||||||
@type | 1/* |
1…1String | Required. Business or location type of the quality control entity identifier.111 See the BusinessAndLocationId enumeration list for valid values. |
||||||||||
tl:productionQty | - |
0…*- | Production quantity element group. | ||||||||||
choice1 | - |
1…1Choice | Required. Choice element of either tl:packagingItemCode or tl:companyPrefix. | ||||||||||
tl:packagingItemCode | 0/* |
0…1String | Conditionally required if tl:companyPrefix is not populated. Option 1 for choice1. Identifies the product using the packaging level item code configured in Product Master Data.112 | ||||||||||
@type | 0/* |
0…1String | Required. Packaging item code type.113 See the ItemCode enumeration list for valid values. |
||||||||||
tl:companyPrefix | 0/* |
0…1String | Conditionally required if tl:packagingItemCode is not populated. Option 2 for choice1. Identifies the company prefix assigned by GS1 for the released product.114 | ||||||||||
tl:packagingLevel | 1/* |
1…1String | Required. The packaging level of the commissioned item.115 See the PackagingLevel enumeration list for valid values. |
||||||||||
tl:quantityReported | - |
1…1Integer | Required. Reported quantity of the released product.116 | ||||||||||
extension | - |
0…1- | EPCIS body event extension point. Contains the TransformationEvent. TransformationEvent is option 3 in the EventList choice. This extension can appear before or after commissioning event. | ||||||||||
TransformationEvent | - |
0…1- | Use the TransformationEvent
to commission repackaged products. It is similar to the CommissioningEvent,
but includes source products as input, and the commissioned serial numbers
are the output repackaged products.
The standard ilmd (instance level master data) captures product attributes, lot, and expiry like in a standard commission event. The TransformationEvent parameters are the same as the CommissioningEvent except there is no action:
![]() |
||||||||||
eventTime | 1/* |
1…1DateTime | Required. The date/time when the disposition assigned occurs with a time zone indicator as specified in Section 9.5 of (EPCIS1.0.1) in XML datetime format : YYYY-MM-DDTHH:MM:SS.mmZ.117 | ||||||||||
recordTime | 0/* |
0…1DateTime | Not used. | ||||||||||
eventTimeZoneOffset | 1/* |
1…1String | Required. The time zone offset in effect at time and place where the disposition assigned occurred, consistent with what choice was made for eventTime. Per Section 7.2.8 of [EPCIS1.0.1].118 | ||||||||||
inputEPCList | - |
0…1- | Conditionally required if inputQuantityList is missing. The input EPC is the
serial number of the source product that is transformed.![]() ![]() |
||||||||||
epc | 1/* |
0…*String | Required. The EPC identifier in EPC Pure Identity URI format. Only SGTIN and NTIN supported as Transformation input.119 SGTIN:
|
||||||||||
inputQuantityList | - |
0…1- | Conditionally required if inputEPCList is missing. Specifies
non-serialized source products with packaging product code, lot number, and
quantity.
![]() ![]() |
||||||||||
quantityElement | - |
1…*- | Required. Identifies a quantity of source products that are identified by a specific class-level 940 identifier in urn format. | ||||||||||
epcClass | 1/* |
1…1String | Required. A class-level identifier for
the source product in the inputQuantityList for which the quantity is
provided.120 Format:
|
||||||||||
quantity | - |
1…1Integer | Required. A number that specifies how many or how much of the specified epcClass is denoted by this quantityElement.121 | ||||||||||
uom | 0/* |
0…1String | Unit of measure for the epcClass quantity. | ||||||||||
outputEPCList | - |
1…1- | Required. Provides the epc serial number for the transformed product.
outputEPCList is mandatory if Transformation Event is populated.![]() |
||||||||||
epc | 1/* |
1…*String | Required. Identifier of the child items in the parent container in EPC Pure Identifier URI format as specified in Section 6 of [TDS1.5].122 CN EDMC:
SGTIN:
SSCC:
|
||||||||||
transformationID | 0/* |
0…1AnyURI | An identifier that links this event to other Transformation Events using an identical transformationID value. When specified, all inputs to all events sharing the same value of the transformationID may contribute to all outputs of all events sharing that value of transformationID. | ||||||||||
bizStep | 0/* |
0…1AnyURI | The bizStep value must be
set to urn:epcglobal:cbv:bizstep:commissioning .123 |
||||||||||
disposition | 0/* |
0…1AnyURI | The disposition value must be set to urn:epcglobal:cbv:disp:active .124 |
||||||||||
readPoint | - |
0…1- | Not used in Transformation Event. | ||||||||||
id | 0/* |
0…1AnyURI | Not used in Transformation Event.125 | ||||||||||
bizLocation | - |
1…1- | Required. Refers to the location of the product after the Transformation Event has occurred. | ||||||||||
id | 1/* |
1…1AnyURI | Required. The SGLN EPC of the location from where the commissioning occurred. This may be a site-level SGLN or a finer-grain location identifier.126 | ||||||||||
bizTransactionList | 1/* |
0…*String | An unordered list of 0 or more business transactions that define the context of this event. | ||||||||||
ilmd | - |
0…1- | Instance lot master data specific to product being commissioned. | ||||||||||
cbvmda:lotNumber | 1/* |
0…1String | Required. The lot number associated with the tl:internalMaterialCode, tl:packagingItemCode, or tl:countryDrugCode specified above that is used to identify the serial numbers that will be updated.127 | ||||||||||
cbvmda:itemExpirationDate | 0/* |
0…1Date | The expiration date for the serialized item in YYYY-MM-DD format.128 | ||||||||||
tl:commissionEventExtensions | - |
0…1- | Required. Extensions used for Commission ObjectEvent. | ||||||||||
tl:filterValue | - |
0…1Integer | Not used. | ||||||||||
tl:packagingLevel | 0/* |
1…1String | Conditionally required for GS1 EPCIS conformance. The packaging level of the
commissioned item using the supported enumeration values. Valid value:
![]() |
||||||||||
tl:epcAttributes | - |
0…*- | Supports optional inclusion of human readable barcode content associated with each epc number in a commission event. Only included if provided in original commission event. | ||||||||||
@epc | 1/* |
1…1String | The EPC serial number to
which the tl:barcodeContent is associated. The epc must be an EPC Pure Identity
URI as specified in Section 6 of [TDS1.5]. Valid value: |
||||||||||
tl:barcodeContent | 0/* |
1…1String | The human readable barcode contents encoded in the 2D barcode with parenthesis for the AI keys.131 | ||||||||||
tl:plantLocationId | 0/* |
0…1String | Identifier of plant where products are commissioned.132 | ||||||||||
tl:productionLineId | 1/* |
0…1String | Identifier of production line where products are commissioned.133 | ||||||||||
tl:lineManagerName | 0/* |
0…1String | Name of the person responsible as the production line manager for the commissioned products.134 | ||||||||||
tl:companyPrefix | 0/* |
0…1String | The GS1 Company Prefix. | ||||||||||
tl:internalMaterialCode | 0/* |
0…1String | Conditionally required for GS1 EPCIS conformance. Internal material number for the product in the Pharmaceutical Manufacturer's internal systems (e.g. ERP).135![]() |
||||||||||
tl:packagingItemCode | 0/* |
0…1String | Conditionally required for GS1 EPCIS conformance. The product code for the
commissioned item (e.g. GTIN-14).136![]() |
||||||||||
@type | 1/* |
1…1String | Conditionally required if tl:packagingItemCode is populated. The product code type. Valid values:137
|
||||||||||
tl:countryDrugCode | 0/* |
0…1String | Conditionally required for GS1 EPCIS conformance. The national drug code for
the commissioned item (e.g. NDC number for US products).138![]() |
||||||||||
@type | 1/* |
1…1String | Conditionally required if tl:countryDrugCode is populated. The national drug code type
using the supported enumeration values and any formatting instructions
provided.139![]() See the CountryDrugCode enumeration list for valid values. |
||||||||||
tl:manufacturingDate | 0/10 |
0…1Date | The date of manufacture for the serialized item in YYYY-MM-DD format.140 | ||||||||||
tl:countryMarket | 0/3 |
0…1String | Conditionally required for master data reporting for EU countries reporting to EFPIA EMVS Hub. The country using the standard two or three-letter abbreviation specified in ISO 3166-1alpha-2:1997 country code.141 | ||||||||||
tl:printedExpirationDate | 0/10 |
0…1Date | Expiration date printed on the label in YYYY-MM-DD format.142 | ||||||||||
tl:referenceDocuments | - |
0…1- | Reference document identifier associated with the commissioning activity. | ||||||||||
tl:poNumber | 0/* |
0…1String | PO Number associated with serial number use. | ||||||||||
tl:poLine | 0/* |
0…1String | PO Line number. | ||||||||||
tl:workOrderNumber | 0/* |
0…1String | Work Order number associated with serial number use. | ||||||||||
tl:referenceIdentifier | 0/* |
0…1String | Reference identifier (e.g. any type of identifier) associated with serial number use. | ||||||||||
tl:extensionField | - |
0…*- | Customer extension point to
supply one or more name/value pairs containing additional data attributes not
already supported in this message. ![]() ![]() |
||||||||||
tl:fieldName | 1/* |
1…1String | Required. The field name
provided by the partner that will be receiving the mapped outbound
message.143![]() |
||||||||||
tl:fieldValue | 1/* |
1…1String | Required. The field value content that corresponds to tl:fieldName.144 | ||||||||||
extension | - |
0…1- | TransformationEvent extension. | ||||||||||
tl:decommissionSourceProduct | - |
0…1Boolean | When set to true , instructs
system to implicitly decommission serial numbers used for repackaging. Saves
a step in the repack operation so that separate decommission events do not
need to be sent.145 |
||||||||||
tl:registerSourceProduct | - |
0…1Boolean | Triggers registration of
serial numbers that are not known to the TraceLink system.
Defaults to false if not populated.146If value = |
||||||||||
tl:repackInputAttributes | - |
0…1- | Conditionally required if cmn:registerSourceProduct = true . Repack input common
attributes group with product info for input product.
|
||||||||||
cbvmda:lotNumber | 0/* |
1…1String | Required. The lot or batch code for the transformation input product in an alphanumeric string of up to 20 characters.147 | ||||||||||
cbvmda:itemExpirationDate | 0/* |
0…1Date | Required. The expiration date for the transformation input product in YYYY-MM-DD format.148 |

<?xml version="1.0" encoding="UTF-8"?> <epcis:EPCISDocument xmlns:cbvmda="urn:epcglobal:cbv:mda" xmlns:epcis="urn:epcglobal:epcis:xsd:1" xmlns:tl="http://epcis.tracelink.com/ns" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sbdh="http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader" schemaVersion="1.2" creationDate="2018-01-31T17:45:20.0Z"> <EPCISHeader> <sbdh:StandardBusinessDocumentHeader> <sbdh:HeaderVersion>1.0</sbdh:HeaderVersion> <sbdh:Sender> <sbdh:Identifier Authority="GLN">0882028677019</sbdh:Identifier> </sbdh:Sender> <sbdh:Receiver> <sbdh:Identifier Authority="GLN">0333331013655</sbdh:Identifier> </sbdh:Receiver> <sbdh:DocumentIdentification> <sbdh:Standard>EPCglobal</sbdh:Standard> <sbdh:TypeVersion>1.0</sbdh:TypeVersion> <sbdh:InstanceIdentifier>201801311745200001</sbdh:InstanceIdentifier> <sbdh:Type>Events</sbdh:Type> <sbdh:CreationDateAndTime>2018-01-31T17:45:20.0Z</sbdh:CreationDateAndTime> </sbdh:DocumentIdentification> </sbdh:StandardBusinessDocumentHeader> <extension> <EPCISMasterData> <VocabularyList> <Vocabulary type="urn:epcglobal:epcis:vtype:EPCClass"> <VocabularyElementList> <VocabularyElement id="urn:epc:idpat:sgtin:0088202.503033.*"> <attribute id="http://epcis.tracelink.com/mda/packageTypeCode">PX</attribute> <!-- Alternative product codes --> <!-- InternalMaterialCode --> <attribute id="urn:epcglobal:cbv:mda#additionalTradeItemIdentification">100335</attribute> <attribute id="urn:epcglobal:cbv:mda#additionalTradeItemIdentificationTypeCode">MANUFACTURER_PART_NUMBER</attribute> <!-- US_NDC542 --> <attribute id="urn:epcglobal:cbv:mda#additionalTradeItemIdentification">00069-4220-66</attribute> <attribute id="urn:epcglobal:cbv:mda#additionalTradeItemIdentificationTypeCode">FDA_NDC_11</attribute> <!-- CH_SWISSMEDIC --> <attribute id="urn:epcglobal:cbv:mda#additionalTradeItemIdentification">00064-2206-6</attribute> <attribute id="http://epcis.tracelink.com/mda/additionalTradeItemIdentificationTypeCode">US_NDC541</attribute> </VocabularyElement> </VocabularyElementList> </Vocabulary> </VocabularyList> </EPCISMasterData> </extension> </EPCISHeader> <EPCISBody> <EventList> <ObjectEvent> <eventTime>2018-01-31T00:12:23.8307Z</eventTime> <eventTimeZoneOffset>+05:00</eventTimeZoneOffset> <epcList> <epc>urn:epc:id:sscc:088202.00200000034</epc> </epcList> <action>ADD</action> <bizStep>urn:epcglobal:cbv:bizstep:commissioning</bizStep> <disposition>urn:epcglobal:cbv:disp:active</disposition> <bizLocation> <id>urn:epc:id:sgln:088202.867701.0</id> </bizLocation> </ObjectEvent> <ObjectEvent> <eventTime>2018-01-31T00:12:24.830Z</eventTime> <eventTimeZoneOffset>+00:00</eventTimeZoneOffset> <epcList> <epc>urn:epc:id:sgtin:0088202.503033.100000000670</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000000222</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000000225</epc> </epcList> <action>ADD</action> <bizStep>urn:epcglobal:cbv:bizstep:commissioning</bizStep> <disposition>urn:epcglobal:cbv:disp:active</disposition> <bizLocation> <id>urn:epc:id:sgln:088202.867701.0</id> </bizLocation> <extension> <ilmd> <cbvmda:lotNumber>L120012</cbvmda:lotNumber> <cbvmda:itemExpirationDate>2019-03-31</cbvmda:itemExpirationDate> <tl:commissionEventExtensions> <tl:manufacturingDate>2018-01-31</tl:manufacturingDate> </tl:commissionEventExtensions> </ilmd> </extension> </ObjectEvent> <ObjectEvent> <eventTime>2018-01-31T00:12:25.830Z</eventTime> <eventTimeZoneOffset>+00:00</eventTimeZoneOffset> <epcList> <epc>urn:epc:id:sgtin:0088202.503033.100000001020</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000001021</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000001022</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000001023</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000001024</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000001025</epc> </epcList> <action>ADD</action> <bizStep>urn:epcglobal:cbv:bizstep:commissioning</bizStep> <disposition>urn:epcglobal:cbv:disp:active</disposition> <bizLocation> <id>urn:epc:id:sgln:088202.867701.0</id> </bizLocation> <extension> <ilmd> <cbvmda:lotNumber>L120012</cbvmda:lotNumber> <cbvmda:itemExpirationDate>2019-03-31</cbvmda:itemExpirationDate> <tl:commissionEventExtensions> <tl:manufacturingDate>2018-01-31</tl:manufacturingDate> </tl:commissionEventExtensions> </ilmd> </extension> </ObjectEvent> <ObjectEvent> <eventTime>2018-01-31T00:12:25.830Z</eventTime> <eventTimeZoneOffset>+00:00</eventTimeZoneOffset> <epcList> <epc>urn:epc:id:sgtin:0088202.503033.100000001020</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000001021</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000001022</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000001023</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000001024</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000001025</epc> </epcList> <action>ADD</action> <bizStep>urn:epcglobal:cbv:bizstep:commissioning</bizStep> <disposition>urn:epcglobal:cbv:disp:active</disposition> <bizLocation> <id>urn:epc:id:sgln:088202.867701.0</id> </bizLocation> <extension> <ilmd> <cbvmda:lotNumber>L120012</cbvmda:lotNumber> <cbvmda:itemExpirationDate>2019-03-31</cbvmda:itemExpirationDate> <tl:commissionEventExtensions> <tl:manufacturingDate>2018-01-31</tl:manufacturingDate> </tl:commissionEventExtensions> </ilmd> </extension> </ObjectEvent> <ObjectEvent> <eventTime>2018-01-31T00:12:26.830Z</eventTime> <eventTimeZoneOffset>+00:00</eventTimeZoneOffset> <epcList> <epc>urn:epc:id:sgtin:088202.0503022.100000001020</epc> <epc>urn:epc:id:sgtin:088202.0503022.100000001021</epc> </epcList> <action>DELETE</action> <bizStep>urn:epcglobal:cbv:bizstep:decommissioning</bizStep> <disposition>urn:epcglobal:cbv:disp:inactive</disposition> <readPoint> <id>urn:epc:id:sgln:088202.867701.0</id> </readPoint> <tl:decommissionEventExtensions> <tl:transactionDate>2017-02-19</tl:transactionDate> <tl:disaggregateFromParent>false</tl:disaggregateFromParent> <tl:marketCountryCode>RU</tl:marketCountryCode> <tl:businessPartyInfo> <tl:businessId type="SGLN">088202.867701.0</tl:businessId> <tl:businessClassification>DISTRIBUTOR</tl:businessClassification> <tl:BusinessPartyDetail> <tl:businessName>Russia Pharma</tl:businessName> <tl:street1>Bolshoy Devyatinsky Lane 8</tl:street1> <tl:city>Moskva</tl:city> <tl:stateOrRegion>Presnensky</tl:stateOrRegion> <tl:postalCode>121099</tl:postalCode> <tl:country>RU</tl:country> <tl:addressObjectGUID>19406454-0022-000C-00B0-000000000152</tl:addressObjectGUID> <tl:houseGUID>986f2934-be05-438f-A30E-c15b90e15dbc</tl:houseGUID> </tl:BusinessPartyDetail> </tl:businessPartyInfo> <tl:warehouseOperatorName>John Smith</tl:warehouseOperatorName> <tl:decommissionReasonCode>PRODUCTION_DEFECT</tl:decommissionReasonCode> <tl:reasonDescription>Defect from production</tl:reasonDescription> </tl:decommissionEventExtensions> </ObjectEvent> <ObjectEvent> <eventTime>2017-02-19T00:12:25.834Z</eventTime> <eventTimeZoneOffset>+00:00</eventTimeZoneOffset> <epcList> <epc>urn:epc:id:sgtin:088202.0503022.100000001020</epc> <epc>urn:epc:id:sgtin:088202.0503022.100000001021</epc> </epcList> <action>DELETE</action> <bizStep>urn:epcglobal:cbv:bizstep:destroying</bizStep> <disposition>urn:epcglobal:cbv:disp:destroyed</disposition> <readPoint> <id>urn:epc:id:sgln:088202.867702.0</id> </readPoint> <tl:destroyEventExtensions> <tl:transactionDate>2017-01-30</tl:transactionDate> <tl:disaggregateFromParent>false</tl:disaggregateFromParent> <tl:marketCountryCode>RU</tl:marketCountryCode> <tl:businessPartyInfo> <tl:businessId type="SGLN">088202.867701.0</tl:businessId> <tl:businessClassification>DISTRIBUTOR</tl:businessClassification> <tl:BusinessPartyDetail> <tl:businessName>Russia Pharma</tl:businessName> <tl:street1>Bolshoy Devyatinsky Lane 8</tl:street1> <tl:city>Moskva</tl:city> <tl:stateOrRegion>Presnensky</tl:stateOrRegion> <tl:postalCode>121099</tl:postalCode> <tl:country>RU</tl:country> <tl:addressObjectGUID>19406454-0022-000C-00B0-000000000152</tl:addressObjectGUID> <tl:houseGUID>986f2934-be05-438f-A30E-c15b90e15dbc</tl:houseGUID> </tl:BusinessPartyDetail> </tl:businessPartyInfo> <tl:warehouseOperatorName/> <tl:decommissionReasonCode>DAMAGED</tl:decommissionReasonCode> <tl:reasonDescription/> </tl:destroyEventExtensions> </ObjectEvent> <AggregationEvent> <eventTime>2016-08-31T00:12:27</eventTime> <eventTimeZoneOffset>-04:09</eventTimeZoneOffset> <parentID>urn:epc:id:sscc:088202.00200000034</parentID> <childEPCs> <epc>urn:epc:id:sgtin:0088202.503033.100000000670</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000000222</epc> <epc>urn:epc:id:sgtin:0088202.503033.100000000225</epc> </childEPCs> <action>ADD</action> <bizStep>urn:epcglobal:cbv:bizstep:packing</bizStep> <disposition>urn:epcglobal:cbv:disp:in_progress</disposition> <bizLocation> <id>urn:epc:id:sgln:088202.67345.0</id> </bizLocation> </AggregationEvent> <!-- Product Release --> <ObjectEvent> <eventTime>2017-02-19T00:12:27.837Z</eventTime> <eventTimeZoneOffset>+00:00</eventTimeZoneOffset> <epcList/> <action>OBSERVE</action> <bizStep>http://epcis.tracelink.com/bizstep/releasing</bizStep> <disposition>http://epcis.tracelink.com/disp/released</disposition> <readPoint> <id>urn:epc:id:sgln:064202.867702.0</id> </readPoint> <bizTransactionList> <bizTransaction type="http://epcis.tracelink.com/hc/btt/certificateconformity" date="2019-03- 18">urn:epcglobal:cbv:bt:0882028677019:H9022413</bizTransaction> <bizTransaction type="http://epcis.tracelink.com/hc/btt/declarationconformity" date="2019-03- 18">urn:epcglobal:cbv:bt:0882028677019:D8125416</bizTransaction> </bizTransactionList> <extension> <ilmd> <cbvmda:lotNumber>L120012</cbvmda:lotNumber> <tl:productReleaseEventExtensions> <tl:internalMaterialCode>11002-5412-1</tl:internalMaterialCode> <tl:countryDrugCode type="US_NDC541">0069-4220-66</tl:countryDrugCode> <tl:qualityControlEntityId type="GLN">0882028677010</tl:qualityControlEntityId> <tl:productionQty> <tl:packagingItemCode type="GTIN-14">50300694220667</tl:packagingItemCode> <!-- <tl:companyPrefix>503006</tl:companyPrefix> --> <tl:packagingLevel>EA</tl:packagingLevel> <tl:quantityReported>100</tl:quantityReported> </tl:productionQty> </tl:productReleaseEventExtensions> </ilmd> </extension> </ObjectEvent> </EventList> </EPCISBody> </epcis:EPCISDocument>

Data Element | Error Message | Description |
---|---|---|
Class 1 | ||
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. |
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. |
VocabularyElement | @id | Item code is required in source VocabularyElement[@id] !!! | The error occurs if the source is empty or null. |
SGTIN or NTIN in VocabularyElement id is required !!! | The error occurs if the source is not an |
|
attribute | Valid packagingLevel code is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. |
Packaging Level is required if header master data is populated !!! | The error occurs if header master data is populated, but the source is empty or null. | |
Only one country drug code is supported !!! | The error occurs if more than one country drug code is present. | |
VocabularyElement | @id | GLN party type not supported. SGLN is required !!! | The error occurs if the source is not an SGLN. |
Valid decommissioning event location identifier type is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. | |
attribute | Decommissioning event location business name is required !!! | The error occurs if the source is empty or null. |
Valid business classification code is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. | |
Decommissioning event location street address is required !!! | The error occurs if the source is empty or null. | |
Decommissioning event location city is required !!! | The error occurs if the source is empty or null. | |
3-digit numeric District code required for country India !!! | The error occurs if the source is empty or null. | |
Decommissioning event location state or region is required !!! | The error occurs if the source is empty or null. | |
Decommissioning event location country is required !!! | The error occurs if the source is empty or null. | |
VocabularyElement | @id | Valid destroy event location identifier type is required !!! | The error occurs if the source is empty or null. |
attribute | Destroy event location business name is required !!! | The error occurs if the source is empty or null. |
Destroy event location street address is required !!! | The error occurs if the source is empty or null. | |
Destroy event location city is required !!! | The error occurs if the source is empty or null. | |
Destroy event location city is required !!! | The error occurs if the source is empty or null. | |
Destroy event location state or region is required !!! | The error occurs if the source is empty or null. | |
Destroy event location country is required !!! | The error occurs if the source is empty or null. | |
ObjectEvent (Commissioning Events) | At least one commissioning event is required !!! | The error occurs if the source is empty or null. |
epcList | epc | Invalid EPC format !!! | The error occurs if the source is invalid, empty, or null. |
ObjectEvent (Commissioning Events) | bizStep | bizStep urn:epcglobal:cbv:bizstep:commissioning is required for ObjectEvent commissioning !!! | The error occurs if the source does not equal "urn:epcglobal:cbv:bizstep:commissioning" for a commissioning event. |
ObjectEvent (Commissioning Events) | disposition | Disposition urn:epcglobal:cbv:disp:active is required for ObjectEvent commissioning !!! | The error occurs if the source does not equal "urn:epcglobal:cbv:disp:active". |
ObjectEvent (Commissioning Events) | bizLocation | id | Event location in the commissioning event is required !!! | The error occurs if the source is empty or null. |
cbvmda:lotNumber | Lot number is required !!! | The error results if the source is |
cbvmda:itemExpirationDate | Expiration date is required !!! | The error results if the source is |
tl:packagingLevel | Packaging Level is required !!! | The error results if the source is |
Valid packaging level code required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. | |
tl:packagingItemCode | @type | Packaging item code type required if packagingItemCode is populated !!! | The error occurs if source tl:packagingItemCode is populated, but the source is empty or null. |
tl:countryDrugCode | @type | Country drug code type is required if country drug code is populated !!! | The error occurs if tl:countryDrugCode is populated, but the source is empty or null. |
tl:fieldName | Field name is required if ExtensionField group present in source !!! | The error occurs if tl: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 the source is empty or null. |
Field value is required !!! | The error occurs if the source is empty or null. | |
ObjectEvent (Decommissioning Events) | action | Action DELETE is required for decommissioning !!! | The error occurs if the source does not equal "DELETE" for decommission. |
ObjectEvent (Decommissioning Events) | bizStep | bizStep urn:epcglobal:cbv:bizstep:decommissioning is required for decommissioning !!! | The error occurs if the source does not equal "urn:epcglobal:cbv:bizstep:decommissioning" for a decommissioning event. |
ObjectEvent (Decommissioning Events) | disposition | Disposition urn:epcglobal:cbv:disp:inactive is required for decommissioning !!! | The error occurs if the source does not equal "urn:epcglobal:cbv:disp:inactive". |
ObjectEvent (Decommissioning Events) | readPoint | id | Source read point ID is required !!! | The error occurs if the source is empty or null. |
Valid decommissioning event location identifier type is required !!! | The error occurs if the source is invalid. | |
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, or if the source is not a valid value. |
tl:marketCountryCode | Market Country Code must be at least two characters !!! | The error occurs if the source is populated, but is less than 2 characters. |
tl:decommissionReasonCode | Valid reason code is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. |
tl:destructionMethod | Valid destruction method code is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. |
ObjectEvent (Destroying Events) | action | Action DELETE is required for destroying !!! | The error occurs if the source does not equal "DELETE" for destroying. |
ObjectEvent (Destroying Events) | bizStep | bizStep urn:epcglobal:cbv:bizstep:destroying is required for destroying !!! | The error occurs if the source does not equal "urn:epcglobal:cbv:bizstep:destroying" for a destroying event. |
ObjectEvent (Destroying Events) | disposition | Disposition urn:epcglobal:cbv:disp:destroyed is required for destroying !!! | The error occurs if the source does not equal "urn:epcglobal:cbv:disp:destroyed". |
ObjectEvent (Destroying Events) | readPoint | id | Source read point ID is required !!! | The error occurs if the source is empty or null. |
Valid destroy event location identifier type is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. | |
AggregationEvent | parentID | Invalid EPC format !!! | The error occurs if the source is invalid. |
AggregationEvent | bizStep | bizStep urn:epcglobal:cbv:bizstep:packing is required for the AggregationEvent !!! | The error occurs if the source does not equal "urn:epcglobal:cbv:bizstep:packing" for a aggregation event. |
AggregationEvent | disposition | Disposition urn:epcglobal:cbv:disp:in_progress is required for the AggregationEvent !!! | The error occurs if the source does not equal "urn:epcglobal:cbv:disp:in_progress", or is empty or null. |
AggregationEvent | bizLocation | id | Event location in the aggregation event is required !!! | The error occurs if the source is empty or null. |
ObjectEvent (Product Release Events) | Only one product release event is required !!! | The error occurs if more than one product release event is present. |
Product release event data is required !!! | The error occurs if the source is empty or null. | |
ObjectEvent (Product Release Events) | bizStep | bizStep http://epcis.tracelink.com/bizstep/releasing is required for ObjectEvent product release !!! | The error occurs if the source does not equal "http://epcis.tracelink.com/bizstep/releasing" for a product release. |
ObjectEvent (Product Release Events) | disposition | Disposition http://epcis.tracelink.com/disp/released is required for ObjectEvent product release !!! | The error occurs if the source does not equal "http://epcis.tracelink.com/disp/released". |
ObjectEvent (Product Release Events) | readPoint | id | Event location in the product release event is required !!! | The error occurs if the source is empty or null. |
tl:qualityControlEntityId | Quality control entity Id is required if bizTransaction is populated !!! | The error occurs if bizTransaction in the ObjectEvent for product release events is populated, but the source is empty or null. |
tl:qualityControlEntityId | @type | Valid quality control entity identifier type is required !!! | The error occurs if the source is present, but there is no matching entry in the lookup file. |
choice1 | Only one of either packaging item code or company prefix may be present !!! | The error occurs if both tl:packagingItemCode and tl:companyPrefix are populated, or both are empty or null. |
tl:quantityReported | Quantity reported is required !!! | The error occurs if the source is empty or null. |
inputEPCList | One of either inputEPCList OR inputQuantityList is required !!! | The error occurs if both inputQuantityList and the source are null or empty. |
inputEPCList | epc | Invalid EPC format !!! | The error occurs if the source is in a format other than |
SSCC code is invalid in inputEPCList !!! | The error occurs if the source is not |
|
quantityElement | epcClass | Lot number is required !!! | The error occurs if the source is empty or null. |
Valid item code is required !!! | The error occurs if the source is invalid. | |
quantityElement | quantity | Input quantity for epcClass is required !!! | The error occurs if inputQuantityList is populated, but the source is empty or null. |
outputEPCList | Output epc list is required !!! | The error occurs if the source is empty or null. |
outputEPCList | epc | China resource code serial number is not supported. Serial number must be NTIN or SGTIN !!! | The error occurs if the source is not a NTIN or SGTIN. |
SSCC code is invalid in outputEPCList !!! | The error occurs if the source is invalid. | |
epc serial number is required !!! | The error occurs if the source is empty or null. | |
Invalid EPC format !!! | The error occurs if the source is invalid. | |
tl:repackInputAttributes | repackInputAttributes group is required if registerSourceProduct equals true !!! | The error occurs if tl:registerSourceProduct is set to true, but the source is empty or null. |
cbvmda:itemExpirationDate | Item expiration date is required !!! | The error occurs if tl:repackInputAttributes is present but the source is missing or null. |
Class 2 | ||
tl:decommissionReasonCode | Reason Code is required for products sold in Russia | The error occurs if a Target Market in Product Master Data for the decommissioned or destroyed product = "RU", but the source is empty or null. |
tl:destructionMethod | Destruction Method is required for products sold in Russia | The error occurs if a Target Market in Product Master Data for the decommissioned or destroyed product = "RU", but the source is empty or null. |
bizTransaction | A Transaction Identifier for either 'Declaration of Conformity' or 'Certificate of Conformity' is required for products that are commissioned and sold in Russia | The error occurs if a Target Market in Product Master Data for the released product = "RU" and the lot was commissioned and sold in Russia, but the source is empty or null. |
bizTransaction | @date | Transaction Identifier Date is required for products that are commissioned and sold in Russia | The error occurs if a Target Market in Product Master Data for the decommissioned or destroyed product = "RU" and the lot was commissioned in Russia, but the source is empty or null. |
bizTransaction | @type | Transaction Identifier for 'Removal from Circulation' is required for products sold in Russia | The error occurs if a Target Market in Product Master Data for the decommissioned or destroyed product = "RU", but the source does not equal "http://epcis.tracelink.com/hc/btt/removal". |
tl:addressObjectGUID | AddressObjectGUID cannot be blank for Country RU. | The error occurs if tl:country = "RU", but the source is empty or null. |
tl:qualityControlEntityId | Quality Control Entity ID is required for products that are commissioned outside of Russia and sold in Russia | The error occurs if a Target Market in Product Master Data for the released product = "RU" and the lot was commissioned outside of Russia, 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. |
Release Product Request & Response (SOAP)

Guidelines
Data Element | Occurs Length |
Format | Description | ||||||
---|---|---|---|---|---|---|---|---|---|
soapenv:Envelope | - |
1...1- | Required. SOAP Envelope root element. | ||||||
soapenv:Header | - |
1...1- | Required. Not used by TraceLink. SOAP Message Header. | ||||||
soapenv:Body | - |
1...1- | Required. SOAP Message Body. | ||||||
urn:ReleaseProduct | - |
1...1- | Required. ReleaseProduct is a request message that sets all serial numbers in a lot to "quality released". | ||||||
LotQueryRequest | - |
0...1- | Required. Queries the serialization status of an ItemCode and Lot. | ||||||
ItemCode | 1/* |
1...1String | Required. Packaging level item code value (e.g. 00882025030220). | ||||||
ItemCodeType | 1/* |
0...1String | Identifies the packaging
level item code type (e.g. GTIN14). See the ItemCode enumeration list for valid values. |
||||||
Lot | 1/* |
0...1String | Lot Number associated with the designated serial numbers at time of the ReleaseProduct request (e.g. L201409132). | ||||||
EventDateTime | - |
0...1Date | Date and time of the event in XSD date time format in GMT (i.e. YYYY-MM-DDTHH:MM:SSZ). If empty or null, EventDateTime defaults to the current date time. | ||||||
QualityControlEntityID | 1/* |
0...1String | Conditionally required if at least one Target Market in Product Master Data = RU and the lot was commissioned outside of Russia. Business or location identifier of the entity responsible for quality control. |
||||||
@identifiertype | 1/* |
0...1String | Required. The business or location identifier type. See the BusinessAndLocationId enumeration list for valid values. |
||||||
@identifiervalue | 1/* |
0...1String | Required. The value of the entity responsible for quality control. | ||||||
Transactions | - |
0...1- | Conditionally required if at least one Target Market in Product Master Data = RU and the lot was commissioned in Russia. The transaction identifier associated with the product being released.![]() |
||||||
Transaction | - |
1...*- | Required. List of one or more transaction identifiers. | ||||||
ItemID | 1/* |
0...1String | Required. The transaction identifier associated with the status update. | ||||||
ItemType | 1/* |
0...1String | Required. The transaction identifier type. Valid values:
|
||||||
Date | 1/* |
0...1String | Conditionally required if at least one Target Market in Product Master Data = RU and the lot was commissioned in Russia. The date of the transaction in XML YYYY-MM-DD format. |
||||||
ProductionQuantity | - |
0...*- | List of each aggregation hierarchy level. Used to optionally validate serial number quantities. | ||||||
PackagingItemCode | - |
0...1- | Conditionally required if CompanyPrefix is not populated. Identifies the product using the packaging level item code (e.g. GTIN-14) configured in Product Master Data. | ||||||
ItemCodeType | 1/* |
1...1String | Required. The packaging level item code type. See the PackagingItemCodeType enumeration list for valid values. |
||||||
ItemCode | 1/* |
1...1String | Required. The packaging level item code value. | ||||||
CompanyPrefix | 0/* |
0...1String | Conditionally required if PackagingItemCode is not populated. The GS1 company prefix (e.g. 038522). | ||||||
PackagingLevel | 1/* |
1...1String | Required. The packaging level of the commissioned item. See the PackagingLevel enumeration list for valid values. |
||||||
QuantityReported | 1/* |
1...1Integer | Required. Quantity reported for the released product. |
Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:tracelink:soap"> <soapenv:Header/> <soapenv:Body> <urn:ReleaseProduct> <LotQueryRequest> <ItemCode>00882025030220</ItemCode> <ItemCodeType>GTIN14</ItemCodeType> <Lot>L201409132</Lot> <EventDateTime>2019-07-1609:22:01Z</EventDateTime> <QualityControlEntityID identifiertype="GLN" identifiervalue="6667771013655"> <Transactions> <Transaction> <ItemID>INVOICE</ItemID> <ItemType>INV007</ItemType> <Date>2019-07-16</Date> </Transaction> </Transactions> <ProductionQuantity> <PackagingItemCode> <ItemCodeType>GTIN-14</ItemCodeType> <ItemCode>00992326050107</ItemCode> </PackagingItemCode> <CompanyPrefix>038522</CompanyPrefix> <PackagingLevel>EA</PackagingLevel> <QuantityReported>100</QuantityReported> </ProductionQuantity> </QualityControlEntityID> </LotQueryRequest> </urn:ReleaseProduct> </soapenv:Body> </soapenv:Envelope>
Errors
Exception Code | Exception Message |
---|---|
LOTALREADYRELEASED | Lot <lot number> for item <item number> has already been set to Quality Released. |
LOTNOTFOUND | Lot <lot number> for item <item number> does not exist. |
VALIDATION | The parameter itemCode is missing or has an invalid value. |
The parameter itemCodeType is missing or has an invalid value. | |
The parameter lot is missing or has an invalid value. | |
QUALITYCONTROLENTITYRUSSIA | Quality Control Entity ID is required for products that are commissioned outside of Russia and sold in Russia. |
TRANSACTIONIDRUSSIA | A Transaction Identifier for either 'Declaration of Conformity' or 'Certificate of Conformity' is required for products that are commissioned and sold in Russia. |
Transaction Identifier Date is required for products that are commissioned and sold in Russia. | |
PRODUCTIONQUANTITYVALIDATION | Product Release transaction processing failed due to serial number quantity verification failure. [quantity of commissioned serial number] at [packaging level] level found in the system but Product Release message reported lower quantity [QuantityReported] for [country drug code/Internal Material Number ] [Product name in English if English is not available use the first language available alphabetically by language code] [packaging code /type] at [location]. |
Product Release transaction processing failed due to serial number quantity verification failure. [Quantity of commissioned serial number] at [packaging level] level found in the system but Product Release message reported higher quantity [QuantityReported] for [country drug code/Internal Material Number ] [Product name in English if English is not available use the first language available alphabetically by language code] [packaging code /type] at [location]. | |
Can not process Product Release transaction. The packaging level quantities in the transaction do not match the packaging level quantities in the aggregation hierarchy. Possibly the aggregation events have not yet been processed. |

Guidelines
Data Element | Occurs Length |
Type | Description | ||||||
---|---|---|---|---|---|---|---|---|---|
S:Envelope | - |
1...1- | Required. SOAP Envelope root element. | ||||||
S:Body | - |
1...1- | Required. SOAP Message Body. | ||||||
ns2:ReleaseProductResponse | - |
1...1- | Required. Release Product response message. | ||||||
TLResponse | - |
0...1- | Required. TraceLink ReleaseProduct response. | ||||||
Success | - |
0...1- | Required. Indicates if the ReleaseProduct request successfully processed (e.g. true). | ||||||
ExceptionReturn | - |
0...1- | Conditionally required if Success = false . Error
information. |
||||||
CallException | - |
1...*- | Required. Contains error details. | ||||||
ExceptionCode | 0/* |
0...1String | Required. Error code for exception. | ||||||
ExceptionMessage | 0/* |
0...1String | Conditionally required. Message that further describes the error condition. |
Example
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:ReleaseProductResponse xmlns:ns2="urn:tracelink:soap" xmlns:ns3="http://tracelink.com/som"> <TLResponse> <Success>true</Success> </TLResponse> </ns2:ReleaseProductResponse> </S:Body> </S:Envelope>