DHL Profile

DHL-Benutzergruppen-Profile verwalten. Profile bilden das Bindeglied zwischen dem DHL Geschäftskundenportal (GKP) und den Abrechnungsnummern (EKP + Verfahren + Participation).

Seite öffnen

Über die Suche: DHL Profile
Über DHL Shipment Setup → Profiles & Billing → Feld Default Profile anklicken

Überblick

Die Profil- und Vertragspositions-Architektur ersetzt die frühere statische Eingabe einer einzigen Abrechnungsnummer. Sie ermöglicht:

Mehrere EKP-Nummern pro Verbindung (z.B. Inland vs. International)
Produkt-spezifische Vertragspositionen (unterschiedliche Abrechnungsnummern je DHL-Produkt)
Zonenbasiertes Routing (Inland / EU / International / Catch-all)
Gewichtsbasiertes Routing (Maximalgewicht je Vertragszeile)
Service-Varianten (separate Teilnahme-Codes für Sendungen mit Zusatzdiensten wie Sperrgut, Nachnahme oder GoGreen Plus)
Versandart-spezifische Vertragspositionen (optional: nur für eine bestimmte BC-Versandart)

Felder

Profilkopf

Feld	Beschreibung
Code	Eindeutiger Code des DHL-Profils. Entspricht dem Namen des Benutzergruppenprofils im DHL Geschäftskundenportal (GKP), z.B. `STANDARD_GRUPPENPROFIL`
Description	Freitext-Beschreibung des Profils
Default	Markiert dieses Profil als Standard. Nur ein Profil kann gleichzeitig Standard sein. Das Standard-Profil wird verwendet, wenn bei der Sendungserstellung kein abweichendes Profil angegeben wird.

Vertragspositionen (Contract Lines)

Pro Profil können eine oder mehrere Vertragspositionen gepflegt werden. Die Vertragsposition bestimmt, welche Abrechnungsnummer für eine konkrete Sendung verwendet wird.

Feld	Beschreibung
EKP	10-stellige DHL-Kundennummer (Einheitliche Kunden-Prozess-Nummer). Pflichtfeld je Zeile.
Shipping Agent Service Code	Optionaler Filter: Nur für diese BC-Versandart-Dienstleistung gilt diese Vertragszeile. Leer = alle Versandarten.
Product	DHL-Produkt für diese Vertragszeile: V01PAK (DHL Paket), V53WPAK (Paket International), V54EPAK (Europaket), V62KP (DHL Kleinpaket), V66WPI (Warenpost International)
Participation	2-stelliger DHL-Teilnahme-Code. Entspricht den letzten 2 Stellen der Abrechnungsnummer. DHL vergibt je nach Service-Variante unterschiedliche Teilnahme-Codes für dasselbe Produkt.
Service Variant	Für welche Service-Kombination diese Teilnahme gilt (siehe Service-Varianten).
Zone	Versandzone: Domestic (Inland), EU (EU-Mitgliedsland), International (Nicht-EU), (Any) (Catch-all für alle Zonen)
Max Weight (g)	Maximales Sendungsgewicht in Gramm für diese Vertragszeile. 0 = unbegrenzt. Sendungen über diesem Gewicht werden an die nächste passende Zeile weitergeleitet.
Default	Markiert diese Vertragszeile als Standard innerhalb eines Profils, wenn mehrere Zeilen mit gleichen Kriterien vorhanden sind
Description	Optionale Beschreibung der Vertragszeile

Service-Varianten und die DHL-Abrechnungsmatrix

DHL vergibt für dasselbe Produkt unterschiedliche Teilnahme-Codes (Participation), abhängig davon, welche Zusatzleistungen gebucht werden. Dies gilt insbesondere für DHL Paket (V01PAK) — bei kleineren Produkten sind Standard und Services in einer Teilnahme zusammengefasst.

Service Variant	Wann wird sie benötigt?	Typische Zusatzdienste
Standard	Sendungen ganz ohne Zusatzdienste	Nur DHL Retoure beileger
With Services	Mindestens ein Zusatzdienst ist gebucht (ohne GoGreen)	Sperrgut, Nachnahme, Versicherung, Altersprüfung (A16/A18), Ident-Check, Wunschtag, Wunschnachbar, keine Nachbarschaftszustellung, Eigenhändig, Nur benannte Person, Premium, CDP, PDDP, Parcel Outlet Routing
GoGreen	Nur GoGreen Plus, keine anderen Zusatzdienste	GoGreen Plus
With Services + GoGreen	GoGreen Plus und mindestens ein weiterer Zusatzdienst	Kombination aus beidem

Automatische Varianten-Auflösung

Der Contract Resolver ermittelt automatisch, welche Service-Variante für eine Sendung benötigt wird — basierend auf den im Label-Dialog gewählten VAS. Sie müssen nichts manuell umstellen. Sie müssen nur sicherstellen, dass in der Profiltabelle für jede Variante, die Sie nutzen möchten, eine Vertragszeile mit dem passenden Teilnahme-Code hinterlegt ist.

Fehlende Vertragszeile für Service-Variante

