Funktionsbeschreibung Schnittstelle DHL

Inhalt

Versandschnittstelle DHL

Das Zusatzmodul „Versandschnittstelle DHL" ist eine vollintegrierte Versandschnittstelle zu DHL und benötigt eine separate Lizenz.

Sämtliche Versandnummern, Versandetiketten, Übergabelisten und Versanddokumente werden direkt in TaskCenter erzeugt und gedruckt. Die Art der Datenübermittlung an DHL kann konfiguriert werden. Das Versandetikett kann individuell (Logos, Texte) angepasst werden.

Voraussetzungen:

• Zugangsdaten für den DHL Service: Dazu muss der KUNDE sich zuerst bei DHL registrieren: https://www.dhl.de/de/geschaeftskunden/paket/kunde-werden/angebot-dhl-geschaeftskunden-online/onlinevertrag.html?cid=c_dhl_202547056_2518#/?step=-1&ocaId=c26a593f-298e-4828-a64d-317dc18589ed

• Etikettendrucker am Server installiertBartender Lizenz für Etikettendrucker DHL Zugangsdaten und InformationenDHL Routing TabellenTaskCenter Modul „Versandschnittstelle DHL" Putty auf Server oder Clients installieren
  Anwendungspool „POLLEX" muss mit ausreichenden Berechtigungen laufen, damit der Export der Datei und Start der SFTP Übertragung (Batch Datei ausführen) möglich ist.

• Vor dem GoLive müssen die Export Files und die Label von DHL überprüft werden.

• Bei internationalen DHL-Produkten muss zusätzlich der erzeugte Routingcode auf dem Etikett geprüft werden. Nach Änderungen an Versandarten, Produkten, Layouts oder Routingcode-Logik sind neue Testetiketten zu erzeugen und an DHL zur Abnahme zu senden.

Einstellungen und Konfiguration

Kunde für Absenderadresse anlegen

Für die Übergabe der korrekten Versandadresse muss im Kundenstamm ein neuer Kunde angelegt werden.

Die eingetragenen Adressdaten werden in der DHL Schnittstelle als Absenderadresse übergeben. Zusätzlich muss bei dem Kunden ein Kundenprofilierungskriterium mit der Bezeichnung „DHL KUNDENNUMMER" angelegt werden. In diesem ist die EKP Nummer (=DHL Kundennummer) zu hinterlegen.

Die angelegte Kundennummer muss in „Grundlagen" – „Organisatorischen Einheiten" in der Spalte „KUNDENNUMMER" dann noch hinterlegt werden.

Einstellungen im Grundlagenmanager

Gewichtsprüffaktor

Bei der Versendung wird das gewogene Gesamtgewicht mit den Stammdaten aus Artikelstamm verglichen. Bei Abweichungen wird eine Informationsmeldung angezeigt.

Im Grundlagenmanager unter Versand kann ein Gewichtsprüffaktor eingegeben werden.Faktor 1 = gleiches Gewicht wie im ArtikelstammFaktor 1,1 = ca. 10 % darunter und 10 % darüber werden akzeptiert

Keine Versendung bei Lieferterminen in der Zukunft

Wenn die Option aktiviert ist, werden auf bei Lieferterminen in der Zukunft die Rechnung erstellt und gedruckt und der Versand durchgeführt.Ansonsten wird bei Lieferterminen in der Zukunft nur der Lieferschein gedruckt, aber sonst keine weitere Aktion durchgeführt.

Lieferscheine immer drucken

Wenn die Option aktiviert ist, wird der Lieferschein beim Drucken aus dem Fenster „Verpackung und Versand" immer mitgedruckt.

SFTP Verbindung – PuTTY – PPK

