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": "6Bgloy",
  "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": "8p0RMWLv@KUqnNXHGGCIuUiijgmGOmWh.eja",
      "notifyUrl": "https://www.dhl.de"
    },
    "download": {
      "entryUrl": "https://www.dhl.de/int-versenden/gw/rest/init?token=XXX"
    },
    "invoice": {
      "invoice": {
        "addressAddition1": "ame",
        "addressAddition2": "nostrud Ut",
        "city": "Padbergboro",
        "country": "ARG",
        "email": "Adeline_Weimann@gmail.com",
        "name1": "Dr.",
        "name2": "Jackie Mosciski",
        "name3": "dolor",
        "phone": "+13362507146",
        "plz": "29004-5664",
        "province": "Nordrhein-Westfalen",
        "street": "E Cedar Street",
        "streetNumber": "559",
        "type": "Duis magna commodo est"
      },
      "invoiceNumber": "DOF-XXX-XXX"
    },
    "items": [
      {
        "type": "eiusmod laboris irure tempor dolor"
      },
      {
        "type": "aliqua amet"
      },
      {
        "type": "enim ea consectetur"
      },
      {
        "type": "quis qui eu irure est"
      },
      {
        "type": "non ut"
      }
    ],
    "lang": "de",
    "owner": "amet Duis ea consequat Excepteur",
    "payment": {
      "provider": "dummypay"
    },
    "shoppingCartId": "proident ad ",
    "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/json"`

Request Payload

Response Payload

{
  "label": {
    "file": "dolore elit dolor Lorem",
    "name": "nostrud id ut aliquip",
    "numberOfPages": -17282603,
    "pakId": "dolore voluptate magna",
    "type": "culpa laboris"
  },
  "mopsValue": "incididunt"
}

{
  "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`	`true`

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

Request Payload

Response Payload

{
  "label": {
    "file": "sit id",
    "name": "dolor occaecat irure",
    "numberOfPages": 93377396,
    "pakId": "cillum consectetur ut ad",
    "type": "fugiat ullamco"
  },
  "mopsValue": "dolor qui veniam mollit"
}

{
  "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": "Lorem mollit dolore nulla ea",
    "name": "sed eu dolor deserunt qui",
    "numberOfPages": -42662168,
    "pakId": "aliquip anim culpa laborum do",
    "type": "dolore et magna est 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"
}

{
  "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": "sit",
    "name": "et minim tempor deserunt",
    "numberOfPages": 28187858,
    "pakId": "nostrud",
    "type": "magna et consequat quis"
  }
}

{
  "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`	`false`

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

Request Payload

Response Payload

{
  "label": {
    "file": "quis Ut est",
    "name": "culpa non dolore in",
    "numberOfPages": -61096555,
    "pakId": "non enim fugiat amet",
    "type": "anim enim non exercitation"
  },
  "mopsValue": "deserunt enim Duis"
}

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

Request Payload

Response Payload

{
  "label": {
    "file": "nostrud pariatur consequat ut",
    "name": "enim",
    "numberOfPages": -9514468,
    "pakId": "amet velit",
    "type": "incididunt exercitation magna"
  },
  "mopsValue": "ea sed aliquip eiusmod et"
}

{
  "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