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

# Create a Mixed Order

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

## Request

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

Creates a new mixed order based on the given data.

## Path parameters

- `customerEkp` string, required

## Headers

- `Authorization` string, required

## Request body

- MixedBagOrderDTO
  - `orderId` integer
  - `customerEkp` string
  - `awbId` string: Either the AWB is generated, or sent by the customer.
  - `format` string: The format of package. Everytime MIXED.
  - `contactName` string, required: Contact name for paperwork.
  - `telephoneNumber` string: Telephone number for paperwork. Mandatory for sales channel EXPRESS.
  - `jobReference` string: Job reference for the whole shipment.
  - `product` string, required: Product code.
  - `serviceLevel` string, required: The service level of the order: PRIORITY
  - `itemsCount` integer, required: Number of items in bag. Minimum 1.
  - `itemsWeightInKilogram` number, required: The weight in kilogram of the bag.
  - `totalCountReceptacles` integer, required: Number of airway bills.
  - `authUser` string

## Response `200`

Data of created mixed order.

- BulkOrderDto
  - `id` integer
  - `contactName` string
  - `phoneNumber` string
  - `jobReference` string
  - `productType` 'GM_PACKET_PLUS' | 'GM_PACKET_PRIO' | 'GM_PACKET_STANDARD' | 'GM_MAIL_STANDARD' | 'GM_MAIL_PRIO' | 'GM_MAIL_REG' | 'GM_PACKET_TRACKED' | 'EXPRESS_PACKET_PLUS' | 'EXPRESS_PACKET_PRIO' | 'EXPRESS_LETTER_PLUS' | 'EXPRESS_LETTER_PRIO' | 'EXPRESS_PACKET_TRACKED'
  - `bulkOrderType` 'STANDARD' | 'MIXED'
  - `awb` string
  - `bulkBags` BulkBagDto[]
    - `id` integer
    - `countryCode` string
    - `customerBagId` string
    - `packetFormat` 'P' | 'G' | 'E' | 'MIXED' | 'P_BAG' | 'G_BAG' | 'E_BAG' | 'P_PALLET' | 'G_PALLET' | 'E_PALLET'
    - `itemCount` integer
    - `totalWeight` number
    - `validationErrors` object
    - `customerReference` string
    - `shipmentType` string
    - `bagTracking` boolean
    - `authUser` string
    - `printed` boolean
    - `uiRowSelected` boolean
    - `number` integer
    - `items` BagItemDto[]
      - `id` integer
      - `barcode` string
      - `customerEkp` string
      - `awb` string
      - `destinationCountry` Country
        - `code` string, required
        - `languages` Language[]
          - `code` string, required
      - `destinationEmail` string
      - `destinationPhone` string
      - `destinationPhone2` string
      - `format` 'P' | 'G' | 'E' | 'MIXED' | 'P_BAG' | 'G_BAG' | 'E_BAG' | 'P_PALLET' | 'G_PALLET' | 'E_PALLET'
      - `itemWeight` integer
      - `bagId` string: In requests only applicable for customers using "prelabelled service"
      - `productType` 'GM_PACKET_PLUS' | 'GM_PACKET_PRIO' | 'GM_PACKET_STANDARD' | 'GM_MAIL_STANDARD' | 'GM_MAIL_PRIO' | 'GM_MAIL_REG' | 'GM_PACKET_TRACKED' | 'EXPRESS_PACKET_PLUS' | 'EXPRESS_PACKET_PRIO' | 'EXPRESS_LETTER_PLUS' | 'EXPRESS_LETTER_PRIO' | 'EXPRESS_PACKET_TRACKED'
      - `product` 'GM_PACKET_PLUS' | 'GM_PACKET' | 'GM_MAIL' | 'GM_PACKET_TRACKED' | 'EXPRESS_PACKET_PLUS' | 'EXPRESS_PACKET_PRIO' | 'EXPRESS_LETTER_PLUS' | 'EXPRESS_LETTER_PRIO' | 'EXPRESS_PACKET_TRACKED'
      - `serviceLevel` 'STANDARD' | 'PRIORITY' | 'REGISTERED'
      - `name` string
      - `customerReference` string
      - `recipientPhone` string
      - `recipientEmail` string
      - `addressLine1` string
      - `addressLine2` string
      - `addressLine3` string
      - `city` string
      - `destinationState` string
      - `postalCode` string
      - `currency` string
      - `contentType` string
      - `declaredContentAmount` integer
      - `detailedContentDescriptions1` string
      - `totalValue` integer
      - `returnLabel` boolean
      - `senderCustomsReference` string
      - `importerCustomsReference` string
      - `checked` boolean
      - `bagItemContents` BagItemContentDto[]
        - `amount` string
        - `description` string
        - `value` string
        - `hsCode` string
        - `netWeight` string
        - `originCountry` string
    - `linkedItemCount` integer
    - `weightPerItem` number
  - `status` 'EDITING' | 'SAVED' | 'LOCKED' | 'SUBMITTED' | 'UNBAGGED'
  - `validationErrors` boolean
  - `errorMessage` string
  - `numberOfCopies` integer
  - `downloadToken` string
  - `printable` boolean
  - `orderClassification` 'BAG' | 'BULK' | 'BAG_AND_BULK'
  - `createdAt` string, date-time
  - `createdBy` string
  - `authUser` string
  - `sendDate` string, date-time
  - `submittedDate` string, date-time
  - `preadviceEligible` boolean
  - `finalised` boolean
  - `totalItemWeightSum` number

## 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)
