Skip to content

Create Label

Guide for creating DHL Express shipping labels via the merchantCENTRAL platform.

Prerequisites

  • DHL Express Connector is set up and active (see Initial Setup)
  • Connection test was successful
  • Recipient address is complete (name, street, postal code, city, country, phone)

Create Label via Shipment Label List

Step 1: Create Shipment

  1. Open Shipment Labels via search or the DHL Express Dashboard
  2. Click New (or use an existing shipment from the sales process)
  3. Select provider DHL Express (DHLX)

Step 2: Enter Recipient Data

Field Description Required?
Recipient Name Recipient's name ✅
Recipient Street Street ✅
Recipient House No. House number ✅
Recipient Post Code Postal code ✅
Recipient City City ✅
Recipient Country Code ISO alpha-2 country code (e.g., US, GB, FR) ✅
Recipient Contact Name Contact person ✅
Recipient Phone Phone number ✅
Recipient Email Email (for notifications) Recommended

Phone Number

DHL Express requires a recipient phone number for all shipments. Label creation will fail without a phone number.

Step 3: Enter Package Data

Field Description Default
Weight (kg) Package weight in kilograms From Setup (1.0 kg)
Length (cm) Length in cm —
Width (cm) Width in cm —
Height (cm) Height in cm —
Product DHL Express product From Setup (P)
Package Type Package type From Setup (YP)
Incoterm Delivery term From Setup (DAP)
Description Content description (for customs) From Setup (PLT Description)

Step 4: Create Label

  1. Click the Create Label action
  2. The MyDHL API is called
  3. On success:
  4. Tracking No. is populated
  5. Label (PDF/ZPL2) is stored
  6. Status changes to "Created"
  7. With Auto Pickup enabled: pickup confirmation is returned

Create Label from Sales Documents

Labels can be created directly from Posted Sales Shipments:

  1. Open the Posted Sales Shipment
  2. Click Create Shipment Label
  3. The connector automatically takes:
  4. Recipient address from the shipment
  5. Weight from item lines (if available)
  6. Reference (shipment number)
  7. The label is created and the Tracking No. is written back to the shipment

Advanced Options

Value Added Services (VAS)

Service Description
Insurance (II) Insurance with declared value
Saturday Delivery (SA) Saturday delivery
On Demand Delivery (OB) Recipient can redirect delivery
GoGreen Plus (GG) Carbon-neutral shipping
Neutral Delivery (NW) No sender on label
Paperless Trade (PT) Electronic customs documents

Customs Data (International Shipments)

For shipments outside the EU:

Field Description
Export Description Goods description
HS Code Harmonized tariff code
Customs Value Declared customs value
Customs Currency Currency of customs value
Country of Origin Country of origin

Common Errors

Error Cause Solution
HTTP 400 "Missing phone" Phone number missing Add phone number
HTTP 400 "Invalid account" Wrong account number Verify 9-digit number in setup
HTTP 400 "Invalid postal code" Postal code format mismatch Enter correct format for destination
HTTP 401 Invalid credentials Check username/password in setup
HTTP 422 "Product not available" Product unavailable for route Choose different product or check route