DHL Geschäftskundenversand API
In diesem Artikel finden Sie die Beschreibung der DHL Geschäftskunden API-Schnittstelle. Informationen zu DHL Versenden finden sie hier.
Allgemeines
Die DHL Geschäftskundenversand API ermöglicht die Verwaltung von Sendungen sowie den online Kauf von Versandmarken und richtet sich typischerweise an Versender mit einem Volumen von mehr als 200 Sendungen pro Jahr.
Die Geschäftskundenversand API übernimmt
- die Vorbereitung von Versandscheinen für den nationalen und internationalen Versand
- Erstellung von Exportdokumenten
- Abruf von Etiketten
Einstellungen
Den Dialog DHL-Einstellungen erreichen Sie über den Menüpunkt Belege/M-DHL/Einstellungen.
Hier nehmen Sie die grundlegenden Einstellungen für die DHL Geschäftskundenversand API vor.
- Im Hauptartikel M-DHL Einstellungen (Geschäftskundenversand API) werden die einzelnen Funktionen schrittweise erläutert.
- Weitere Informationen zu den anderen DHL Schnittstellen finden Sie unter M-DHL Einstellungen.
Definition von Versandarten für die DHL Geschäftskundenversand API
Welche Produkte und Services an die Geschäftskundenversand API übergeben werden, wird durch die Versandart bestimmt.
- Im Hauptartikel M-DHL Definition von Versandarten für die Geschäftskundenversand API erfahren Sie, wie man Versandarten für die DHL Geschäftskundenversand API definieren kann.
Datenübergabe Mauve System3-Geschäftskundenversand API und Erzeugen der Paketnummern
Die DHL Geschäftskundenversand API Schnittstelle erlaubt es, direkt aus Mauve System3 Paketscheine im Geschäftskundenportal der DHL zu erzeugen. Der Paketscheindruck erfolgt direkt aus Mauve System3 heraus, es ist kein Fremdprogramm nötig. Bei diesem Vorgang wird direkt eine Paketnummer erzeugt, so dass ein Rückimport der Paketscheinnummern nicht nötig ist. Die Paketnummern stehen sofort nach dem Paketscheindruck für Versandmails bzw. Track & Trace zur Verfügung.
PDF Druck mit Hilfe von Ghostscript
Damit Sie Paketscheine drucken können, müssen Sie Ghostscript installieren. Siehe auch Ghostscript
Einstellung des Etikettenformats
Das gewünschte Etikettenformat stellen Sie im Geschäftskundenportal der DHL ein.
Die Druckereinstellungen finden Sie dort unter Versenden/Einstellungen/Allgemeine Einstellungen/.
Gewicht
Die DHL Geschäftskundenversand API verlangt die Übergabe eines Paketscheingewichts von mindestens 200 Gramm. Daher muss immer ein Paketgewicht übergeben werden.
- Ist in den DHL-Einstellungen ein Standardgewicht hinterlegt, so wird immer das Standardgewicht eingetragen. Dabei wird kein Bestätigungsdialog angezeigt.
- Ist in den DHL-Einstellungen kein Standardgewicht hinterlegt, so versucht Mauve System 3 anhand des Belegs das Gesamtgewicht aus den einzelnen Posten zu berechnen.
- Beispiel: Der Beleg umfasst 3 Posten. Posten 1 besteht aus einem Artikel, der 100 Gramm wiegt. Posten 2 besteht zwei Artikel á 300 Gramm. Posten 3 ist der Portoartikel (Verpackungsgewicht) und wiegt 100 Gramm.
=> 100 g + (2 * 300 g) + 100 g = 800 g
Das errechnete Gesamtgewicht beträgt demnach 800 g oder 0,8 kg und wird zur Kontrolle in einem Dialog angezeigt, der mit OK bestätigt werden muss.
- Hinweis: Mit Hilfe der Option Keine Gewichtsabfrage bei berechnetem Gewicht lässt sich diese Sicherheitsabfrage unterdrücken.
Troubleshooting
Versand in die USA
Aufgrund von Änderungen an den Einfuhrbestimmungen in die USA war in der zweiten Hälfte 2025 der Versand in die USA durch die DHL nicht möglich.
Seit dem 24.09.2025 hat die DHL dafür wieder die Möglichkeit geschaffen. Dafür musste aber die Schnittstelle zwischen Mauve System 3 und der DHL Geschäftskundenversand API erweitert werden, was mit Version 2026.2 geschehen ist.
Damit der Versand klappt, müssen aber bestimmte Regeln beachtet werden:
- Der Versand ist ausschließlich mit dem DHL-Produkt DHL Paket International (V01PAK) möglich. Der USA-Versand mit dem Produkt Warenpost International (V66WPI) ist weiterhin nicht möglich.
- Es können nur Sendungen mit einem Zollwert von bis zu 800 US-Dollar bzw. 680 Euro versendet werden. Für diese muss zwingend der Service PDDP verwendet werden.
- Für Adressen in den USA muss der Bundesstaat übergeben werden.
Daraus ergibt sich für Mauve System 3:
- Sie können ausschließlich den Versand-Service International Premium PDDP Vorausverfügung verwenden.
Beachten Sie dazu, das Sie hier die Art der Vorausverfügung in den Zusatzdaten angeben müssen, z.B.@VORAUSVERFUEGUNG=ABANDONMENT@< - Bei der Adressangabe muss zwingend der Bundesstaat angegeben werden. Da Mauve System 3 kein eigenes Feld für den Bundesstaat der USA besitzt, muss die Angabe im Ortnamenfeld zusätzlich zu der Stadt erfolgen. Dabei muss das Kürzel des Bundesstaats nach dem Ortsnamen, abgetrennt durch ein Komma erfolgen.
- Die Liste der Kürzel der Bundesstaaten finden Sie hier. Um die Eingabe zu vereinfachen, und damit der Aufdruck auf den Kundenbelegen besser aussieht können die führenden Zeichen "US-" weggelassen werden.
- Beispiel: New York, US-NY oder besser: New York, NY. Weitere Beispiele Austin, TX oder Providence, RI.
Mauve System 3 Fehlermeldungen
Beim Drucken des Paketscheins in Mauve System 3 erhalten Sie die Fehlermeldung Dem Kunden wurde kein Mandant für diesen Paketdienstleister zugeordnet.
Bevor Mauve System 3 Paketscheine druckt, müssen Sie die Paketdienstleister richtig konfiguriert haben. Ist dies nicht der Fall, so erzeugt Mauve System3 eine Fehlermeldung:
- Dem Kunden wurde kein Mandant für diesen Paketdienstleister zugeordnet
- Zur Lösung des Problems schauen Sie nach, welche Kategorie der betroffene Kunde besitzt.
- Über den Bereich Referenzlisten überprüfen Sie, zu welcher Kundenkategorie dieser Mandant zugeordnet ist.
- Anschließend wechseln Sie in den Dialog M-DHL Einstellungen.
DHL Einstellungen - Wählen Sie dort den entsprechenden Mandanten aus und vervollständigen Sie die M-DHL-Konfiguration, wie weiter oben beschrieben.
- Zur Lösung des Problems schauen Sie nach, welche Kategorie der betroffene Kunde besitzt.
Beim Drucken des Paketscheins in Mauve System 3 erhalten Sie die Fehlermeldung Fehler beim Paketscheindruck API-Fehler Statuscode: 1001 login failed.
Bitte beachten Sie, dass Ihr Passwort im DHL Geschäftskundenservice in regelmäßigen Abständen geändert werden muss. Der DHL weist Sie darauf hin. Sobald Sie das Passwort dort geändert haben, muss es auch unter den Einstellungen im Mauve System3 aktualisiert werden
Fehler trotz Ghostscript Installation
Siehe Ghostscript