Mark shipments as being ready for shipping
Shipments are normally ''closed out'' at a fixed time of the day (such as 6 pm, configured by EKP/account) for the date provided as shipDate in the create call. <br />This call allows forcing the closeout for sets of shipments earlier. This will also override the original shipDate. Afterwards, the shipment cannot be changed and the shipment labels cannot be queried anymore (however they may remain cached for limited duration). Once a shipment has been closed, then calling closeout for the same shipment will result in a warning. The same warning will also be returned if the automatic closeout happened prior to the call. It is however possible to add new shipments, they will be manifested as well and be part of the day's manifest. <br />Note on billing: The manifesting step has billing implications. Some products (Parcel International partially) are billed based on the shipment data available to DHL at the end of the day. All other products (including DHL Paket Standard) are billed based on production data. For more details, please contact your account representative.
Request
It's changing the status of the shipment, so parameters are provided in the body or as query parameter.
- ''profile'' attribute (request body parameter) - defines the user group profile. A user group is permitted to specific billing numbers. Shipments are only closed out if they belong to a billing number that the user group profile is entitled to use. This attribute is mandatory. Please use the standard user group profile ''STANDARD_GRUPPENPROFIL'' if no dedicated user group profile is available.
- ''billingNumber'' attribute (query parameter) - defines the billing number for which shipments shall be closed out. If a billing number is set, then only the shipments of that billing number are closed out. In that case no list of specific shipment numbers needs to be passed.
- ''shipmentNumbers'' attribute (request body parameter) - lists the specific shipping numbers of the shipments that shall be closed out. If all shipments shall be closed, the query parameter ''all'' needs to be set to ''true''. In that case neither a billing number nor a list of shipment numbers need to be passed in the request.
Response
- Closing status for each shipment
Request
- Base URLhttps://api-eu.dhl.com/parcel/de/shipping/v2
- Auth
- API key in header dhl-api-key
- or HTTP basic
- or OAuth 2PasswordToken URL: /parcel/de/account/auth/ropc/v1/token
Query parameters
Specify if all applicable shipments shall be marked as being ready for shipping.
Headers
Control the APIs response language via locale abbreviation. English (en-US) and german (de-DE) are supported. If not specified, the default is english.
Request body
Response
Response for manifesting request taking multiple input elements
Example response
{
"status": {
"title": "ok",
"statusCode": 200,
"status": 200,
"detail": "The Webservice call ran successfully."
},
"items": [
{
"shipmentNo": "340434310428091700",
"sstatus": {
"title": "ok",
"statusCode": 200,
"status": 200,
"detail": "The Webservice call ran successfully."
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.