Putty auf dem Server installieren. (https://www.chiark.greenend.org.uk/~sgtatham/putty/)

Installationspfad C:\Putty verwenden (Keine Leerzeichen im Installationspfad verwenden!)

Pfad zu psftp.exe (im PuTTY Installationsordner) in Grundlagen per SQL eintragen:INSERT INTO Grundlagen_WERTE (name, wert) values ('PUTTY_PATH', 'C:\Putty');

Mit PuTTY Key Generator einen public/private Key erzeugen.

ACHTUNG: Keine Key Passphrase hinterlegen!

Den erzeugten Key als Public (z.B. als “public_key” - ohne Dateiendung) und als Private Key (z.B. als “private_key.ppk”) im Putty Ordner abspeichern.

Die erzeugte PKK Datei muss anschließend auch im Ordner „c:\inetpub\wwwroot\LC.Net\Company\Export\" gespeichert werden.

Der Dateiname des Private Keys muss nun im Multiflex in den Versandarten bei der DHL-Versandart im Feld FTP PPK Dateiname hinterlegt werden.

Der Public Key muss bei DHL hinterlegt werden. Dazu den Link https://ssp.cedi.prod.dhl.de/selfservice/sftp#changeKey aufrufen und dort den Account-Name (FTP Benutzer), das aktuelle Passwort (FTP Passwort), den Public-Key-Dateinamen (z.B. “public_key”) und den Inhalt der Public Key-Datei ablegen oder Alternativ mithilfe der Schaltfläche “Aus Datei laden” den Inhalt automatisch laden lassen. Mit Klick auf Senden wird der Key sofort abgelegt und der Upload ist damit sofort möglich.

Versandarten anlegen

Im Fenster Versandarten müssen alle benötigten Versandarten angelegt werden.

DHL-Produkte / Verfahren und Routingcode

Für die DHL-Schnittstelle können je nach Kundenanforderung unterschiedliche DHL-Produkte bzw. Verfahren verwendet werden. Die Produkt-/Verfahrenszuordnung erfolgt über die Benutzerinfos der jeweiligen Versandart.

Beispiele aus der Einrichtung:

Die konkreten Werte für EKP, Verfahren, Teilnahme, Paketzentrum und Nummernkreis werden von DHL bereitgestellt und müssen pro Versandart korrekt hinterlegt werden.

Routingcode bei nationalen und internationalen Sendungen

Bei der Erstellung des DHL-Etiketts wird ein Routingcode erzeugt. Dabei ist zu unterscheiden, ob für das jeweilige Verfahren ein langer oder kurzer Routingcode zu verwenden ist.

Nach Klärung mit DHL gilt:

Der lange Routingcode enthält zusätzlich Straßencode und Hausnummer und hat nach dem „+“ insgesamt 14 Stellen. Der kurze Routingcode enthält diese Bestandteile nicht und hat nach dem „+“ insgesamt 8 Stellen.

Für internationale Sendungen, z. B. DHL Europaket, dürfen Straßencode und Hausnummer nicht im Routingcode enthalten sein. Daher müssen bei diesen Verfahren die letzten 6 Stellen entfallen.

Datenbanktabellen für Routinginformationen

Für die Ermittlung des Routingcodes werden Routinginformationen aus DHL-Tabellen in der Datenbank verwendet.

Es gibt dabei zwei relevante Tabellen:

Ablauf der Selektion:

1. Zuerst wird anhand der Adresse bzw. Postleitzahl der passende Code ALORT aus der Tabelle DHL_PLZ_DA ermittelt.

2. Mit diesem ALORT wird anschließend die Straße in der Tabelle DHL_STRA_DB selektiert.

3. Aus DHL_STRA_DB wird der benötigte Straßenschlüssel für die Routingcode-Ermittlung gelesen.

Import der DHL Routinginformationen

Für die Ermittlung des DHL-Routingcodes müssen aktuelle DHL-Leitcodedaten bzw. Routinginformationen in der Datenbank vorhanden sein. Diese Daten befüllen u. a. die Tabellen `DHL_PLZ_DA` und `DHL_STRA_DB`.

Die Leitcodedaten können über das DHL Developer Portal heruntergeladen werden:

1. Unter `https://developer.dhl.com/` anmelden.

2. Die Zugangsdaten sind im CRM im Ticket `124487` hinterlegt.

3. Nach der Anmeldung rechts oben das Nutzer-Dashboard öffnen.

   

4. Im Dashboard den Bereich **Downloads** aufrufen.

   

5. Die aktuellste Datei **DF-CARGO.zip** herunterladen.

   

Nach dem Download muss die ZIP-Datei entpackt werden. Für den Import wird die passende Leitcodedatei aus dem Downloadpaket verwendet. In der bestehenden Dokumentation wurde hierfür eine Datei im Format `BXXXXXXX.DAT` beschrieben, wobei die größte bzw. relevante `.DAT`-Datei aus dem Downloadpaket verwendet wird.

Der Import erfolgt über **LC.WpfInterfaces** über die entsprechende DHL-Funktion für Routinginformationen / Leitcodedaten.

Import DE Daten:

Kompletten Dateipfad inkl. Datei zu der Importdatei hinterlegen.Dateiname: BXXXXXXX.DAT Datei (größte Datei im Download Package verwenden)z.B.: C:\Install\daten_leitcodierung_de_q3_2018\B1806152.DATSpeichern -> Fenster schließen -> Start

Import zusätzlicher Länderdaten:

Kompletten Dateipfad inkl. Datei zu der Importdatei hinterlegen.Dateiname: BXXXXXXX.DAT Datei (größte Datei im Download Package verwenden)z.B.: C:\Install\daten_leitcodierung_at_q3_2018\B1806152.DAT„Datei zusätzlich einlesen" und „Internationale Datei" aktivieren.Speichern -> Fenster schließen -> Start

Technischer Hinweis Routingcode

Die Logik wurde angepasst, damit für DHL Europaket bzw. internationale DHL-Verfahren der kurze Routingcode erzeugt wird.

Die Anpassung ist in folgenden Multiflex-Versionen enthalten:

• 5.51.9.0 oder höher

• 5.52.4.0 oder höher

Vor produktiver Verwendung müssen die erzeugten Etiketten erneut erstellt und in Originalform an DHL zur Abnahme gesendet werden.

Zollabwicklung

Die systemseitige Zollabwicklung, z. B. für Lieferungen in die Schweiz oder Türkei, ist in der bestehenden DHL-Schnittstelle aktuell nicht abgebildet.

Falls eine systemseitige Zollabwicklung benötigt wird, muss dafür ein separater Zusatzwunsch bzw. eine Erweiterung geschätzt und umgesetzt werden.

DHL Express / Zusatzservices

Zusatzservices wie Lieferung am Folgetag / Next Day, Lieferung vor 12:00 Uhr oder Lieferung vor 08:00 Uhr sind nicht Bestandteil der bestehenden DHL-Schnittstelle.

Diese Services sind laut Klärung nur über DHL Express möglich. DHL Express ist technisch ein anderer Dienstleister bzw. eine andere DHL-interne Schnittstelle und wird durch die bestehende Multiflex-DHL-Schnittstelle nicht unterstützt.

Für DHL Express wäre daher eine separate Schnittstelle bzw. Erweiterung erforderlich.

Sonderfunktionen - dynamischer Werteübersetzer

Druckerzuweisung für Versandetiketten

Die Auswahl des verwendeten Druckers für die jeweilige Versandart kann pro Versandart und auch pro User und Versandart definiert werden.

Markieren Sie im Fenster Versandarten die gewünschte Versandart. Mit dem Druckersymbol können Sie das Fenster „Drucker für Versandetiketten" öffnen, in dem Sie pro User einen eigenem Etikettendrucker definieren können.

Soll für eine Versandart ein Drucker unabhängig von dem angemeldeten User verwendet werden, kann dies in der Spalte „Drucker" im Fenster „Versandarten" definiert werden.

MIME Type im IIS anlegen

Im Internet Information Server muss überprüft werden, ob der MIME Type „.dat" bereits vorhanden ist. Falls nicht, muss dieser mit MIME Type „text/plain" anlegt werden.

Etikettendruck mit Bartender

Pro Versandart muss ein eigenes Bartender Etikett (gleicher Dateiname wie Versandart) angelegt werden.

Anpassungen von Logo, Zusatzinformationen und Texten können laut Kundenwunsch vorgenommen werden.

Vor dem Go Live muss das Etikette von DHL überprüft werden.

Bei internationalem Versand ist besonders darauf zu achten, dass der Routingcode am Etikett gemäß DHL-Spezifikation korrekt dargestellt wird. Für DHL Europaket bzw. internationale Verfahren darf der Routingcode nur in der kurzen Variante ausgegeben werden.

Etikettendruck mit ActiveReport (TaskCenter)

Pro Versandart muss ein eigenes Drucklayout angelegt werden.Der Dateiname muss gleich lautend wie Versandart sein. Wird die Nummer der Organisationseinheit am Anfang des Dateinamens gestellt, wird die Druckvorlage nur für diese verwendet.
z.B. „10_DHL.rpx"

Die DHL.rpx kann als Vorlage für das DHL Versandetikette verwendet werden.

Die fertig designte Druckvorlage muss im Verzeichnis „inetpub\wwwroot\LC.NET\Company" abgelegt werden.

Bei internationalem Versand ist besonders darauf zu achten, dass der Routingcode am Etikett gemäß DHL-Spezifikation korrekt dargestellt wird. Für DHL Europaket bzw. internationale Verfahren darf der Routingcode nur in der kurzen Variante ausgegeben werden.

Versendung erstellen

Die Versendung wird im Fenster Verpackung & Versand erstellt. Die Funktionsbeschrbeibung zu diesem Fenster finden Sie im Artikel Verpackung & Versand.

Drucken Übergabeliste und Export Speditionsdateien

Am Ende des Tages müssen die Versanddateien exportiert und an DHL übertragen werden. Zusatzprogramme / Datenexport / Export Speditionsdateien.

„Nur noch nicht exportierte Lieferscheine" aktivieren. Versandart und Organisatorische Einheit auswählen und Aktualisieren.

Drucken der Versandliste/Übergabeliste mit Drucksymbol .

Starten des Exports mit dem blauen Pfeil .Dadurch werden die Versanddaten je nach Einstellung entweder direkt an den Paketdienstleister gesendet oder im Filesystem abgelegt.

Werden die Versanddaten direkt über FTP am Server an DHL übertragen, wird am Server im Ordner „C:\Windows\System32\inetsrv" eine Logdatei angelegt und der Upload protokolliert.

Der Export muss für alle Versandarten wiederholt werden.

Paketnummern / Paketstatus / Sendungsverfolgung

Im Fenster Lieferscheine im Menüpunkt Sonderfunktionen – Paketstatus können die erstellen Paketnummern zu einem Lieferschein aufgerufen werden.

Es werden für den ausgewählten Lieferschein die angelegten Paketnummern mit dem jeweiligen Gewicht angezeigt.

Mit einem Doppelklick auf den Trackinglink wird die Sendungsverfolgung von DHL im Standard Browser geöffnet.