What is GS1
The GS1 XML format you provided is based on the GS1 eCom Despatch Advice Message, which is part of the GS1 EDI (Electronic Data Interchange) standards used globally in supply chains for automated, structured, and interoperable business messaging between trading partners. More information about GS1 fields can be found here GS1 Fields detailed explanation
π¦ GS1 Payload Structureβ
Below are the key components expected in the payload:
π§Ύ Header
despatchAdviceIdentification
- entityIdentification: Unique delivery note ID
note: Optional note
receiver
gln: Receiver storeβs GLN (optional if businessUnitId is specified)
additionalPartyIdentification[type=businessUnitId]: Preferred receiver identification
shipper
gln: Optional shipper ID (used if it's another store)
additionalPartyIdentification[type=businessPartnerId]: Required if shipper is a warehouse or supplier
additionalPartyIdentification[type=businessUnitId]: Preferred if shipper is another store
organisationDetails
- organisationName: Optional name
despatchInformation
- estimatedDeliveryDateTime: Expected delivery time
π¦ Containers (Logistic Units)β
One or more despatchAdviceLogisticUnit blocks
Each unit includes:
sscc: Unique container ID
parentLogisticUnitId (optional): For nested containers
π Line Itemsβ
One or more despatchAdviceLineItem blocks
Each line includes:
lineItemNumber
despatchedQuantity
transactionalTradeItem
- gtin or itemId (via additionalTradeItemIdentification)
transactionalItemData
batchNumber, bestBeforeDate, itemExpirationDate (optional)
serialNumber (optional, can appear multiple times)
purchaseOrder
entityIdentification: Order ID
lineItemNumber: Purchase order line ID (optional)
totalLineAmount[currencyCode]: Required amount per line
customer
- additionalPartyIdentification[type=customerId]: Required if item is reserved for a customer
π Notesβ
Container hierarchy (parent-child) is supported but optional.
Itβs also possible to have:
Only lines without containers
A single container with multiple item lines
Nested containers with multiple lines inside