DHL API für Versandetiketten
|
ℹ️ Du siehst das Menü noch anders? Dieser Artikel zeigt das neue easybill-Menü. Du kannst jederzeit selbst umstellen: Klicke oben rechts in der blauen Menüleiste auf deinen Benutzernamen und aktiviere den Schieberegler Neues Menü. Die Ansicht stellt sich sofort um. |
Als Alternative für den Export von Sendungsdaten, kann auch die direkte Schnittstelle zwischen easybill, bzw. easybill Connect (ehem. Import Manager) und DHL Geschäftskundenportal genutzt werden.
Um die Schnittstelle zu aktivieren, gehst du wie folgt vor.
- Klicke auf easybill Invoice und dann auf easybill Connect
- Klicke auf Einstellungen
- Klicke auf Versand
- Wähle links Versanddienstleister aus
Klicke links auf + Hinzufügen, um einen Dienstleister auszuwählen.
Klicke auf DHL VLS (Geschäftskundenportal).
Trage am Ende der Seite, deine API-Zugangsdaten des DHL Geschäftskundenportals ein (Benutzername und Passwort). Fülle zusätzlich alle Daten der Grundeinstellungen des Geschäftskundenportals aus.
Als Benutzername und Passwort sind keine Sonderzeichen außer ! und ? erlaubt. Bitte passe ansonsten deine Daten in DHL vorher an.
Wähle eine API-Versandart aus.
Setze zusätzlich den Haken falls du keinen Sammeldruck wünschst, sollte es von DHL aus eine Warnung für einen Teil der Sendungen geben.
GoGreen Plus für nationale Sendungen buchen
Der DHL Service GoGreen kann ab dem 01.09.2026 nicht mehr gebucht werden. Nachfolger ist der kostenpflichtige CO2-reduzierte Versandservice GoGreen Plus.
Für Versandetiketten, die über die DHL API erstellt werden, aktivierst du GoGreen Plus direkt in easybill Connect: Setze in den API Einstellungen den Haken bei „GoGreen Plus für nationale Sendungen buchen". GoGreen Plus wird dann für jede über die API erstellte nationale Sendung (DHL Paket, DHL Kleinpaket) gebucht.
Hast du GoGreen Plus bereits per Standardbeauftragung im DHL Geschäftskundenportal aktiviert, ist keine zusätzliche Aktivierung in easybill nötig – der Haken kann dann leer bleiben.
Hinweise:
- Die Option gilt nur für nationale Sendungen und nur für Versandetiketten, die über die DHL API erstellt werden. Nutze stattdessen den Datei-Export zum Geschäftskundenportal, aktiviere GoGreen Plus per Standardbeauftragung im DHL Geschäftskundenportal.
- GoGreen Plus wird nicht über einen Produkt-Code gebucht. Einen alten GoGreen-Service-Code (z. B. V01GOGR) entferne bitte aus deinen Produkt-Codes, da dieser ab dem 01.09.2026 nicht mehr genutzt werden kann.
- GoGreen Plus ist kostenpflichtig. Die Konditionen und die Verfügbarkeit in deinem Vertrag erfragst du direkt im DHL Geschäftskundenportal oder bei deinem DHL Ansprechpartner.
Die Schnittstelle zwischen easybill und DHL ist somit hergestellt.
Bei neuen Importen klickst du wie gewohnt rechts auf Aktionen und wählst Versandetiketten erstellen aus.
Du wirst weitergeleitet in die Versandvorgänge (aufzurufen über Tools > Versand). Wähle hier (einmalig) über den Aktionen-Button Über DHL-API erstellen aus. Zukünftig wird dies als Direktbutton angezeigt, sofern du Cookies im Browser verwendest.
Der Vorgang wurde gestartet und das Pfeil-Symbol zeigt dir an, dass die Daten zu DHL übermittelt werden.
Sobald der Vorgang abgeschlossen ist, gibt DHL die Label-Informationen an easybill zurück und du kannst entweder für den gesamten Vorgang die Labels drucken. Die shipping-Datei wird vom Browser automatisch heruntergeladen und kann von dir geöffnet werden.
Klicke auf DHL Etiketten drucken.
Möchtest du einzeln die Labels drucken über die DHL Website, klickst du erst auf die Anzahl der Bestellungen. Alle Datensätze werden tabellarisch angezeigt. Für jeden einzelnen Vorgang kannst du auf Download Versandetikett (extern) klicken. Du wirst automatisch zu DHL weitergeleitet.
Du kannst hier außerdem die Label-Erstellung wieder stornieren, solltest du das Label nicht verwenden und es sollen keine Kosten bei DHL entstehen.
Gleichzeitig mit der Erstellung der Versandlabel-Datei wird auch der Sendungsdatenexport vorbereitet. Alle Trackinginformationen liegen dann bereits vor.
- Klicke auf Tools
- Klicke auf Sendungsdaten verwalten
- Du siehst hier die neu generierten Versandvorgänge
- Klicke ab hier wie gewohnt auf Aktionen > Sendungsexport vorbereiten
- Klicke auf Starte Export
Achtung:
Je nach Vertrag mit DHL kann es sein, dass ein übermitteltes Standardgewicht von DHL selbst nachgewogen und ggf. nachberechnet wird.