Bei der Verwendung der DHL-Integration ist zu beachten, dass zwei technische Varianten unterstützt werden:
- Neue DHL-Anbindung (REST API)
- Alte DHL-Anbindung (SOAP API)
Welche Variante verwendet wird, hängt von der jeweiligen Carrier-Konfiguration im System ab.
1. Packstation
Eine Adresse wird als DHL-Packstation erkannt, wenn:
- im Straßenfeld der Begriff „Packstation“ enthalten ist,
- eine dreistellige Packstationsnummer vorhanden ist,
- Groß- und Kleinschreibung spielt keine Rolle.
Beispiele
| Eingabe | REST API | SOAP API |
|---|---|---|
| Packstation 123 | ✅ Erkannt | ✅ Erkannt |
| packstation 123 | ✅ Erkannt | ✅ Erkannt |
| PACKSTATION 123 | ✅ Erkannt | ✅ Erkannt |
| Packstation, 123 | ✅ Erkannt | ✅ Erkannt |
| Packstation123 | ✅ Erkannt | ❌ Nicht erkannt |
| Packstation-123 | ✅ Erkannt | ❌ Nicht erkannt |
| Packstation 12 | ❌ Nicht erkannt | ❌ Nicht erkannt |
| Packstation 1234 | ❌ Nicht erkannt | ❌ Nicht erkannt |
Wichtig: Für einen Import, der unabhängig von der verwendeten DHL-Schnittstelle funktionieren soll, sollte immer folgendes Format verwendet werden:
Straße: Packstation
Hausnummer: 123
Die Packstationsnummer muss genau drei Ziffern enthalten.
2. Postnummer
Die Postnummer wird über die Adresszeile 2 übertragen.
Dabei gelten folgende Regeln:
- Es dürfen ausschließlich Ziffern enthalten sein.
- Es gibt auf Systemseite keine feste Mindest- oder Maximallänge. Die eigentliche Prüfung der Länge erfolgt durch DHL.
- Führende Nullen bleiben erhalten, sofern die Postnummer als Text übertragen wird.
- Führende und nachgestellte Leerzeichen werden entfernt.
- Leerzeichen innerhalb der Nummer, z. B.
123 456, sind nicht zulässig. - Angaben wie
Postnummer 123456oderPostnummer: 123456werden nicht akzeptiert.
Empfohlene Eingabe:
123456
Nicht verwenden:
Postnummer 123456Postnummer: 123456123 456
Wichtig
Wird die Postnummer nicht korrekt übertragen, wird die Adresse nicht mehr als Packstation-Adresse behandelt. Sie wird stattdessen als normale Straßenadresse an DHL übermittelt.
Es erfolgt in diesem Fall keine separate Fehlermeldung.
Die Postnummer sollte beim Import daher unbedingt als Textfeld übertragen werden, damit führende Nullen nicht verloren gehen.
3. Adressprüfung
Das System führt keine Prüfung der Adresse gegen die DHL-Adressdatenbank durch.
Geprüft werden lediglich formale Angaben:
| Feld | Prüfung |
|---|---|
| Postleitzahl | Format entsprechend dem jeweiligen Land |
| Ort | Muss ausgefüllt sein |
| Packstationsnummer | Keine Prüfung gegen ein DHL-Verzeichnis |
| Kombination aus PLZ, Ort und Packstation | Keine Prüfung |
Eine formal korrekte, aber tatsächlich nicht existente oder nicht zustellbare Adresse kann daher trotzdem zur Erstellung eines Versandlabels führen.
Ein erfolgreich erstelltes DHL-Label bedeutet somit nicht automatisch, dass die Adresse tatsächlich zustellbar ist.
Ist ein Pflichtfeld leer oder entspricht die Postleitzahl nicht dem erwarteten Länderformat, wird der Vorgang mit einer Fehlermeldung abgebrochen und es wird kein Label erstellt.
4. Fehlerverhalten bei Packstation-Adressen
Eine nicht erkannte Packstation führt nicht automatisch zu einer Fehlermeldung oder einem Versandstopp.
Beispielsweise kann bei einer falsch formatierten Packstation-Adresse Folgendes passieren:
- Die Packstation wird nicht erkannt.
- Die Adresse wird als normale Straßenadresse behandelt.
- Das bereits dem Auftrag zugeordnete DHL-Produkt wird weiterhin verwendet.
- Dadurch kann ein für Packstationen ungeeignetes DHL-Produkt für die Sendung verwendet werden.
Auch eine fehlende oder falsch eingetragene Postnummer führt nicht automatisch zu einer Fehlermeldung.
Ein Versandstopp erfolgt insbesondere bei:
- fehlendem Empfängernamen,
- fehlender Straße,
- fehlendem Ort,
- fehlender PLZ,
- fehlendem Land,
- fehlender Hausnummer, sofern die entsprechende Versandregel aktiviert ist,
- ungültigem PLZ-Format,
- einer Ablehnung der Anfrage durch DHL.
Wichtig zum DHL-Produkt
Die Packstation-Erkennung ändert nicht automatisch das dem Auftrag zugewiesene DHL-Produkt.
Wurde beispielsweise durch eine Versandregel ein Packstation-Produkt hinterlegt, die Adresse wird später aber nicht als Packstation erkannt, wird der Versand weiterhin mit diesem bereits zugewiesenen Produkt erstellt.
5. Postfilialen
Postfilialen werden derzeit nicht als eigener Zustelltyp unterstützt.
Eine Adresse wie beispielsweise:
Postfiliale 540
wird nicht als spezielle Postfilialen-Adresse erkannt, sondern als normale Straßenadresse verarbeitet.
Es gibt derzeit:
- kein separates Feldmapping für Postfilialen,
- kein spezielles DHL-Produkt für Postfilialen,
- keine automatische Erkennung von Postfilialen.
Falls Postfilialen benötigt werden, müsste dies als separate Entwicklungsanforderung umgesetzt werden.
6. Empfohlene Feldzuordnung für den Import
Für einen zuverlässigen Import von Packstation-Adressen sollte folgende Zuordnung verwendet werden:
| Feld | Wert / Beispiel |
|---|---|
| Straße | Packstation |
| Hausnummer | 123 |
| Adresszeile 2 | 123456 |
| PLZ | PLZ der Packstation |
| Ort | Ort der Packstation |
| Land | DE |
Beispiel
Straße: Packstation
Hausnummer: 123
Adresszeile 2: 123456
PLZ: 50667
Ort: Köln
Land: DE
Bitte beachten
Für einen möglichst zuverlässigen Import:
- Packstation immer als „Packstation“ im Straßenfeld übertragen.
- Packstationsnummer immer als separate dreistellige Hausnummer übertragen.
- Postnummer ausschließlich als Ziffernfolge in Adresszeile 2 übertragen.
- Postnummer als Text importieren, damit führende Nullen erhalten bleiben.
- Keine zusätzlichen Texte wie „Postnummer:“ verwenden.
- Die Hausnummer nicht leer lassen.
- Für beide DHL-Schnittstellen das Format „Packstation 123“ bzw. die entsprechende Aufteilung in Straße und Hausnummer verwenden.
Hinweis: Die eigentliche Zustellbarkeit und die abschließende Prüfung der Versanddaten erfolgt durch DHL.
