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.
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.
| Field Name | Data Type | Mandatory | Cardinality | Description |
|---|---|---|---|---|
<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. |