ESM Shipment Guidelines (XML)

See How To Use this Guide before interpreting the guidelines below.

Message Type: SOM_ESM_SHIPMENT

Info Exchange Display Name: ESM Shipment

When sending an element in Date or DateTime format, a valid date must be given. "00" is not a valid day or month value and "0000" is not a valid year value.
Date Element Occurs
Length		 Format Description
som:SOMSalesShipmentMessage [1…1]
[-]		 - Required. Root element of message.
  som:ControlFileHeader [1…1]
[-]		 - Required. The message document's header information.
    cmn:FileSenderNumber [1…1]
[1/20]		 String Required. The company identifier of the file’s sender. *1
    cmn:FileReceiverNumber [1…1]
[1/20]		 String Required. The company identifier of the file’s recipient. *2
    cmn:FileControlNumber [1…1]
[1/20]		 String Required. The message’s unique file control ID number. A file control ID number is mandatory for all messages. *3
    cmn:FileDate [1…1]
[10/10]		 Date Required. The date that the message is sent in YYYY-MM-DD format. Date and times must be in GMT. *4
    cmn:FileTime [1…1]
[9/9]		 Time Required. Time file generated in XML in HH:MM:SSZ format. 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. *5
  som:MessageBody [1…1]
[-]		 - Required. Main body of message.
    cmn:LocationId [0…1]
[0/34]		 String Specifies the facility/warehouse identifier to scope the Sales Shipment Status update for the serial numbers matching the specified item code and lot number. *6

If the location is omitted, the Sales Shipment status update is applied globally to all matching serial numbers in the system.
    cmn:DeliveryNumber [1…1]
