Not logged in - Login
View History

Shipment Service SOAP Example

Shipment request

The Shipment service is a soap service. Here a minimal example of a shipment request. On the main page under Possible products multiple examples can be found.

<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.1">
   <soapenv:Header>
      <ns:authentication>
         <delisId>My Delis ID</delisId>
         <authToken>Authantication code</authToken>
         <messageLanguage>nl_NL</messageLanguage>
      </ns:authentication>
   </soapenv:Header>
   <soapenv:Body>
      <ns1:storeOrders>
         <ns1:printOptions>
            <printerLanguage>PDF</printerLanguage>
            <paperFormat>A6</paperFormat>
         </ns1:printOptions>
         <ns1:order>
            <generalShipmentData>
               <sendingDepot>0522</sendingDepot>
               <product>CL</product>
               <sender>
                  <name1>CustomerIT</name1>
                  <street>Tormentil</street>
                  <houseNo>10</houseNo>
                  <country>NL</country>
                  <zipCode>5684PK</zipCode>
                  <city>Best</city>
               </sender>
               <recipient>
                  <name1>Receiver</name1>
                  <street>streetname</street>
                  <houseNo>123</houseNo>
                  <country>NL</country>
                  <zipCode>5684PK</zipCode>
                  <city>Best</city>
               </recipient>
            </generalShipmentData>
            <parcels>
                   <customerReferenceNumber1>CustRef1</customerReferenceNumber1>
               <weight>360</weight>
            </parcels>
            <productAndServiceData>
               <orderType>consignment</orderType>
            </productAndServiceData>
         </ns1:order>
      </ns1:storeOrders>
   </soapenv:Body>
</soapenv:Envelope>

Shipment response

If a request is send with a valid delisId and password this will be the response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <storeOrdersResponse xmlns="http://dpd.com/common/service/types/ShipmentService/3.1">
         <orderResult xmlns="">
            <parcellabelsPDF>Parcel label string</parcellabelsPDF>
            <shipmentResponses>
               <identificationNumber/>
               <mpsId>MPS0517800000011020160602</mpsId>
               <parcelInformation>
                  <parcelLabelNumber>05178000000110</parcelLabelNumber>
               </parcelInformation>
            </shipmentResponses>
         </orderResult>
      </storeOrdersResponse>
   </s:Body>
</s:Envelope>

Shipment error response

If the authentication thoken is used longer than 24 hours. Example:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <s:Fault>
         <faultcode>s:SERVER FAULT</faultcode>
         <faultstring>Fault occured</faultstring>
         <detail>
            <authenticationFault xmlns="http://dpd.com/common/service/types/Authentication/2.0" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
               <errorCode>LOGIN_7</errorCode>
               <errorMessage>De client sessie is verlopen</errorMessage>
            </authenticationFault>
         </detail>
      </s:Fault>
   </s:Body>
</s:Envelope>