Connect API documentation

Use the Connect APIs to create bookings, request barcode labels, retrieve freight lists, generate waybills, and retrieve shipment tracking details through SOAP-based integration. Start with General Information to understand setup, access, environments, and WSDL links, then choose the API you want to integrate with and use the sample XML together with the field specifications to build and validate your request.


Waybill API

Use this section to retrieve a waybill document for an existing booking. Start with the sample XML request and response, then validate the required fields using the schema table.

Tip: The waybill document is returned as encoded document content and should be handled by the client application after a successful response.

Waybill sample XML request

Operation: getWaybillRequest

Use this sample when retrieving a waybill document for an existing booking. Replace the access key, request ID, and booking ID before testing.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.dbschenker.com/booking/v1">
  <soapenv:Header/>
  <soapenv:Body>
    <v1:getWaybillRequest>
      <in>
        <applicationArea>
          <accessKey>YOUR_ACCESS_KEY</accessKey>
          <requestID>REQ-WAYBILL-001</requestID>
          <!-- Optional: provide either groupId or groupName when required for your setup -->
          <!-- <groupId>123456</groupId> -->
          <!-- <groupName>YOUR_GROUP_NAME</groupName> -->
        </applicationArea>
        <bookingId>1234567890123</bookingId>
      </in>
    </v1:getWaybillRequest>
  </soapenv:Body>
</soapenv:Envelope>

Waybill sample XML response

Operation: getWaybillResponse

Use this response sample to understand the expected document payload. The document value is returned as Base64 content.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.dbschenker.com/booking/v1">
  <soapenv:Header/>
  <soapenv:Body>
    <v1:getWaybillResponse>
      <out>
        <applicationArea>
          <requestID>REQ-WAYBILL-001</requestID>
        </applicationArea>
        <document>BASE64_ENCODED_WAYBILL_DOCUMENT</document>
      </out>
    </v1:getWaybillResponse>
  </soapenv:Body>
</soapenv:Envelope>

getWaybillRequest

SOAP request schema for Waybill API.

Request 7 fields
Field NameData TypeMandatoryCardinalityDescription
<applicationArea> applicationAreaType yes 1..1
<accessKey>?</accessKey> string(100) yes 1..1 Defines the access key (user token).
<groupId>?</groupId> unsignedLong no 0..1 Defines the optional user group id.
<requestID>?</requestID> string(500) no 0..1 Defines the request id which will be returned with the response message.
<userId>?</userId> string no 0..1 Defines the user id for which the booking should be done.
<groupName>?</groupName> string no 0..1 Defines the user group name for which the booking should be done.
<bookingId>?</bookingId> string(13) yes 1..1 Defines the booking id.