DHL Profiles
Manage DHL user group profiles. Profiles are the link between the DHL business customer portal (GKP) and billing numbers (EKP + procedure + participation).
Opening the Page
- Via search: DHL Profile
- Via DHL Shipment Setup → Profiles & Billing → click the Default Profile field
Overview
The profile and contract line architecture replaces the former static entry of a single billing number. It enables:
- Multiple EKP numbers per connection (e.g. domestic vs. international)
- Product-specific contract lines (different billing numbers per DHL product)
- Zone-based routing (Domestic / EU / International / Catch-all)
- Weight-based routing (maximum weight per contract line)
- Shipping agent service-specific contract lines (optional: only for a specific BC shipping agent service)
Fields
Profile Header
| Field | Description |
|---|---|
| Code | Unique code for the DHL profile. Corresponds to the name of the user group profile in the DHL business customer portal (GKP), e.g. STANDARD_GRUPPENPROFIL |
| Description | Free-text description of the profile |
| Default | Marks this profile as the default. Only one profile can be the default at a time. The default profile is used when no alternative profile is specified during label creation. |
Contract Lines
One or more contract lines can be maintained per profile. The contract line determines which billing number is used for a specific shipment.
| Field | Description |
|---|---|
| EKP | 10-digit DHL customer number (Einheitliche Kunden-Prozess-Nummer). Required per line. |
| Shipping Agent Service Code | Optional filter: This contract line only applies to this BC shipping agent service code. Empty = all services. |
| Product | DHL product for this contract line: V01PAK (DHL Parcel), V53WPAK (Parcel International), V54EPAK (Europaket), V62KP (DHL Small Parcel), V66WPI (Warenpost International) |
| Participation | 2-digit DHL participation code. Corresponds to the last 2 digits of the billing number. |
| Zone | Shipping zone: Domestic (same country), EU (EU member state), International (non-EU), (Any) (catch-all for all zones) |
| Max Weight (g) | Maximum shipment weight in grams for this contract line. 0 = unlimited. Shipments above this weight are routed to the next matching line. |
| Default | Marks this contract line as the default within the profile |
| Description | Optional description of the contract line |
Resolution Logic (Contract Resolver)
When creating a label, the Contract Resolver automatically determines the appropriate contract line:
- Determine zone: The destination country of the shipment is analyzed:
- Domestic = Same country as the company address in Business Central
- EU = EU member state (but different country)
-
International = All other countries
-
Find contract line (in this priority): | Priority | Shipping Service | Zone | |---|---|---| | 1 (highest) | Specific service | Specific zone | | 2 | Specific service | Any (catch-all) | | 3 | Empty (all services) | Specific zone | | 4 (lowest) | Empty | Any (general catch-all) |
-
Calculate billing number:
- Format:
EKP (10) + procedure code (2) + participation (2)= 14 digits - Procedure code depends on product (e.g.
01for V01PAK,53for V53WPAK) - Return billing number:
EKP (10) + 07 (return) + participation (2)
Setup Example
Scenario: A merchant ships domestically with V01PAK and internationally (EU + worldwide) with V53WPAK.
Profile: STANDARD_GRUPPENPROFIL
| EKP | Product | Participation | Zone |
|---|---|---|---|
| 1234567890 | V01PAK | 01 | Domestic |
| 1234567890 | V53WPAK | 01 | EU |
| 1234567890 | V53WPAK | 01 | International |
With this configuration, the Contract Resolver automatically selects:
- → Shipment to Germany: V01PAK, billing number 12345678900101
- → Shipment to France: V53WPAK, billing number 12345678905301
- → Shipment to USA: V53WPAK, billing number 12345678905301
Actions
| Action | Description |
|---|---|
| Contract Lines | Opens the contract lines for the selected profile |
| Set as Default | Marks the selected profile as the default |
Notes
Profile Name = User Group Profile
The Code of the profile must exactly match the name of the user group profile in the DHL business customer portal. This is passed to the DHL API as billingInformation.customerReference.billerUserGroupProfileName when creating labels.
Simplest Starting Point
For most merchants, one profile with one or two contract lines (Domestic + Any) is sufficient. Multiple profiles only make sense with complex contract structures involving multiple EKPs or product-specific conditions.
Migration from Version 1.0.0.0
In version 1.0.0.0, a static billing number was entered in the setup field. This field has been replaced by the profile system. After upgrading to 1.0.0.1, profiles and contract lines must be set up manually.