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": "UQwO6V",
  "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": true,
      "acceptAtb": true,
      "email": "8nF5j@CPSSFEVGFmIJdkaTNZ.qt",
      "notifyUrl": "https://www.dhl.de"
    },
    "download": {
      "entryUrl": "https://www.dhl.de/int-versenden/gw/rest/init?token=XXX"
    },
    "invoice": {
      "invoice": {
        "addressAddition1": "et",
        "addressAddition2": "in",
        "city": "West Demetrisview",
        "country": "ROU",
        "email": "Austen_Bradtke37@hotmail.com",
        "name1": "Ms.",
        "name2": "Tammy Fahey",
        "name3": "minim ",
        "phone": "+19322253271",
        "plz": "35349",
        "province": "Nordrhein-Westfalen",
        "street": "Schulist Port",
        "streetNumber": "6954",
        "type": "tempor ad"
      },
      "invoiceNumber": "DOF-XXX-XXX"
    },
    "items": [
      {
        "type": "sed consectetur et incididunt sit"
      },
      {
        "type": "esse sunt aute irure ut"
      },
      {
        "type": "in"
      },
      {
        "type": "velit tempor fugiat ex"
      },
      {
        "type": "consequat"
      }
    ],
    "lang": "de",
    "owner": "in voluptate",
    "payment": {
      "provider": "caas"
    },
    "shoppingCartId": "eiusmod dolo",
    "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`	`true`

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

Request Payload

Response Payload

{
  "label": {
    "file": "cupidatat ex ea proident eu",
    "name": "fugiat ad est non",
    "numberOfPages": -50839661,
    "pakId": "do occaecat",
    "type": "do"
  },
  "mopsValue": "occaecat"
}

{
  "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/pdf"`

Request Payload

Response Payload

{
  "label": {
    "file": "cillum Ut proident commodo",
    "name": "ullamco culpa",
    "numberOfPages": 37551986,
    "pakId": "nisi ipsum",
    "type": "Excepteur proident non irure laborum"
  },
  "mopsValue": "fugiat aliqua"
}

{
  "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": "incididunt labore ut dolor non",
    "name": "qui",
    "numberOfPages": 6400285,
    "pakId": "occaecat minim",
    "type": "Duis ex"
  }
}

{
  "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`*	`"image/png"`

Request Payload

Response Payload

{
  "qrcode": {
    "file": "voluptate cillum ipsum",
    "name": "reprehenderit do minim est anim",
    "numberOfPages": -88819613,
    "pakId": "qui dolor commodo",
    "type": "proident in"
  }
}

{
  "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": "sint cupidatat in eiusmod",
    "name": "eu",
    "numberOfPages": -1911315,
    "pakId": "ad ipsum fugiat exercitation",
    "type": "et"
  },
  "mopsValue": "aliquip reprehenderit"
}

{
  "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": "nostrud",
    "name": "cillum ad consequat anim in",
    "numberOfPages": 65141502,
    "pakId": "proident Lorem cupidatat",
    "type": "Duis incididunt ullamco"
  },
  "mopsValue": "adipisicing 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"
}

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

dhlshippinglogisticsgermanyparcel