Wenn eine Sendung Sperrgut enthält (oder einen anderen Zusatzdienst, der "With Services" erfordert), aber keine Vertragszeile mit Service Variant = With Services existiert, bricht die Label-Erstellung mit einem klaren Hinweis ab: welche Variante fehlt und wie sie nachgepflegt werden kann.

Auflösungslogik (Contract Resolver)

Beim Erstellen eines Labels bestimmt der Contract Resolver automatisch die passende Vertragszeile:

Zone ermitteln: Das Zielland der Sendung wird analysiert:
Domestic = Gleiches Land wie die Unternehmensadresse in Business Central
EU = EU-Mitgliedsland (aber anderes Land)
International = Alle anderen Länder
Service-Variante ermitteln: Aus den gewählten VAS wird automatisch abgeleitet, welche Teilnahme-Dimension benötigt wird:
Keine Zusatzdienste → Standard
Nur GoGreen Plus → GoGreen
Sonstiger Zusatzdienst ohne GoGreen → With Services
Sonstiger Zusatzdienst + GoGreen → With Services + GoGreen
Vertragszeile suchen (in dieser Priorität, je Zone und Service-Variante): | Priorität | Versandart | Zone | |---|---|---| | 1 (höchste) | Konkrete Versandart | Konkrete Zone | | 2 | Konkrete Versandart | Any (Catch-all) | | 3 | Leer (alle Versandarten) | Konkrete Zone | | 4 (niedrigste) | Leer | Any (genereller Catch-all) |

Innerhalb gleicher Kriterien wird zuerst nach dem kleinsten passenden Maximalgewicht gesucht; bei Gleichstand entscheidet das Default-Flag.

Abrechnungsnummer berechnen:
Format: EKP (10) + Verfahrenscode (2) + Participation (2) = 14 Stellen
Verfahrenscode abhängig vom Produkt (z.B. 01 für V01PAK, 53 für V53WPAK)
Retoure-Abrechnungsnummer: EKP (10) + 07 (Retoure) + Participation (2), GoGreen-Retoure nutzt eigene Variante wenn konfiguriert

Einrichtungsbeispiel

Einfaches Szenario (nur Inlandsversand, keine Zusatzdienste)

EKP	Produkt	Participation	Service Variant	Zone
1234567890	V01PAK	01	Standard	Domestic

Ergebnis: Jede Inlandssendung ohne Zusatzdienste → Abrechnungsnr. 12345678900101

Erweitertes Szenario (Inland + Sperrgut + GoGreen)

Dieses Szenario deckt einen Händler ab, der DHL Paket national versendet und dabei drei Teilnahme-Codes hat: einen für Standardsendungen, einen für Sendungen mit Sperrgut oder Versicherung, und einen für GoGreen-Sendungen.

Profil: STANDARD_GRUPPENPROFIL

EKP	Produkt	Participation	Service Variant	Zone	Beschreibung
1234567890	V01PAK	01	Standard	Domestic	Standardsendungen
1234567890	V01PAK	02	With Services	Domestic	Sperrgut, Nachnahme, Versicherung etc.
1234567890	V01PAK	04	GoGreen	Domestic	GoGreen Plus
1234567890	V01PAK	03	With Services + GoGreen	Domestic	Sperrgut + GoGreen kombiniert
1234567890	V53WPAK	01	Standard	EU	EU-Versand
1234567890	V53WPAK	01	Standard	International	Weltweit

Mit dieser Konfiguration wählt der Contract Resolver automatisch: - → Inlandssendung ohne Extras: 12345678900101 - → Inlandssendung mit Sperrgut: 12345678900102 - → Inlandssendung mit GoGreen Plus: 12345678900104 - → Inlandssendung mit Sperrgut + GoGreen: 12345678900103 - → EU-Sendung: 12345678905301

Sandbox-Daten

Im Sandbox-Modus werden beim Setup-Wizard automatisch alle vier Service-Varianten mit den offiziellen DHL-Test-Teilnahme-Codes (01, 02, 03, 04) angelegt. Sie müssen die Sandbox-Konfiguration daher nicht manuell erweitern.

Aktionen

Aktion	Beschreibung
Contract Lines	Öffnet die Vertragspositionen des gewählten Profils
Set as Default	Markiert das gewählte Profil als Standard

Hinweise

Profilname = Benutzergruppenprofil

Der Code des Profils muss exakt dem Namen des Benutzergruppenprofils im DHL Geschäftskundenportal entsprechen. Dieser wird beim Erstellen von Labels als billingInformation.customerReference.billerUserGroupProfileName an die DHL API übergeben.

Einfachster Einstieg

Für die meisten Händler reicht ein Profil mit einer Vertragszeile pro Produkt und Zone. Service-Varianten müssen nur dann gepflegt werden, wenn tatsächlich Zusatzdienste wie Sperrgut oder GoGreen Plus gebucht werden sollen. Der Setup-Wizard legt standardmäßig nur Standard-Varianten an — erweitern Sie bei Bedarf.

Migration von Version 1.0.0.0

In Version 1.0.0.0 wurde eine statische Abrechnungsnummer im Setup-Feld eingegeben. Dieses Feld wurde durch das Profil-System abgelöst. Nach dem Upgrade auf 1.0.0.1 müssen Profile und Vertragspositionen manuell eingerichtet werden.