Zum Inhalt

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)
  • 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.
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 des Profils
Description Optionale Beschreibung der Vertragszeile

Auflösungslogik (Contract Resolver)

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

  1. Zone ermitteln: Das Zielland der Sendung wird analysiert:
  2. Domestic = Gleiches Land wie die Unternehmensadresse in Business Central
  3. EU = EU-Mitgliedsland (aber anderes Land)

  4. International = Alle anderen Länder

  5. Vertragszeile suchen (in dieser Priorität): | 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) |

  6. Abrechnungsnummer berechnen:

  7. Format: EKP (10) + Verfahrenscode (2) + Participation (2) = 14 Stellen
  8. Verfahrenscode abhängig vom Produkt (z.B. 01 für V01PAK, 53 für V53WPAK)
  9. Retoure-Abrechnungsnummer: EKP (10) + 07 (Retoure) + Participation (2)

Einrichtungsbeispiel

Szenario: Ein Händler versendet national mit V01PAK und international (EU + Welt) mit V53WPAK.

Profil: STANDARD_GRUPPENPROFIL

EKP Produkt Participation Zone
1234567890 V01PAK 01 Domestic
1234567890 V53WPAK 01 EU
1234567890 V53WPAK 01 International

Mit dieser Konfiguration wählt der Contract Resolver automatisch: - → Sendung nach Deutschland: V01PAK, Abrechnungsnummer 12345678900101 - → Sendung nach Frankreich: V53WPAK, Abrechnungsnummer 12345678905301 - → Sendung nach USA: V53WPAK, Abrechnungsnummer 12345678905301

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 oder zwei Vertragszeilen (Domestic + Any). Nur bei komplexen Vertragsstrukturen mit mehreren EKPs oder produktspezifischen Konditionen sind mehrere Profile sinnvoll.

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.