International shipments outside the EU

Request parameters

Shipments outside the EU must have an <international> section under the <parcels> section

Node Type Length Description Mandatory?
<parcelType> Boolean n/a Is your parcel of the type Documents? Set it to true. Otherwise, false. Yes
<customsAmount> Long 99999 Defines the customs amount in total without decimal  separator (e.g. 14.000 = 14000). For documents it is 0. Yes
<customsCurrency> String 3 Currency code in ISO 4217 alpha-3 format Yes
<customsAmountEx> Long 99999 Defines the converted customs amount in total without decimal  separator (e.g. 14.000 = 14000). For documents it is 0. Yes
<customsCurrencyEx> String 3 Currency code in ISO 4217 alpha-3 format. Currency for conversion (destination country). Yes
<clearanceCleared> String 1

(N)o,

(F)ree,

(E)xport Cleared,

(T)ransit cleared,

(I)mport Cleared,

(H)ybrid.
Yes
<prealertStatus> String 3

S03 = Data captured by sending depot

S04 = Data are available for export gateway depots

S05 = Pre-alert provided (1st linehaul)

S06 = Return to sending depot by export gateway

S07 = Deactivated

S08 = HV import customs cleared

S09 = transit via road (T1)

S13 = Pre-alert provided (2nd linehaul)

S14 = Returned by import gateway (1st linehaul)

S15 = LV import customs cleared

S16 = Returns to sending country (2nd linehaul)
Yes
<exportReason> String 2

Reason for export :

01:sale

02:return/replacement

03:gift                                                                                                                                                      
Yes
<customsTerms> String 2

Declares the customs terms. Possible values are:

01  = DAP, cleared

02  = DDP, delivered duty paid (incl. duties and excl.

Taxes

03  = DDP, delivered duty paid (incl duties and taxes)

05  = ex works (EXW)

06 = DAP
Yes
<customsContent> String 35 Describes the content of the parcel. Yes
<customsPaper> String 20

Lists the accompanying documents. The values  are to be combined without separator (e.g. "ABG").

 Following values are defined:

A  = commercial invoice

B  = pro forma invoice

C  = export declaration

D = EUR1

E  = EUR2

F  = ATR

G  = delivery note

H  = third party billing

I = T1 document

No
<customsEnclosure> Boolean n/a Defines if the accompanying documents are at the  parcel or not. Default value is false.  
<customsInvoice> String 20 Defines the invoice number. Yes
<customsInvoiceDate> Int 99999 Defines the invoice date (format YYYYMMDD). Yes
<customsAmountParcel> Long 99999 Parcel value with two decimal places without  separator. No
<linehaul> String 2 Defines mode of line haul. Possible values are
AI  for air
RO for road.
No
<shipMrn> String 20 Movement reference number of the electronical  export declaration. No
<collectiveCustomsClearance> Boolean n/a Flag for determining collective customs clearance.  Default value is false No
<comment1> String 70 Comment about your shipment No
<comment2> String 70 Second comment about your shipment No
<commercialInvoiceConsigneeVatNumber> String 20 Defines the commercial invoice consignee VAT  number. No
<commercialInvoiceConsignee> See lower n/a Contains address data of commercial invoice  consignee. See <commercialInvoiceConsignee> section Yes
<commercialInvoiceConsignor> See lower n/a Contains address data of commercial invoice  consignor. See <commercialInvoiceConsignor> section Yes
<commercialInvoiceLine> See lower n/a Contains invoice line data No

 

Sample call

 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://dpd.com/common/service/types/Authentication/2.0" xmlns:ns1="http://dpd.com/common/service/types/ShipmentService/3.3">
   <soapenv:Header>
      <ns:authentication>
         <delisId>KD*****</delisId>
         <authToken>****</authToken>
         <messageLanguage>nl_NL</messageLanguage>
      </ns:authentication>
   </soapenv:Header>
   <soapenv:Body>
      <ns1:storeOrders>
         <printOptions>
            <printerLanguage>PDF</printerLanguage>
            <paperFormat>A6</paperFormat>
         </printOptions>
         <order>
            <generalShipmentData>
               <sendingDepot>0530</sendingDepot>
               <product>CL</product>
               <sender>
                  <name1>Sender NV</name1>
                  <name2>Jan Jansens</name2>
                  <street>Egide Walschaertsstraat 20</street>
                  <country>BE</country>
                  <zipCode>2800</zipCode>
                  <city>Mechelen</city>
                  <type>B</type>
               </sender>
               <recipient>
                  <name1>Russia Test</name1>
                  <street>Receiverstraat 5</street>
                  <country>RU</country>
                  <zipCode>111674</zipCode>
                  <city>Moscow</city>
                  <type>B</type>
               </recipient>
            </generalShipmentData>
            <parcels>
               <customerReferenceNumber1>Box 1234</customerReferenceNumber1>
               <weight>340</weight> <!-- Mandatory for non-EU shipments -->
               <!-- FOR SHIPMENTS TO NON-EU DESTINATIONS. -->
                <international>
                  <parcelType>false</parcelType> 
                  <customsAmount>1400</customsAmount> 
                  <customsCurrency>EUR</customsCurrency>
                  <customsAmountEx>1400</customsAmountEx> 
                  <customsCurrencyEx>EUR</customsCurrencyEx>
                  <clearanceCleared>F</clearanceCleared> 
                  <prealertStatus>S03</prealertStatus>
                  <exportReason>01</exportReason>
                  <customsTerms>01</customsTerms>
                  <customsContent>Paperclips</customsContent>                 
                  <customsInvoice>12345</customsInvoice>
                  <customsInvoiceDate>20190624</customsInvoiceDate>
                  <commercialInvoiceConsignee>
                     <name1>Russia Test</name1>
                      <street>Receiverstraat 5</street>
                      <country>RU</country>
                      <zipCode>111674</zipCode>
                      <city>Moscow</city>
                      <type>B</type>               
                  </commercialInvoiceConsignee>
                  <commercialInvoiceConsignor>
                     <name1>Sender NV</name1>
                       <name2>Jan Jansens</name2>
                       <street>Egide Walschaertsstraat 20</street>
                       <country>BE</country>
                      <zipCode>2800</zipCode>
                     <city>Mechelen</city>
                       <type>B</type>                          
                  </commercialInvoiceConsignor>          
               </international>

               <!-- CUSTOMS SEGMENT FOR NON-EU ENDS HERE -->
            </parcels>
            <productAndServiceData>
               <orderType>consignment</orderType>
            </productAndServiceData>
         </order>
      </ns1:storeOrders>
   </soapenv:Body>
</soapenv:Envelope>

Submitted by CustomerIT on Fri, 06/28/2019 - 14:10