[1/*]		 String Required. Links the order information to the serialized receive information for this customer delivery. *7
    cmn:DeliveryCompleteFlag [0…1]
[1/*]		 Boolean Required. Instructs TraceLink to process the outbound delivery, update the status of all serial numbers and sub-child aggregations to shipped, and trigger generation of regulatory reporting messages based on customer configuration. *8

If all of the information (order detail and received serial numbers) is in a single message, the delivery complete flag is set to true.

If only partial information is in the message (e.g. order detail only, received items sent incrementally, etc.) the delivery complete flag is set to false for all intermediate messages, and then set to true when the delivery is complete and all information has been communicated to TraceLink.

Values must be lower case only. True or TRUE will throw an error.
    som:OrderDetails [0…1]
[-]		 - Includes business transaction identifier and date, order item receive list, and sender and recipient information. This element is mandatory before the delivery complete flag can be set, though it can be communicated at any time (e.g. with, before, or after the received serial numbers have been communicated).
      cmn:DisaggregateFromParent [0…1]
[0/*]		 Boolean When set to true instructs the system to disaggregate the picked serial number from the parent container, if it is aggregated. If not set, or set to false, the system will operate in default mode, which is to generate an error if attempting to pick serial number for an item or container that is aggregated to a parent. *9
Values must be lower case only. True or TRUE will throw an error.
      cmn:CorrectiveShipment [0…1]
[0/*]		 Boolean Indicates that a new Serialized Operations Manager Shipment is correcting a previously voided Serialized Operations Manager Shipment message. Default value is false, which indicates that it is not a corrective shipment. *10
Values must be lower case only. True or TRUE will throw an error.
      cmn:OriginalDeliveryNumber [0…1]
[0/*]		 String Records original delivery number that is replaced when shipment is and corrections are made to delivery. *11
      cmn:EntryPort [0…1]
[0/*]		 String

Name of the shipment's port of entry into a country (e.g. an airport, maritime port, border checkpoint).
      cmn:ExitPort [0…1]
[0/*]		 String

Name of the shipment's port of exit from a country (e.g. an airport, maritime port, border checkpoint).
      cmn:TransactionIdentifier [1…*]
[1/*]		 String Required. Identifier that associates with the received serial numbers, for regulatory reporting purposes. *12

At least one transaction id is mandatory. More than one may be mandatory depending on country.

Country Requirements:
  • US provides PO Number, ASN Number, and Invoice Number if available.
  • China provides Sales Order Number.
  • Argentina provides Packing Slip Number.
        @type [1…*]
[1/*]		 String Required. The transaction identifier type using supported enumeration values (e.g. ASN, PO, RETURN). *13

See the TransactionId enumeration list for valid values.
        @date [0…1]
[0/*]		 Date Conditionally required if cmn:ShipToCountry = RU. The transaction identifier date. *14
      cmn:TransactionDate [1…1]
[1/*]		 Date Required. The date of the transaction in YYYY-MM-DD format. *15
      cmn:TransactionTime [0…1]
[0/*]		 Time The time of the transaction in HH:MM:SS format. *16
      cmn:ShipToCountryCode [1…1]
[2/2]		 String Required. ISO country code for ship to country. Provides application with the information it needs to trigger regulatory reporting in response to relevant events. *17
      cmn:ShipFromCountryCode [0…1]
[2/2]		 String Conditionally required if the product is being exported from country (e.g. when cmn:ReceiptDistributionType = EXPORTSALE, EXPORTTRANSFER, or EXPORTRETURN). ISO country code for ship from country. Provides application with the information it needs to trigger regulatory reporting in response to relevant events. *18
      cmn:SalesDistributionType [0…1]
[1/*]		 String Required. Advises the application of sale (change of ownership of the product) and transfer (no change of ownership of product, but physical movement of product) for application and regulatory reporting purposes. The actual triggering of regulatory reporting is governed by the configuration in TraceLink. *19

INCOUNTRYTRANSFER and EXPORTTRANSFER include:

  • Intra-company warehouse transfer of goods.
  • Transfers between Pharmaceutical Manufacturer and 3PL.
  • Transfers between Pharmaceutical Manufacturer and CMO/CPO.
  • Transfers between CMO/CPO and 3PL of Pharmaceutical Manufacturer.
Setting this value alone does not trigger regulatory reporting.

See the SalesDistType enumeration list for valid values.
      cmn:SupplyType [0…1]
[1/*]		 String

Conditionally required for Brazil if performing Collection, Donation, or SampleDistribution and if cmn:ShipFromCountryCode = KR and cmn:ReceiptDistributionType = EXPORTSALE or EXPORTRETURN; all values except for Collection apply. Identifies the type of supply that is being performed using a valid value from the enumerations list.

See the SupplyType enumeration list for valid values.
      cmn:ContractType [0…1]
[1/*]		 String

Conditionally required if cmn:ShipFromCountryCode = KR and cmn:ReceiptDistributionType = EXPORTSALE or EXPORTRETURN. Identifies the type of contract for the sale of goods using a valid value from the enumerations list.

See the ContractType enumeration list for valid values.

      cmn:DropShipment [0…1]
[0/*]		 Boolean Indicates if shipment is a drop shipment. *20
Values must be lower case only. True or TRUE will throw an error.
      cmn:PortalAccessCode [0…1]
[0/*]		 String The portal access code used to access drop shipments in the serialized drop ship portal.
      cmn:Comments [0…1]
[0/*]		 String Optional remarks or comments regarding delivery.
      cmn:ContractNumber [0…1]
[0/*]		 String Identification number of the contract. *21
      cmn:FundingSource [0…1]
[0/*]		 String Conditionally required if both cmn:ShipToCountryCode and cmn:ShipFromCountryCode = RU.Source of the funding. *22

See the FundingSource enumeration list for valid values.
      cmn:DeliveryInspection [0…1]
[0/*]		 String

The inspection status of the physical delivery against the delivery documentation.

See the DeliveryInspection enumeration list for valid values.
      cmn:DeliveryInspectionDate [0…1]
[10/10]		 Date The date of the physical delivery inspection against the delivery documentation in YYYY-MM-DD format. *23
      cmn:DeliveryInspectionNote [0…1]
[0/*]		 String Comments about the physical delivery inspection against the delivery documentation.
      cmn:RemovalFromCirculation [0…1]
[0/*]		 String

Reason the product in the delivery is taken out of the supply chain.

See the RemovalFromCirculation enumeration list for valid values.
      cmn:AggregationInspection [0…1]
[0/*]		 String

The inspection status of the aggregation hierarchy of the container.

See the AggregationInspection enumeration list for valid values.
      cmn:OrderItemList [0…1]
[-]		 - Order item list group is populated to communicate the expected receive quantities for each item code at the EACH (unit) level. This information is used to verify the actual serial number received, the correct product, the correct lot number (if provided), and the correct each quantity.
        cmn:AllowShortVerificationCount [0…1]
[0/*]		 Boolean When set to true, allows the count to come up short without an error. If set to false, an error is thrown if the count does not match what is expected. *24
        cmn:OrderItem [1…*]
[-]		 - Required. Order item group is a repeating element that captures the item code, lot number, and quantity for each item that will be received for the order. Each unique item code and lot number are communicated in a separate order item group.
          cmn:OrderItemNumber [0…1]
[0/*]		 String Order item number attribute associating specific serial numbers with the price, VAT, and cost taxes reported in a specific instance of cmn:OrderItem.
          choice%1 [1…1]
[-]		 Choice Required. Mandatory choice. Populate only one of cmn:InternalMaterialCode or cmn:PackagingItemCode. One of the two options must be present.
          cmn:InternalMaterialCode [0…1]
[1/*]		 String Required. Option 1 for choice%1 in cmn:OrderItem. Use to identify the product using the internal material number configured in Product Master Data. *25
Mandatory if cmn:PackagingItemCode is not populated.
          cmn:PackagingItemCode [0…1]
[0/*]		 String Required. Option 2 for choice%1 in cmn:OrderItem. Use to identify the product using the packaging level item code (e.g. GTIN-14) configured in Product Master Data. *26
Mandatory if cmn:InternalMaterialCode is not populated.
            @type [0…1]
[1/*]		 String Required. The product code type for the packaging item code using the supported enumeration values (e.g. GTIN-14). *27
Mandatory if cmn:PackagingItemCode is populated.

See the ItemCode enumeration list for valid values.
          cmn:LotNumber [0…1]
[0/*]		 String Conditionally required if cmn:ShipFromCountryCode = KR and cmn:IsSerialized = false.The lot or batch code for the items to be received (if available) in an alphanumeric string. *28
          cmn:ExpirationDate [0…1]
[0/*]		 Date Expiration date for product in YYYY-MM-DD format. *29
          cmn:Quantity [1…1]
[1/*]		 Integer Required. The quantity of items at the EACH (unit) level of the item code and lot if specified to be received. *30
          cmn:UnitPrice [0…1]
[-]		 Decimal Conditionally required if cmn:ShipFromCountryCode = KR or if cmn:ShipToCountryCode = RU and cmn:ShipFromCountryCode = AM, BY, KG, KZ, or RU. The unit price of an item. *31
            @currencyCode [1…1]
[0/3]		 String Required. Currency ISO code using ISO 4217-2015 format. *32
          cmn:VAT [0…1]
[-]		 Decimal Value Added Tax per unit. *33
            @currencyCode [1…1]
[3/3]		 String Required. Currency ISO code using ISO 4217-2015 format. *34

See the ISOCurrency enumeration list for valid values.
          cmn:GrossPrice [0…1]
[-]		 Decimal Gross price including unit price and all taxes and fees. *35
            @currencyCode [1…1]
[3/3]		 String Required. Required.Currency ISO code using ISO 4217-2015 format. *36

See the ISOCurrency enumeration list for valid values.

 
          cmn:IsSerialized [0…1]
[-]		 Boolean Indicates if item is not serialized. *37
If omitted, and OrderItem exists, defaults value to "true".
          cmn:TransactionIdentifier [0…*]
[0/*]		 String Transaction identifier at the line-item level of shipment. More than one transaction identifier may be present. *38
            @type [1…1]
[1/*]		 String

Required.

The transaction identifier type. Valid values:
  • DESTRUCTION
  • INVOICE
  • NOTAFISCAL
  • OTHER
  • PO
  • RETURN
            @date [0…*]
[0/*]		 Date Conditionally required if cmn:ShipToCountry = RU. The transaction identifier date. *39
      cmn:SenderInfo [1…1]
[-]		 - Required. Information about the supply chain partner that is sending the shipment. Contains XML choice elements of cmn:FromBusinessParty and cmn:ShipFromLocation that govern whether to use master data lookup to populate the address, license, and contact elements.

Only one option in choice%1 may be populated.
        choice%1 [1…1]
[-]		 Choice Required. Mandatory choice.
  • Option 1: Contains only cmn:FromBusinessPartyLookupId.
    • Populate this element only if master data lookup is desired.
  • Option 2: Contains full cmn:FromBusinessPartyInfo business address the customer populates directly in the interface.
    • Populate this element fully only if master data lookup is not desired.
        cmn:FromBusinessPartyLookupId [0…1]
[1/*]		 String Required. Option 1 for cmn:SenderInfo choice%1 group. *40

A lookup identifier associated with the sold-from business entity. This value is used as the lookup key in master data to populate the details in cmn:FromBusinessPartyInfo .

If omitted, and cmn:OrderItem exists, defaults value to true.
          @type [1…1]
[1/*]		 String Conditionally required if full business address is not provided in cmn:FromBusinessPartyInfo option. The type of the sold from business entity identifier from the provided enumeration list. *41

See the BusinessLookupId enumeration list for valid values.
        cmn:FromBusinessPartyInfo [0…1]
[-]		 - Conditionally required standalone cmn:FromBusinessPartyLookupId option to leverage master data lookup is not used. Option 2 for cmn:SenderInfo choice%1 group.

The full business information associated with the sold from business entity.

          cmn:BusinessId [1…*]
[1/*]		 String Required. The identifier associated with the sold from business entity. Mandatory for regulatory reporting. *42
            @type [1…1]
[1/*]		 String Required. The type of the BusinessId identifier. *43
Only one of the following values may be used per message:
  • RU_INN_FOREIGN_ENTITY
  • RU_INN_INDIV
  • RU_INN_LOCAL_ENTITY

See the BusinessAndLocationId enumeration list for valid values.
          cmn:BusinessClassification [0…1]
[0/*]		 String Conditionally required for Argentina. Business classification. *44

See the BusinessClassification enumeration list for valid values.
          cmn:BusinessInfo [0…1]
[-]		 - Conditionally required for US. Populates with the business name and address of the sold from business entity.
            cmn:BusinessName [1…1]
[1/*]		 String Required. The business name of the trading partner. *45
            cmn:Street1 [1…1]
[1/*]		 String Required. The first line of the street address. *46
            cmn:Street2 [0…1]
[0/*]		 String The second line of the street address. *47
            cmn:City [1…1]
[1/*]		 String Required. The city. *48
            cmn:Village [0…1]
[0/*]		 String Name of the village in which the company is located.
            cmn:HouseNumber [0…1]
[0/*]		 String 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 Street1.
            cmn:Township [0…1]
[0/*]		 String Name of the township in which the company is located.
            cmn:District [0…1]
[0/*]		 String

Name of the district subdividing the state or region.
            cmn:StateOrRegion [1…1]
[1/*]		 String Required. The state, province, or region using the standard two-letter abbreviation specified in ISO 3166-2:1998 country subdivision code. *49
            cmn:PostalCode [0…1]
[0/*]		 String The ZIP or other postal code. *50
            cmn:Country [1…1]
[1/*]		 String Required. The country using the standard two-letter abbreviation specified in ISO 3166-1alpha-2:1997 country code. *51
            cmn:CorporateFax [0…1]
[0/*]		 String Company fax number.
            cmn:AddressObjectGUID [0…1]
[0/*]		 String The global identifier assigned by the Russian Federation Information Address System (FIAS).
Maximum of 36 characters, using the digits 0-9 and letters A-F.
            cmn:HouseGUID [0…1]
[0/*]		 String The global house identifier assigned by the Russian Federation Information Address System (FIAS).
Maximum of 36 characters, using the digits 0-9 and letters A-F.
            cmn:TaxRegistrationCode [0…1]
[0/*]		 String The code used to identify this entity for tax or other legal reporting purposes (e.g. a Russia KPP Registration Code).
            cmn:PremisesCode [0…1]
[0/*]		 String Identifier representing a physical area within the company location (e.g. a location's second floor).
        choice%2 [0…1]
[-]		 Choice Optional choice element (no error if neither are present):
  • Option 1: Contains only the cmn:ShipFromLocationLookupId.
    • Populate this element only if master data lookup is desired.
  • Option 2: Contains full cmn:ShipFromLocationInfo business address fielded data that will be populated by the customer directly in the interface.
    • Populate this element fully only if master data lookup is not desired.
        cmn:ShipFromLocationLookupId [0…1]
[1/*]		 String Option 1 for cmn:SenderInfo choice%2 group. *52

A lookup identifier associated with the ship from location. Use this value as the lookup key in master data to populate the details in cmn:ShipFromLocationInfo.
          @type [1…1]
[1/*]		 String Required. The type of the ship from location identifier using the enumeration list. *53
Mandatory if full business address is not provided in cmn:ShipFromLocationInfo option.

See the LocationLookupId enumeration list for valid values.
        cmn:ShipFromLocationInfo [0…1]
[-]		 - Required. Option 2 for cmn:SenderInfo choice%2 group.

The full business information associated with the ship from location is provided directly.

          cmn:FacilityId [1…*]
[1/*]		 String Required. Ship from location identifier. *54
US: Must be a DEA, GLN, HIN, or SGLN.
            @type [1…1]
[1/*]		 String Required. The type of the FacilityId identifier. *55
Only one of the following values may be used per message:
  • RU_INN_FOREIGN_ENTITY
  • RU_INN_INDIV
  • RU_INN_LOCAL_ENTITY

See the BusinessAndLocationId enumeration list for valid values.
          cmn:LocationInfo [0…1]
[-]		 - Conditionally required for US. Business name and address of the ship from location.
            cmn:BusinessName [1…1]
[1/*]		 String Required. The business name of the trading partner. *56
            cmn:Street1 [1…1]
[1/*]		 String Required. The first line of the street address. *57
            cmn:Street2 [0…1]
[0/0*]		 String The second line of the street address.
            cmn:City [1…1]
[1/*]		 String Required. The city. *58
            cmn:Village [0…1]
[0/*]		 String Name of the village in which the company is located.
            cmn:HouseNumber [0…1]
[0/*]		 String 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 Street1.
            cmn:Township [0…1]
[0/*]		 String Name of the township in which the company is located.
            cmn:District [0…1]
[0/*]		 String

Name of the district subdividing the state or region.
            cmn:StateOrRegion [1…1]
[1/*]		 String Required. The state, province, or region using the standard two-letter abbreviation specified in ISO 3166-2:1998 country subdivision code. *59
            cmn:PostalCode [0…1]
[0/*]		 String The ZIP or other postal code. *60
            cmn:Country [1…1]
[1/*]		 String Required. The country using the standard two-letter abbreviation specified in ISO 3166-1 alpha-2:1997 country code. *61
            cmn:CorporateFax [0…1]
[0/*]		 String Company fax number.
            cmn:AddressObjectGUID [0…1]
[0/*]		 String The global identifier assigned by the Russian Federation Information Address System (FIAS).
Maximum of 36 characters, using the digits 0-9 and letters A-F.
            cmn:HouseGUID [0…1]
[0/*]		 String The global house identifier assigned by the Russian Federation Information Address System (FIAS).
Maximum of 36 characters, using the digits 0-9 and letters A-F.
            cmn:TaxRegistrationCode [0…1]
[0/*]		 String The code used to identify this entity for tax or other legal reporting purposes (e.g. a Russia KPP Registration Code).
            cmn:PremisesCode [0…1]
[0/*]		 String Identifier representing a physical area within the company location (e.g. a location's second floor).
          cmn:LicenseNumber [0…1]
[0/*]		 String Populate with the license number of the facility. This element may be repeated to include as many license numbers as required (e.g. state and federal license). *62
            @state [0…1]
[0/*]		 String Required. The state or region in which the trading partner is licensed, using the standard two letter abbreviation specified in ISO 3166-2:1998 country sub-division code. Used to give additional context to the license number. *63
            @agency [0…1]
[0/*]		 String Required. The agency that granted the license (e.g. Florida DOH, NABP). Used to give additional context to the license number. *64
          cmn:ContactInfo [0…1]
[-]		 - Conditionally required for US. Contact information for use by downstream trading partners to authenticate (e.g. verify) the message information recorded on the pedigree with the sender party.
            cmn:Name [0…1]
[0/*]		 String Required. Name of the contact department or individual at the company. *65
            cmn:Title [0…1]
[0/*]		 String Title of the individual if a person was provided in cmn:Name.
            cmn:Telephone [1…1]
[1/*]		 String Required. Phone number of the contact department or individual at the company. Must begin with the + character followed by the Country Calling Code. *66
            cmn:Email [0…1]
[0/*]		 String Email address of the contact department or individual at the company. Should be included if available. *67
            cmn:Url [0…1]
[0/*]		 String The Web address to facilitate authentication. *68
      cmn:ReceiverInfo [1…1]
[-]		 - Required. Information about the supply chain partner that is receiving the shipment. ReceiverInfo contains XML choice elements for cmn:ToBusinessParty and cmn:ShipToLocation that govern whether to use master data lookup to populate the address, license, and contact elements.

Only one option in choice%1 may be populated.
        choice%1 [1…1]
[-]		 Choice Required. Mandatory choice element. One and only one option must be selected.
  • Option 1: Contains only the cmn:ToBusinessPartyLookupId.
    • Populate this element only if master data lookup is desired.
  • Option 2: Contains full cmn:ToBusinessPartyInfo business address field data populated by the customer directly in the interface.
    • Populate this element fully only if master data lookup is not desired.
        cmn:ToBusinessPartyLookupId [0…1]
[1/*]		 String Option 1 for cmn:ReceiverInfo choice%1 group. *69

A lookup identifier associated with the sold to business entity. Use this value as the lookup key in master data to populate the details in cmn:ToBusinessPartyInfo.
          @type [1…1]
[1/*]		 String Conditionally required if full business address is not provided in cmn:ToBusinessPartyInfo. The type of the sold to business entity identifier from the provided enumeration list. *70

See the BusinessLookupId enumeration list for valid values.
        cmn:ToBusinessPartyInfo [0…1]
[-]		 - Required. Option 2 for cmn:ReceiverInfo choice%1 group.

The full business information associated with the sold to business entity is provided.
          cmn:BusinessId [1…*]
[1/*]		 String Required. The return to business entity identifier. Mandatory for regulatory reporting. *71
            @type [1…1]
[1/*]		 String Required. The type of the cmn:BusinessId identifier. *72
Only one of the following values may be used per message:
  • RU_INN_FOREIGN_ENTITY
  • RU_INN_INDIV
  • RU_INN_LOCAL_ENTITY

See the BusinessAndLocationId enumeration list for valid values.
          cmn:BusinessClassification [0…1]
[0/*]		 String Conditionally required for Argentina.Business classification. *73
Mandatory for Argentina.

See the BusinessClassification enumeration list for valid values.
          cmn:BusinessInfo [0…1]
[-]		 - Conditionally required for US.The sold to business entity business name and address.
            cmn:BusinessName [1…1]
[1/*]		 String Required. The business name of the trading partner. *74
            cmn:Street1 [1…1]
[1/*]		 String Required. The first line of the street address. *75
            cmn:Street2 [0…1]
[0/*]		 String The second line of the street address.
            cmn:City [1…1]
[1/*]		 String Required. The city. *76
            cmn:Village [0…1]
[0/*]		 String Name of the village in which the company is located.
            cmn:HouseNumber [0…1]
[0/*]		 String 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 Street1.
            cmn:Township [0…1]
[0/*]		 String Name of the township in which the company is located.
            cmn:District [0…1]
[0/*]		 String

Name of the district subdividing the state or region.
            cmn:StateOrRegion [1…1]
[1/*]		 String Required. The state, province, or region using the standard two-letter abbreviation specified in ISO 3166-2:1998 country subdivision code. *77
            cmn:PostalCode [0…1]
[0/*]		 String The ZIP or other postal code. *78
            cmn:Country [1…1]
[1/*]		 String Required. The country using the standard two-letter abbreviation specified in ISO 3166-1 alpha-2:1997 country code. *79
            cmn:CorporateFax [0…1]
[0/*]		 String Company fax number.
            cmn:AddressObjectGUID [0…1]
[0/*]		 String The global identifier assigned by the Russian Federation Information Address System (FIAS).
Maximum of 36 characters, using the digits 0-9 and letters A-F.
            cmn:HouseGUID [0…1]
[0/*]		 String The global house identifier assigned by the Russian Federation Information Address System (FIAS).
Maximum of 36 characters, using the digits 0-9 and letters A-F.
            cmn:TaxRegistrationCode [0…1]
[0/*]		 String The code used to identify this entity for tax or other legal reporting purposes (e.g. a Russia KPP Registration Code).
            cmn:PremisesCode [0…1]
[0/*]		 String Identifier representing a physical area within the company location (e.g. a location's second floor).
        choice%2 [0…1]
[-]		 Choice
  • Option 1: Contains only the cmn:ShipToLocationLookupId.
    • Populate this element only if master data lookup is desired.
  • Option 2: Contains full cmn:ShipToLocationInfo business address field data populated by the customer directly in the interface.
    • Populate this element fully only if master data lookup is not desired.
        cmn:ShipToLocationLookupId [0…1]
[0/*]		 String Required. Option 1 for cmn:ReceiverInfo choice%2 group. *80

A lookup identifier associated with the ship to location using the enumeration list. Use this value as the lookup key in master data to populate the details in cmn:ShipToLocationInfo.
          @type [1…1]
[0/*]		 String Required. The type of the ship to location identifier. *81

See the LocationLookupId enumeration list for valid values.
        cmn:ShipToLocationInfo [0…1]
[-]		 - Required. Option 2 for cmn:ReceiverInfo choice%2 group.

The full business information associated with the ship to location is provided directly.

Mandatory for US.
          cmn:FacilityId [1…*]
[1/*]		 String Required. Populated with the ship from location identifier. *82
US: Must be a DEA, GLN, HIN, or SGLN.
            @type [1…1]
[1/*]		 String Required. The type of the cmn:FacilityId identifier. *83
Only one of the following values may be used per message:
  • RU_INN_FOREIGN_ENTITY
  • RU_INN_INDIV
  • RU_INN_LOCAL_ENTITY

See the BusinessAndLocationId enumeration list for valid values.
          cmn:LocationInfo [0…1]
[-]		 - Conditionally required for US. Populated with the business name and address of the ship to location.
            cmn:BusinessName [1…1]
[1/*]		 String Required. The business name of the trading partner. *84
            cmn:Street1 [1…1]
[1/*]		 String Required. The first line of the street address. *85
            cmn:Street2 [0…1]
[0/*]		 String The second line of the street address.
            cmn:City [1…1]
[1/*]		 String Required. The city. *86
            cmn:Village [0…1]
[0/*]		 String Name of the village in which the company is located.
            cmn:HouseNumber [0…1]
[0/*]		 String 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 Street1.
            cmn:Township [0…1]
[0/*]		 String Name of the township in which the company is located.
            cmn:District [0…1]
[0/*]		 String

Name of the district subdividing the state or region.
            cmn:StateOrRegion [1…1]
[1/*]		 String Required. The state, province, or region using the standard two-letter abbreviation specified in ISO 3166-2:1998 country subdivision code. *87
            cmn:PostalCode [0…1]
[0/*]		 String The ZIP or other postal code. *88
            cmn:Country [1…1]
[1/*]		 String Required. The country using the standard two-letter abbreviation specified in ISO 3166-1 alpha-2:1997 country code. *89
            cmn:CorporateFax [0…1]
[0/*]		 String Company fax number.
            cmn:AddressObjectGUID [0…1]
[0/*]		 String The global identifier assigned by the Russian Federation Information Address System (FIAS).
Maximum of 36 characters, using the digits 0-9 and letters A-F.
            cmn:HouseGUID [0…1]
[0/*]		 String The global house identifier assigned by the Russian Federation Information Address System (FIAS).
Maximum of 36 characters, using the digits 0-9 and letters A-F.
            cmn:TaxRegistrationCode [0…1]
[0/*]		 String The code used to identify this entity for tax or other legal reporting purposes (e.g. a Russia KPP Registration Code).
            cmn:PremisesCode [0…1]
[0/*]		 String Identifier representing a physical area within the company location (e.g. a location's second floor).
          cmn:LicenseNumber [0…*]
[0/*]		 String Populate with the license number of the facility. This element may be repeated to include as many license numbers as required (e.g. state and federal license). *90
            @state [0…1]
[0/*]		 String Required. The state or region in which the trading partner is licensed, using the standard two letter abbreviation specified in ISO 3166-2:1998 country sub-division code. Used to give additional context to the license number. *91
            @agency [0…1]
[0/*]		 String Required. The agency that granted the license (e.g. Florida DOH, NABP). Used to give additional context to the license number. *92
      cmn:CarrierInfo [0...*]
[-]		 - Conditionally required if ShipToCountryCode = BR. Information about the transportation partner that is transporting the shipment. cmn:CarrierInfo contains XML choice elements that govern whether master data lookup will be used to populate the address elements. Only one option in choice%1 may be populated.
        choice%1 [1…1]
[-]		 Choice Optional choice element: No error if neither are present.
  • Option 1: Contains only the cmn:CarrierBusinessPartyLookupId.
    • Populate this element ONLY if master data lookup is desired.
  • Option 2: Contains full cmn:CarreirBusinessPartyInfo business address field data that will be populated by the customer directly in the interface.
    • Populate this element fully ONLY if master data lookup is not desired.
        cmn:CarrierBusinessPartyLookupId [0…1]
[1/*]		 String Required. Option 1 for cmn:CarrierInfo choice%1 group. *93

A lookup identifier associated with the Carrier entity from the enumeration list. This value is used as the lookup key in master data to populate the details in cmn:CarrierBusinessPartyInfo.

Mandatory if full business address not provided in cmn:CarrierBusinessPartyInfo option.
          @type [1…1]
[1/*]		 String Required. The type of the carrier business entity identifier from the provided enumeration list. *94
Mandatory if full business address not provided in cmn:CarrierBusinessPartyInfo option.

See the BusinessLookupId enumeration list for valid values.
        cmn:CarrierBusinessPartyInfo [0…1]
[-]		 - Required. Option 2 for cmn:CarrierInfo choice%1 group.

The full business information associated with the transportation carrier business entity is provided.

Mandatory if standalone cmn:CarrierBusinessPartyLookupId option to leverage master data lookup is not populated.
          cmn:BusinessId [1…*]
[1/*]		 String Required. The identifier associated with the transport carrier business entity. This value is mandatory for regulatory reporting. *95
For Brazil: Provide the BR_CNPJ, BR_CPF, BR_CNES or BR_PROF_REG. BR_CNPJ is the value preferred by ANVISA if the company has one.
            @type [1…1]
[1/*]		 String Required. The identifier associated with the transport carrier business entity. This value is mandatory for regulatory reporting. *96
Only one of the following values may be used per message:
  • RU_INN_FOREIGN_ENTITY
  • RU_INN_INDIV
  • RU_INN_LOCAL_ENTITY
For Brazil: Proivde the BR_CNPJ, BR_CPF, BR_CNES or BR_PROF_REG. BR_CNPJ is the value preferred by ANVISA if the company has one.

See the BusinessAndLocationId enumeration list for valid values.
          cmn:BusinessClassification [0…1]
[0/*]		 String N/A. Do not populate for Brazil. *97

See the BusinessClassification enumeration list for valid values.
          cmn:BusinessInfo [0…1]
[-]		 - Conditionally required for Brazil. Populate with the business name and address of the transportation carrier business entity.
            cmn:BusinessName [1…1]
[1/*]		 String Required. The business name of the trading partner. *98
            cmn:Street1 [1…1]
[1/*]		 String Required. The first line of the street address. *99
            cmn:Street2 [0…1]
[0/*]		 String The second line of the street address.
            cmn:City [1…1]
[1/*]		 String Required. The city. *100
            cmn:Village [0…1]
[0/*]		 String Name of the village in which the company is located.
            cmn:HouseNumber [0…1]
[0/*]		 String 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 Street1.
            cmn:Township [0…1]
[0/*]		 String Name of the township in which the company is located.
            cmn:District [0…1]
[0/*]		 String

Name of the district subdividing the state or region.
            cmn:StateOrRegion [1…1]
[1/*]		 String Required. The state, province, or region using the standard two-letter abbreviation specified in ISO 3166-2:1998 country subdivision code. *101
            cmn:PostalCode [0…1]
[0/*]		 String The ZIP or other postal code. *102
            cmn:Country [1…1]
[1/*]		 String Required. The country using the standard two-letter abbreviation specified in ISO 3166-1 alpha-2:1997 country code. *103
            cmn:CorporateFax [0…1]
[0/*]		 String Company fax number.
            cmn:AddressObjectGUID [0…1]
[0/*]		 String The global identifier assigned by the Russian Federation Information Address System (FIAS).
Maximum of 36 characters, using the digits 0-9 and letters A-F.
            cmn:HouseGUID [0…1]
[0/*]		 String The global house identifier assigned by the Russian Federation Information Address System (FIAS).
Maximum of 36 characters, using the digits 0-9 and letters A-F.
            cmn:TaxRegistrationCode [0…1]
[0/*]		 String The code used to identify this entity for tax or other legal reporting purposes (e.g. a Russia KPP Registration Code).
            cmn:PremisesCode [0…1]
[0/*]		 String Identifier representing a physical area within the company location (e.g. a location's second floor).
    cmn:WarehouseOperatorName [0…1]
[0/*]		 String Conditionally required for China. Name of the person responsible for warehouse operations. This element can be communicated at any time (e.g. with, before, or after the order details or received items have been communicated). *104
    som:AddPickedItems [0…1]
[-]		 - List of serial numbers for the outermost handling units received for this delivery. TraceLink looks up the child aggregations of the serial numbers provided in the list and updates the container and all sub-child items with the received and subsequent shipped status.

This element is mandatory before the delivery complete flag can be set, though it can be communicated at any time (e.g. with, before, or after the order details have been communicated).
      cmn:Serial [0…*]
[1/*]		 String Required. Serial number of an outermost handling unit received for this delivery. One serial number is included per received container (or item if shipping loose items). This is typically a pallet or case serial number. *105
        @format [0…1]
[0/*]		 String

Format of serial numbers.

See the Format enumeration list for valid values.
            @orderItemNumber [0…1]
[0/*]		 String Order item number attribute associating specific serial numbers with the price, VAT, and cost taxes reported in a specific instance of cmn:OrderItem.
    som:RemoveUnpickedItems [0…1]
[-]		 - Not used.
      cmn:Serial [0…*]
[0/*]		 String Not used.
        @format [0…1]
[0/*]		 String Not used.
    som:AddPickedLot [0…1]
[-]		 - Not used.
      cmn:ProductLotNumbers [0…*]
[-]		 - Not used.
        choice%1 [0…1]
[-]		 Choice Not used.
        cmn:InternalMaterialCode [0…1]
[0/*]		 String Not used.
        cmn:CountryDrugCode [0…1]
[0/*]		 String Not used.
          @type [0…1]
[0/*]		 String Not used.
        cmn:LotNumber [0…1]
[0/*]		 String Not used.
    som:RemoveUnpickedLot [0…1]
[-]		 - Not used.
      cmn:ProductLotNumbers [0…*]
[-]		 - Not used.
        choice%1 [0…1]
[-]		 Choice Not used.
        cmn:InternalMaterialCode [0…1]
[0/*]		 String Not used.
        cmn:CountryDrugCode [0…1]
[0/*]		 String Not used.
          @type [0…1]
[0/*]		 String Not used.
        cmn:LotNumber [0…1]
[0/*]		 String Not used.
    som:Aggregation [0…*]
[-]		 - Communicate new aggregations created by the warehouse that are included in the shipment. The picked items will continue to include the top level container serial numbers and/or loose items.
  • If the warehouse created a new aggregation (e.g. created a new pallet, created a new mixed case), the aggregation hierarchies created in the warehouse are communicated in this element.
  • If an existing case is shipped, the case just needs to be scanned and the case hierarchy would not be provided.
  • If a new mixed case is created, the hierarchy for the new case will be communicated. This enables the distribution warehouse to locally manage changes to aggregation hierarchies and communicate just the new hierarchies of the shipped goods at the time of shipment, without having to send disaggregation and aggregation events. The backend will perform the implicit disaggregate and aggregate operations to achieve the end state aggregation hierarchy prior to processing the shipment. The backend end will also auto-commission the SSCC numbers for new cases and pallets when these SSCC numbers are not yet commissioned.
      cmn:EventDateTime [0…1]
[0/*]		 DateTime Timestamp of date/time of aggregation event with the UTC time zone indicator in format: YYYY-MM-DDTHH:MM:SS.ssZ. If not provided, current GMT date time will be used. *106
      cmn:EventLocation [1…1]
[1/*]		 String Required. Site-level SGLN of the location where the event occurred. SGLN format will be numeric component only, with urn prefix stripped (e.g. 8888882.02867.0 instead of urn:epc:id:sgln:8888882.02867.0 typically found in EPCIS events). *107
      cmn:ParentSerial [1…1]
[1/*]		 String Required. Serial number expressed in the GS1 Application Identifier format without parenthesis for the AI keys. AI (01) (21) formatted serial number for GTINs-or-AI (00) formatted serial number for SSCCs. Non-GS1 serial numbers (e.g. China) are expressed in native format. *108
        @companyPrefix [0…1]
[-]		 - The GS1 Company Prefix used in GTIN-14 and SSCC serial numbers.
        @filterValue [0…1]
[-]		 - The filter value used in GTIN-14 and SSCC serial numbers.
        @format [0…1]
[1/*]		 String Format of serial numbers. *109

See the Format enumeration list for valid values.
        @packedStatus [0…1]
[1/*]		 String Indicates the packaging status of the container (full, partial).
Used in China.

See the PackedStatus enumeration list for valid values.
      cmn:PackagingLevel [0…1]
[0/*]		 String

The packaging level of the commissioned items in cmn:NumberList.

See the PackagingLevel enumeration list for valid values.
      cmn:NumberList [1…1]
[1/*]		 String Required. List of serial numbers for the items packed into the parent serial number.
        cmn:Serial [1…1]
[1/*]		 String Required. Serial number expressed in the GS1 Application Identifier format without parenthesis for the AI keys. AI (01) (21) formatted serial number for GTINs-or-AI (00) formatted serial number for SSCCs.Non-GS1 serial numbers (e.g. China) are expressed in native format. *110
          @companyPrefix [0…1]
[-]		 - The GS1 Company Prefix used in GTIN-14 and SSCC serial numbers.
          @filterValue [0…1]
[-]		 - The filter value used in GTIN-14 and SSCC serial numbers.
          @format [0…1]
[1/*]		 String Attribute identifies format of serial numbers. *111

See the Format enumeration list for valid values.
          @packedStatus [0…1]
[1/*]		 String Indicates the packaging status of the container (full, partial).
Used in China.

See the PackedStatus enumeration list for valid values.
            @orderItemNumber [0…1]
[0/*]		 String Order item number attribute associating specific serial numbers with the price, VAT, and cost taxes reported in a specific instance of cmn:orderItem.
    som:TransactionEvent [0…*]
[-]		 - Indicates the association of purchase orders with the serial numbers.
      cmn:EventDateTime [1…1]
[1/*]		 DateTime Required. Timestamp of date/time of aggregation event with the UTC time zone indicator in format: YYYY-MM-DDTHH:MM:SS.ssZ. If not provided, current GMT date time will be used.
      cmn:TransactionIdentifier [1…*]
[0/*]		 String Required. The transaction identifier. More than one transaction id may be present.
        @type [1…1]
[1/*]		 String Required. The transaction identifier type supports the enumeration value PO.
        @date [0…1]
[0/*]		 DateTime The transaction identifier date attribute in YYYY-MM-DD format.
      cmn:NumberList [0…1]
[-]		 - Required. List of serial numbers for the items packed into the parent serial number.
        cmn:Serial [1…*]
[1/*]		 - Required. Serial number expressed in the GS1 Application Identifier format without parenthesis for the AI keys. AI(01)(21) formatted serial number for GTINs or AI(00) formatted serial number for SSCCs. Non-GS1 serial numbers (e.g. China) are expressed in native format.
            @companyPrefix [0…1]
[0/*]		 String Required. The GS1 Company Prefix present in GTIN-14 and SSCC serial numbers.
            @format [0…1]
[0/*]		 String

Required. The format of serial numbers.

See the Format enumeration list for valid values.
      cmn:EventLocation [0…1]
[0/34]		 String Required. Site-level SGLN of the location where the event occurs. SGLN format is the numeric component only, with the urn prefix stripped (e.g. 8888882.02867.0 instead of urn:epc:id:sgln:8888882.02867.0 typically found in EPCIS events).