Skip to content
This repository has been archived by the owner on Oct 21, 2021. It is now read-only.

xml_DespatchAdvice_Annotated

Josh Horton edited this page Jul 29, 2020 · 15 revisions
<?xml version="1.0" encoding="UTF-8"?>
<despatch_advice:despatchAdviceMessage
    xmlns:despatch_advice="urn:gs1:ecom:despatch_advice:xsd:3"
    xmlns:sh="http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:gs1:ecom:despatch_advice:xsd:3 ../Schemas/gs1/ecom/DespatchAdvice.xsd">
    <sh:StandardBusinessDocumentHeader>
        <sh:HeaderVersion>1.0</sh:HeaderVersion>
        <sh:Sender>
            <sh:Identifier Authority="GS1"/>
        </sh:Sender>
        <sh:Receiver>
            <sh:Identifier Authority="GS1"/>
        </sh:Receiver>
        <sh:DocumentIdentification>
            <sh:Standard>GS1</sh:Standard>
            <sh:TypeVersion>3.3</sh:TypeVersion>
            <sh:InstanceIdentifier>100002</sh:InstanceIdentifier>
            <sh:Type>despatchAdvice</sh:Type>
            <sh:MultipleType>false</sh:MultipleType>
            <sh:CreationDateAndTime>2011-04-11T14:58:56.591Z</sh:CreationDateAndTime>
        </sh:DocumentIdentification>
    </sh:StandardBusinessDocumentHeader>
    <!-- ********************************************************************************** -->
    <!-- NOTE : Comments for a field appear BELOW the field. -->
    <!-- This is a Despatch Advice (a.k.a. ASN - Advance Shipment Notification), submitted from a Supplier to a Retailer. -->
    <!-- Currently, the supplier sends a copy ("shadows") of the DA, in this format to the Blockchain. -->
    <!-- MANDATORY fields are indicated. -->
    <!-- ********************************************************************************** -->
    <despatchAdvice>
        <creationDateTime>2011-04-11T14:58:56.591Z</creationDateTime>
        <!-- OPTIONAL: DA creation time. -->
        <!-- UTC time (ISO 8601) when the PO was created. -->
        <documentStatusCode>ORIGINAL</documentStatusCode>
        <!-- Do not change. -->
        <despatchAdviceIdentification>
            <entityIdentification>urn:epcglobal:cbv:bt:5412345000037:3352-349875</entityIdentification>
            <!-- MANDATORY -->
            <!-- urn:epcglobal:cbv:bt:ShipToGLN:PONumber-ASNNumber -->
            <!-- Despatch Advice Number: The format for this is urn:epcglobal:cbv:bt:<gln>:<po-number>-<da-number> -->
            <!-- where <gln> is the "SHIP TO GLN FOR THE PO". <da-number> should NOT contain a ":" character.  -->
            <!-- IDEALLY, the da-number should be the ASN number, if the supplier is submitting an ASN to the retailer -->
            <!-- Using this notation allows a retailer to put in a reference to this DA (using the same format) -->
            <!-- from other EPCIS events and Business Txn documents (such as RA). -->
            <!-- Reference: https://www.gs1.org/sites/default/files/docs/epc/CBV-Standard-1-2-1-r-2017-05-05.pdf  [Section 8.5.2] -->
            <!-- IBM Food Trust Transaction ID format: urn:ibm:ift:bt:<Company Prefix>.<Location Reference>.<Transaction Id>-->
            <!-- where <Company Prefix>.<Location Reference> are for the "shipTo" location-->
            <contentOwner>
                <gln>4098765000010</gln>
                <!-- OPTIONAL: Shipper Corporate Identity GLN. -->
            </contentOwner>
        </despatchAdviceIdentification>
        <receiver>
            <gln>5412345000013</gln>
            <!-- MANDATORY: Retailer Corporate Identity GLN.  -->
        </receiver>
        <shipper>
            <gln>4098765000010</gln>
            <!-- MANDATORY: Seller/Shipper Corporate Identity GLN -->
        </shipper>
        <shipTo>
            <gln>5412345000037</gln>
            <!-- MANDATORY: This is the GLN of the Retailer DC. The GLN of the DC needs to be extracted from the PO. -->
        </shipTo>
        <shipFrom>
            <gln>4098765000010</gln>
            <!-- MANDATORY: Shipper Dispatch location GLN (factory). -->
        </shipFrom>
        <despatchInformation>
            <actualShipDateTime>2011-04-11T18:58:56.591Z</actualShipDateTime>
            <!-- OPTIONAL, since this is not necessarily available at time of DA creation. -->
        </despatchInformation>
        <!--NOTE: <despatchInformation>, </despatchInformation> tags should not be omitted even if no <actualShipDataTime>.-->
        <purchaseOrder>
            <entityIdentification>urn:epcglobal:cbv:bt:5412345000037:3352</entityIdentification>
            <!-- MANDATORY: <purchaseOrder> requires an <entityIdentification> -->
        </purchaseOrder>
        <!-- OPTIONAL -->
        <!-- Top-level PO identification. If needed, line-item level POs can override this. -->
        <!-- Either top-level PO or per-line-item level POs should be present. -->
        <despatchAdviceLogisticUnit>
            <!-- MANDATORY: A DA Logistic Unit is for each pallet. -->
            <packageTypeCode>PE</packageTypeCode>
            <!-- MANDATORY -->
            <!-- Code that indicates package type. -->
            <!-- Use Code Value from: http://apps.gs1.org/GDD/Pages/clDetails.aspx?semanticURN=urn:gs1:gdd:cl:PackageTypeCode&release=2 -->
            <!-- "PE"=pallet, modular -->
            <logisticUnitIdentification>
                <sscc>409876506700001010</sscc>
                <!-- MANDATORY: Pallet SSCC or IBM Food Trust logistic unit ID - EPC_SSCC, GS1_SSCC, FTLPN, or SSCC_LA - Refer to https://github.com/IBM/IFT-Developer-Zone/wiki/api-Error-Codes for formats -->
                <!-- General syntax for IBM Food Trust logistic unit: -->
                <!-- urn:ibm:ift:lpn:obj:<Company Prefix>.<Serial Reference> -->
            </logisticUnitIdentification>
            <despatchAdviceLineItem>
                <lineItemNumber>1</lineItemNumber>
                <!-- MANDATORY: This is the DA line item, which is a sequential number. -->
                <despatchedQuantity measurementUnitCode="KGM">48</despatchedQuantity>
                <!--MANDATORY -->
                <!--Two or three-character codes from UN/CEFACT Recommendation 20.-->
                <!--Examples: EA (each), LBR (pound), CS (case), KGM (kilogram).-->
                <!--See https://www.unece.org/fileadmin/DAM/cefact/recommendations/rec20/rec20_rev3_Annex2e.pdf and-->
                <!--https://www.unece.org/fileadmin/DAM/cefact/recommendations/rec20/rec20_rev3_Annex3e.pdf.-->
                <countryOfOrigin>840</countryOfOrigin>
                <!--MANDATORY: ISO 3166-1 numeric-3 code https://en.wikipedia.org/wiki/ISO_3166-1_numeric.-->
                <!--"840"=USA.-->
                <transactionalTradeItem>
                    <gtin>08712345678906</gtin>
                    <!-- MANDATORY -->
                </transactionalTradeItem>
                <requestedItemIdentification>
                    <gtin>40987650000223</gtin>
                    <!-- MANDATORY: This is what was requested in the PO. -->
                </requestedItemIdentification>
                <purchaseOrder>
                    <entityIdentification>urn:epcglobal:cbv:bt:5412345000037:3352</entityIdentification>
                    <!-- MANDATORY: <purchaseOrder> requires an <entityIdentification> -->
                    <lineItemNumber>5</lineItemNumber>
                    <!-- MANDATORY: This is the line item in the PO that this DA line item corresponds to. -->
                </purchaseOrder>
                <!-- OPTIONAL. Required for computing order-reconciliation metrics. -->
            </despatchAdviceLineItem>
        </despatchAdviceLogisticUnit>
    </despatchAdvice>
</despatch_advice:despatchAdviceMessage>
Clone this wiki locally