DHL Parcel DE Private Shipping Virtual Sandbox

API for managing private shipping labels and shopping carts for DHL Parcel Germany.

The DHL Parcel DE Private Shipping API enables developers to integrate shipping label creation, shopping cart management, and QR code generation for DHL Parcel services within Germany. It supports the full lifecycle of a shipment, from catalog product selection to label retrieval and format customization.

Use this hosted sandbox to simulate DHL Parcel DE Private Shipping APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Use this sandbox to validate shipping label generation workflows, test shopping cart item structures, verify QR code data payloads, and handle label format variations for different shipment types before integrating with DHL production services.

DHL Parcel DE Private Shipping virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate DHL Parcel DE Private Shipping responses instantly.

`https://dhl-parcel-de-shipping.mock.beeceptor.com`

ProductCatalog(2 operations)

GET

/catalog/{version}/products

Returns available products on the marketplace according to the chosen version of the productcatalog. The version determines the point in time for which available products are requested.

Request Payload

Response Payload

{
  "defaultProduct": "RQ1Vem",
  "pickups": {},
  "products": {},
  "services": {}
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

GET

/catalog/{version}/countries

Returns a list of country codes associated to information about the country

Request Payload

Response Payload

{
  "countries": {}
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

Purchases(2 operations)

POST

/shopping-carts/pre-paid

Posting a shopping cart on the prepaid endpoint will create a new resource on the server side and will return a complete configured `ShoppingCart` Template. This shopping cart contains an entryURL, pointing to a page on the DHL Online Franking application, which shows the contents of the posted sho

Request Payload

{
  "shoppingcart": {
    "confirmation": {
      "email": "noreply@dhl.com",
      "notifyUrl": "https://www.dhl.de"
    },
    "items": [
      {
        "address": {
          "receiver": {
            "city": "Bonn",
            "country": "DEU",
            "email": "noreply@dhl.com",
            "name2": "Selma Sender",
            "plz": "53113",
            "street": "Sträßchensweg",
            "streetNumber": "1-5"
          },
          "sender": {
            "city": "Bonn",
            "country": "DEU",
            "email": "noreply@dhl.com",
            "name2": "Selma Sender",
            "plz": "53113",
            "street": "Sträßchensweg",
            "streetNumber": "1-5"
          }
        },
        "product": {
          "id": "PAK10.NNAHME"
        },
        "services": {
          "NNAHME": {
            "bic": "TESTDETT000",
            "currency": "EUR",
            "iban": "DEXXXXXXXXXXXXXXXXXXXX",
            "nnamount": "12.00",
            "owner": "Tester",
            "usage": "Test"
          }
        },
        "type": "ShipmentItem"
      }
    ]
  }
}

Response Payload

{
  "shoppingcart": {
    "state": "PREPAID",
    "download": {
      "entryUrl": "https://www.dhl.de/send-parcel/gw/rest/init?token=XXX"
    },
    "confirmation": {
      "notifyUrl": "https://www.dhl.de",
      "email": "noreply@dhl.com"
    },
    "items": [
      {
        "address": {
          "sender": {
            "name2": "Selma Sender",
            "street": "Sträßchensweg",
            "streetNumber": "1-5",
            "plz": "53113",
            "city": "Bonn",
            "country": "DEU",
            "email": "noreply@dhl.com"
          },
          "receiver": {
            "name2": "Selma Sender",
            "street": "Sträßchensweg",
            "streetNumber": "1-5",
            "plz": "53113",
            "city": "Bonn",
            "country": "DEU",
            "email": "noreply@dhl.com"
          }
        },
        "product": {
          "id": "PAK10.NNAHME"
        },
        "state": "PREPAID",
        "position": 0,
        "services": {
          "NNAHME": {
            "currency": "EUR",
            "owner": "Tester",
            "bic": "TESTDETT000",
            "iban": "DEXXXXXXXXXXXXXXXXXXXX",
            "nnamount": "12.00",
            "usage": "Test"
          }
        },
        "prices": [
          {
            "amount": "10.10",
            "tax": "19.00",
            "vat": "1.61",
            "currency": "EUR",
            "id": "PAK10"
          },
          {
            "amount": "6.90",
            "tax": "19.00",
            "vat": "1.10",
            "currency": "EUR",
            "id": "NNAHME"
          }
        ]
      }
    ]
  }
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

GET

/shopping-carts/{shoppingCartId}

Loads a created shoppingcart including all items and services.

Request Payload

Response Payload

{
  "shoppingcart": {
    "confirmation": {
      "acceptAgb": false,
      "acceptAtb": true,
      "email": "bvNdGSOCPO7m02l@TzXCAgP.supz",
      "notifyUrl": "https://www.dhl.de"
    },
    "download": {
      "entryUrl": "https://www.dhl.de/int-versenden/gw/rest/init?token=XXX"
    },
    "invoice": {
      "invoice": {
        "addressAddition1": "",
        "addressAddition2": "esse",
        "city": "McCulloughshire",
        "country": "RUS",
        "email": "Reba.Hammes@hotmail.com",
        "name1": "Miss",
        "name2": "Mack Hodkiewicz",
        "name3": "quis aute consectetur i",
        "phone": "+18803716174",
        "plz": "26200",
        "province": "Nordrhein-Westfalen",
        "street": "S Division Street",
        "streetNumber": "26944",
        "type": "Duis exercitation ex"
      },
      "invoiceNumber": "DOF-XXX-XXX"
    },
    "items": [
      {
        "type": "magna ex velit ipsum pariatur"
      },
      {
        "type": "tempor aliqua"
      },
      {
        "type": "laborum est occaecat"
      },
      {
        "type": "cupidatat ad dolore commodo"
      }
    ],
    "lang": "de",
    "owner": "tempor ad",
    "payment": {
      "provider": "caas"
    },
    "shoppingCartId": "tempor adipi",
    "state": "RESERVED"
  }
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

Missing schema or example in the OpenAPI spec.
Update the definition and recreate the mock server.

Label Access(6 operations)

GET

/labels/{pakId}

Gets the label pdf or wallet file by PAKID

Query Parameter Name	Example
`withMopsValue`	`false`

Header Name	Example
`accept`*	`"application/vnd.apple.pkpass"`

Request Payload

Response Payload

{
  "label": {
    "file": "nostrud reprehenderit dolor pariatur elit",
    "name": "ut commodo dolore ut",
    "numberOfPages": -60581977,
    "pakId": "anim id",
    "type": "est occaecat anim"
  },
  "mopsValue": "non culpa sunt incididunt elit"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

GET

/labels/{shipmentNumber}

Gets the label pdf or wallet file by a shipment number

Query Parameter Name	Example
`withMopsValue`	`false`

Header Name	Example
`accept`*	`"application/vnd.apple.pkpass"`

Request Payload

Response Payload

{
  "label": {
    "file": "sint magna",
    "name": "nulla qui cillum sed",
    "numberOfPages": 20707134,
    "pakId": "consectetur amet commodo in",
    "type": "tempor voluptate in reprehenderit mollit"
  },
  "mopsValue": "qui"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

GET

/labels/{pakId}/qr-code

Gets the MOSEL/MOPS QR-Code for mobile printing services by PAKID

Header Name	Example
`accept`*	`"image/png"`

Request Payload

Response Payload

{
  "qrcode": {
    "file": "aute",
    "name": "Ut in",
    "numberOfPages": 1457404,
    "pakId": "amet",
    "type": "ut"
  }
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

GET

/labels/{shipmentNumber}/qr-code

Gets the MOSEL/MOPS QR-Code for mobile printing services by shipment number

Header Name	Example
`accept`*	`"text/plain"`

Request Payload

Response Payload

{
  "qrcode": {
    "file": "aliqua occaecat",
    "name": "eiusmod Lorem sint adipisicing",
    "numberOfPages": -86187520,
    "pakId": "Lorem tempor irure",
    "type": "id cillum"
  }
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

GET

/labels/{pakId}/{labelFormat}

Gets the label for the shoppingcart by PAKID

Query Parameter Name	Example
`withMopsValue`	`true`

Header Name	Example
`accept`*	`"application/pdf"`

Request Payload

Response Payload

{
  "label": {
    "file": "ipsum voluptate Duis sit nostrud",
    "name": "elit dolore nisi",
    "numberOfPages": -4586224,
    "pakId": "ut exercitation Excepteur est quis",
    "type": "enim Ut in veniam"
  },
  "mopsValue": "enim Excepteur id"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

GET

/labels/{shipmentNumber}/{labelFormat}

Gets the label for the shoppingcart by shipment number

Query Parameter Name	Example
`withMopsValue`	`true`

Header Name	Example
`accept`*	`"application/pdf"`

Request Payload

Response Payload

{
  "label": {
    "file": "Ut nostrud incididunt sint",
    "name": "aute officia consequat tempor",
    "numberOfPages": -90902887,
    "pakId": "fugiat Lorem ad dolor",
    "type": "nostrud cillum voluptate Ut velit"
  },
  "mopsValue": "fugiat sit"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

{
  "code": "Example Error Code",
  "detail": "Error Details"
}

Service Homepage: developer.dhl.com/api-reference/dhl-parcel-de-private-shipping-post-parcel-germany#reference-docs-section

dhlshippinglogisticsgermanyparcel