Logistics/DHL Paket

Aus mention ERP Wiki

Die Schnittstelle DHL Paket verbindet die mentionERP Warenwirtschaft mit dem Paketversand von DHL. Sie ist Bestandteil von mentionLogistics bzw. mentionTools ab Version 10.x.x (siehe Logistics/Allgemein).

Hinweis: Dieser Service war bisher unter der Bezeichnung Geschäftskundenversand (GKV) bekannt. Die Funktion ist dieselbe, DHL und mentionERP verwenden jetzt die Bezeichnung DHL Paket. Die Anbindung erfolgt über die aktuelle DHL REST-API (Parcel DE Shipping v2).

Funktionen

Die Schnittstelle stellt der Warenwirtschaft drei Funktionen zur Verfügung:

Funktion Beschreibung
CreateShipment Erstellt eine Sendung bei DHL und liefert die Sendungsnummer sowie die Versanddokumente zurück
CancelShipment Storniert eine zuvor erstellte Sendung (anhand von Abrechnungsnummer und Sendungsnummer)
GetShipment Ruft eine bereits erstellte Sendung erneut ab, z. B. um das Versandetikett noch einmal auszugeben

Sendung erstellen (CreateShipment)

Beim Erstellen einer Sendung werden die Sendungsdaten aus der Warenwirtschaft an DHL übermittelt. Als Ergebnis erhält die Warenwirtschaft:

  • die Sendungsnummer
  • das Versandetikett
  • bei Bedarf weitere Dokumente, z. B. Zolldokumente (Exportdokument) für Sendungen ins Ausland und ein Nachnahme-Etikett

Hinweise zur Erstellung:

  • Das Versandetikett kann wahlweise als Dokument oder als Download-Link von DHL geliefert werden.
  • Es kann festgelegt werden, dass ein Etikett nur erstellt wird, wenn die Empfängeradresse von DHL codiert (eindeutig zugeordnet) werden kann. Bei nicht codierbaren Adressen wird die Sendung dann mit einer Fehlermeldung abgelehnt.
  • Zusätzlich gibt es einen Prüfmodus, in dem DHL die Sendungsdaten nur validiert, ohne eine Sendung anzulegen.
  • Wird die Sendung zu einem Beleg erstellt, wird die Antwort von DHL beim Beleg gespeichert.
  • Bei Fehlern erhält die Warenwirtschaft eine Fehlermeldung mit der Antwort von DHL. Sie wird zusätzlich im Protokoll vermerkt.

Die Sendungsarten Postfiliale und Packstation werden unterstützt.

Sendung stornieren (CancelShipment)

Mit der Stornierung wird eine Sendung bei DHL gelöscht, solange sie noch nicht eingeliefert bzw. abgeholt wurde. DHL liefert den Status der Stornierung zurück, der in der Warenwirtschaft angezeigt wird.

Sendung abrufen (GetShipment)

Der Abruf liefert den Status der Sendung sowie die zugehörigen Dokumente (Versandetikett, Exportdokument, Retourenetikett) erneut aus.

Voraussetzungen

  • ein DHL Geschäftskundenkonto mit Abrechnungsnummer (die ersten 10 Stellen entsprechen der EKP-Nummer)
  • Zugangsdaten für den DHL-Geschäftskundenversand (Benutzername und Passwort)
  • mentionERP Warenwirtschaft und mentionTools in einer Version, die DHL Paket (REST-API) unterstützt

Hinweise

  • Für die Anmeldung bei DHL wird ein Zugriffstoken verwendet. Es wird im Ordner %ProgramData%\mentionERP\Logistics zwischengespeichert und bei Bedarf automatisch neu angefordert.
  • Meldungen der Schnittstelle stehen in der Protokolldatei mentionLogistics.log im Ordner %ProgramData%\mentionERP\Logistics\Logs. Bei Supportanfragen bitte mitsenden.
  • Für Tests stellt DHL eine Sandbox-Umgebung bereit. Dabei werden keine echten Sendungen erzeugt.

Siehe auch