View DHL Services

DHL eCommerce Europe API Virtual Sandbox

Interface for managing shipment data, customs information, and label retrieval for DHL eCommerce Europe.

The DHL eCommerce Europe API (eConnect) provides developers with tools to send shipment data, retrieve shipping labels, and manage customs documentation. It supports various product formats, including Connect Light Mail and Connect Light Parcel, and offers event data tracking and label reprinting capabilities.

Use this hosted sandbox to simulate DHL eCommerce Europe API 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 shipment creation payloads, customs declaration structures for non-EU parcels, label generation responses, and event data integration flows before connecting to DHL production environments.

DHL eCommerce Europe API virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate DHL eCommerce Europe API responses instantly.

https://dhl-econnect.mock.beeceptor.com



Get Access Token

Request Payload
Response Payload
{
  "access_token": "3AiFEwHpiJccsYLFOpdr8yYudBLP",
  "token_type": "Bearer",
  "expires_in": 17999
}
{
  "status": 401,
  "title": "Unauthorized",
  "detail": "Unauthorized for given resource."
}

Send connectLight

Request Payload
{
  "dataElement": {
    "general": {
      "timestamp": "2026-01-01T12:00:00Z",
      "product": "connect.light.parcel",
      "customerIdentification": "5012345678"
    },
    "cPAN-light": {
      "addresses": {
        "sender": {
          "type": "default",
          "firstName": "Thomas",
          "name": "Test",
          "email": "test@test.de",
          "street": "Postbox",
          "streetNr": "2529",
          "postcode": "36243",
          "city": "Niederaula",
          "country": "DE"
        },
        "recipient": {
          "type": "doorstep",
          "firstName": "Tamara",
          "name": "Testempresa",
          "email": "Tamara@Testempresa.es",
          "street": "Testcalle",
          "streetNr": "10",
          "postcode": "28013",
          "city": "Madrid",
          "country": "ES"
        }
      },
      "features": {
        "simpleFeature": "untracked",
        "physical": {
          "grossWeight": "0.05",
          "format": "P"
        }
      }
    }
  }
}
Response Payload
{
  "response": {
    "status": "200",
    "timestamp": "2026-01-01T12:00:00",
    "customerId": "Test12345",
    "sessionId": "752328d4-2630-4a48-ac2b-a03b21b4de10",
    "statusCode": "OK",
    "statusMessage": "cPAN-goods has been processed successfully",
    "shipment": {
      "shipmentId": "NC891000870DE",
      "routingCode": "2LGR17563+72530000",
      "label": "JVBERi0xLjcKJfbk/N8KMjMgMCBvYmoKPDwKL1BhZ2VzIDI0IDAgUgovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoKMjUgMCBvYmoKPDwKL0F1dGhvciAoREhMIEdyb3VwKQo+PgplbmRvYmoKMjQgMCBvYmoKPDwKL0NvdW50IDEKL0tpZHMgWzI2IDAgUl0KL1R5cGUgL1BhZ2VzCj4+CmVuZG9iagoyNiAwIG9iago8PAovQ29udGVudHMgMjcgMCBSCi9NZWRpYUJveCBbMCAwIDI4My40NiA0MjUuMl0KL1BhcmVudCAyNCAwIFIKL1Jlc291cmNlcyA8PAovRXh0R1N0YXRlIDw8Ci9HczEgMjggMCBSCj4+Ci9Gb250IDw8Ci9GMSAyOSAwIFIKL0YyIDMwIDAgUgo{...}"
    }
  }
}
{
  "status": 401,
  "title": "Unauthorized",
  "detail": "Unauthorized for given resource."
}
{
  "status": 429,
  "title": "Too Many Requests",
  "detail": "Too many requests within defined time period,please try again later."
}
{
  "status": 500,
  "title": "Internal Server Error",
  "detail": "The server encountered an unexpected condition that prevented it from fulfilling the request."
}
{
  "reasons": [
    {
      "msg": "Service Unavailable"
    }
  ],
  "details": {
    "msgId": "Id-836a775dc794c71b0b5fd41c"
  }
}

Send aggregate

Request Payload
{
  "dataElement": {
    "labelDetails": {
      "label": true,
      "formatLabel": "pdf"
    },
    "general": {
      "product": "connect.light.container",
      "timestamp": "2026-01-01T12:00:00+02:00",
      "customerId": "5012345678"
    },
    "aggregate": {
      "scenario": "AWB",
      "physical": {
        "grossWeight": 10
      },
      "relations": {
        "hierarchy": {
          "reference": {
            "referenceId": [
              "UT0003DE",
              "UT0004DE",
              "UT0005DE"
            ]
          }
        }
      },
      "containerList": {
        "container": [
          {
            "relations": {
              "hierarchy": {
                "reference": [
                  {
                    "index": 1,
                    "total": 1
                  }
                ]
              }
            }
          }
        ]
      }
    }
  }
}
Response Payload
{
  "response": {
    "container": [
      {
        "containerId": "Duis et dolore qui",
        "label": "magna ut"
      },
      {
        "containerId": "aute exercitation Excepteur proident ipsum",
        "label": "nisi dolor velit labore"
      },
      {
        "containerId": "non nostrud commodo dolor",
        "label": "et adipisicing qui"
      },
      {
        "containerId": "sit esse minim labore",
        "label": "mollit est commodo"
      }
    ],
    "customerId": "aliquip cillum occaecat",
    "sessionId": "enim dolore",
    "shipmentId": "nisi amet",
    "status": "exercitation et",
    "statusCode": "OK",
    "statusMessage": "voluptate et",
    "timestamp": "1896-06-13T03:14:20.0Z"
  }
}
{
  "status": 401,
  "title": "Unauthorized",
  "detail": "Unauthorized for given resource."
}
{
  "status": 429,
  "title": "Too Many Requests",
  "detail": "Too many requests within defined time period,please try again later."
}
{
  "status": 500,
  "title": "Internal Server Error",
  "detail": "The server encountered an unexpected condition that prevented it from fulfilling the request."
}
{
  "reasons": [
    {
      "msg": "Service Unavailable"
    }
  ],
  "details": {
    "msgId": "Id-836a775dc794c71b0b5fd41c"
  }
}
Service Homepage: developer.dhl.com/api-reference/econnect-beta-dhl-ecommerce-europe#reference-docs-section
dhllogisticsshippingecommercerest