---
title: "Create a Bulk Order"
method: POST
path: "/dpi/shipping/v1/bulk/{customerEkp}/orders"
tags: ["Bulk Orders"]
---

# Create a Bulk Order

`POST /dpi/shipping/v1/bulk/{customerEkp}/orders`

## Request

- Base URL: `https://api-sandbox.dhl.com`
- URL: `https://api-sandbox.dhl.com/dpi/shipping/v1/bulk/{customerEkp}/orders`
- Auth: none declared. Required headers: `Authorization`

Creates a new bulk order based on the given data

## Path parameters

- `customerEkp` integer, required

## Headers

- `Authorization` string, required

## Request body

- BagOrder
  - `bags` Bag[]: The bags associated with this order.
    - `id` integer: Internal id of the bag.
    - `bagTrack` boolean, required: False for bulk preadvice, True for bag tracking
    - `format` string, required: The format of the content of this bag.
    - `destinationCountry` string, required: The destination country code.
    - `itemsCount` integer, required: Number of items in bag. Minimum 1.
    - `itemsWeightInKilogram` number, required: The weight in kilogram of the bag.
    - `customerReference` string: Customer reference
  - `paperwork` BagPaperwork, required
    - `contactName` string, required: Contact name for paperwork.
    - `telephoneNumber` string: Telephone number for paperwork. Mandatory for sales channel EXPRESS.
    - `jobReference` string: Job reference for paperwork.
    - `product` 'GMM', required: Product code.
    - `serviceLevel` string, required: The service level of the order: PRIORITY
    - `totalCountReceptacles` integer, required: Number of airway bills.
  - `customerEkp` integer
  - `awbId` integer
  - `netBulkWeightInKilogram` number
  - `orderId` integer
  - `orderStatus` 'OPEN' | 'FINALIZE'

## Response `200`

Data of created order.

- BagOrder
  - `bags` Bag[]: The bags associated with this order.
    - `id` integer: Internal id of the bag.
    - `bagTrack` boolean, required: False for bulk preadvice, True for bag tracking
    - `format` string, required: The format of the content of this bag.
    - `destinationCountry` string, required: The destination country code.
    - `itemsCount` integer, required: Number of items in bag. Minimum 1.
    - `itemsWeightInKilogram` number, required: The weight in kilogram of the bag.
    - `customerReference` string: Customer reference
  - `paperwork` BagPaperwork, required
    - `contactName` string, required: Contact name for paperwork.
    - `telephoneNumber` string: Telephone number for paperwork. Mandatory for sales channel EXPRESS.
    - `jobReference` string: Job reference for paperwork.
    - `product` 'GMM', required: Product code.
    - `serviceLevel` string, required: The service level of the order: PRIORITY
    - `totalCountReceptacles` integer, required: Number of airway bills.
  - `customerEkp` integer
  - `awbId` integer
  - `netBulkWeightInKilogram` number
  - `orderId` integer
  - `orderStatus` 'OPEN' | 'FINALIZE'

## Other responses

- `403`: User 'xxx' has no permission.
- `404`: There is no customer matching the given EKP.
- `422`: Data error, please check response message for details.
- `500`: Internal error.

---

[API](https://skmtc.dev/dhl/apis/deutsche-post-international-shipping-api.md) - [All operations](https://skmtc.dev/dhl/apis/deutsche-post-international-shipping-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dhl/apis/deutsche-post-international-shipping-api/revisions/33ba987e477f?raw)