Skip to main content

📦 GS1 XML Despatch Advice – Brief Explanation

This XML document conforms to the GS1 Despatch Advice standard (urn:gs1:ecom:despatch_advice:xsd:3) and is used to communicate shipment details from a sender (shipper) to a receiver (warehouse or store). It provides a structured overview of what has been shipped, in what quantities, and how items are packaged.

🧾 Header Information​

  • <entityIdentification>: Unique shipment or delivery note ID.
  • <note>: Optional comment from the supplier or warehouse.

🏬 Receiver Details​

  • <gln>: Global Location Number of the receiver (optional).
  • <additionalPartyIdentification type="businessUnitId">: Internal business unit identifier of the receiver.

🚚 Shipper Details​

  • <gln>: Shipper’s GLN (optional).
  • <additionalPartyIdentification>: Contains business unit ID and business partner ID.
  • <organisationName>: Name of the shipping organization.

🕒 Despatch Information​

  • <estimatedDeliveryDateTime>: Expected delivery timestamp in ISO 8601 format.

📦 Logistic Units (<despatchAdviceLogisticUnit>)​

Each logistic unit represents a container or packaging unit.

  • <sscc>: Unique identifier for the logistic unit (Serial Shipping Container Code).
  • <parentLogisticUnitId>: (Optional) Reference to a parent container, if nested.

📋 Line Items (<despatchAdviceLineItem>)​

Each logistic unit contains one or more line items:

  • <lineItemNumber>: Sequence number of the line.
  • <despatchedQuantity>: Quantity of items shipped.

🧾 Trade Item Details​

  • <gtin>: Global Trade Item Number (optional).
  • <additionalTradeItemIdentification type="itemId">: Local item ID.
  • <transactionalItemData>:
    • <serialNumber>: List of serial numbers (if serialized).
    • <batchNumber>: Batch or lot number.
    • <bestBeforeDate>: Product's best before date.
    • <itemExpirationDate>: Product's expiration date.

🛒 Purchase Order​

  • <entityIdentification>: Purchase order number.
  • <lineItemNumber>: Line number on the purchase order.
  • <totalLineAmount currencyCode="EUR">: Monetary value of the line item.

👤 Customer (Optional)​

  • <additionalPartyIdentification type="customerId">: Internal customer identifier (if applicable).

🔁 Structure Overview​

DespatchAdviceMessage
└─ despatchAdvice  
   ├─ despatchAdviceIdentification  
   ├─ note  
   ├─ receiver  
   ├─ shipper  
   ├─ despatchInformation  
   └─ despatchAdviceLogisticUnit (1..n)  
      ├─ logisticUnitIdentification  
      ├─ parentLogisticUnitId (optional)  
      └─ despatchAdviceLineItem (1..n)  
         ├─ lineItemNumber  
         ├─ despatchedQuantity  
         ├─ transactionalTradeItem  
         ├─ purchaseOrder  
         ├─ totalLineAmount  
         └─ customer (optional)

Return