OmniShipping Internal:DHL API: Unterschied zwischen den Versionen
BD (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
BD (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
||
| Zeile 1: | Zeile 1: | ||
<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"> | <div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"> | ||
= '''ShippingConnect DHL API Versenden einrichten''' = | = '''ShippingConnect DHL API Versenden einrichten''' = | ||
<p style="text-align: center;">'''<span style="background-color:#d35400;">!! DIES IST EINE INTERNE ANLEITUNG UND NUR INNERHALB DER HTK GmbH & Co. KG zu nutzen !!</span>'''</p> | <p style="text-align: center;">'''<span style="background-color:#d35400;">!! DIES IST EINE INTERNE ANLEITUNG UND NUR INNERHALB DER HTK GmbH & Co. KG zu nutzen !!</span>'''</p> | ||
| Zeile 14: | Zeile 14: | ||
Dann im Anschluss noch die Vollständige Installation auswählen um alle benötigten Module etc. des BPM zu installieren. | Dann im Anschluss noch die Vollständige Installation auswählen um alle benötigten Module etc. des BPM zu installieren. | ||
[[File:DHL API2.png]] | [[File:DHL API2.png|RTENOTITLE]] | ||
Um eine erfolgreiche Installation des BPM zu vollziehen wird, insofern es noch nicht existent ist, das Open XML SDK 2.0 installiert. | Um eine erfolgreiche Installation des BPM zu vollziehen wird, insofern es noch nicht existent ist, das Open XML SDK 2.0 installiert. | ||
[[File:DHL API3.png]] | [[File:DHL API3.png|RTENOTITLE]] | ||
Nach einer erfolgreichen Installation muss man sich im Anschluss mit der HTK BPM GUI an der Datenbank anmelden um auch entsprechende Tabellen zu generieren. | Nach einer erfolgreichen Installation muss man sich im Anschluss mit der HTK BPM GUI an der Datenbank anmelden um auch entsprechende Tabellen zu generieren. | ||
[[File:DHL API4.png]] | [[File:DHL API4.png|RTENOTITLE]] | ||
Öffnet man den BPM zum ersten mal sind noch keinerlei Daten hinterlegt. Hier müssen dann SQL Server sowie Anmeldename und Kennwort hinterlegt werden. Im Anschluss auf „Verbinden“ drücken. | Öffnet man den BPM zum ersten mal sind noch keinerlei Daten hinterlegt. Hier müssen dann SQL Server sowie Anmeldename und Kennwort hinterlegt werden. Im Anschluss auf „Verbinden“ drücken. | ||
[[File:BPM-Anmeldung.png]] | [[File:BPM-Anmeldung.png|RTENOTITLE]] | ||
| | ||
| Zeile 34: | Zeile 34: | ||
Nun bei „Anmelden“ werden Sie bezüglich der Grundlagen und Voraussetzungen gefragt ob diese in der entsprechenden Datenbank. | Nun bei „Anmelden“ werden Sie bezüglich der Grundlagen und Voraussetzungen gefragt ob diese in der entsprechenden Datenbank. | ||
[[File:DHL API5.png]] | [[File:DHL API5.png|RTENOTITLE]] | ||
Sind die Tabellen etc. alle entsprechend angelegt worden sollte man nun im ersten Schritt die Datenbankverbindung im HTK Service hinterlegen. | Sind die Tabellen etc. alle entsprechend angelegt worden sollte man nun im ersten Schritt die Datenbankverbindung im HTK Service hinterlegen. | ||
[[File:DHL API6.png]] | [[File:DHL API6.png|RTENOTITLE]] | ||
=== Installation DHL Versenden Jobs / API === | === Installation DHL Versenden Jobs / API === | ||
Nun kann man noch das entsprechende Addin [file://ds01/Entwicklung/Standard/Tools-Erweiterungen-die-nicht-Add-in-sind/HTKService/BPM-AddIns \\ellst001.lan.htk.de\Entwicklung\Standard\Tools-Erweiterungen-die-nicht-Add-in-sind\HTKService\BPM-AddIns] | |||
Sich kopieren und in dem Sage Shared Ordner in HTKData unter den Addins reinkopieren. Des Weiteren müssen diese Files auch noch in HTKBPM – Plugins Ordner reinkopiert werden. Ebenso wie in den Shared Ordner der Sage Installation direkt. Sprich an 3 Stellen müssen die Files vorhanden sein. | |||
<span style="font-size:11.0pt"><span style="line-height:107%"><span style="font-family:" calibri",sans-serif"="">Nun muss man die .dll.xml der Versenden API</span></span></span> | |||
<span style="font-size:11.0pt"><span style="line-height:107%"><span style="font-family:" calibri",sans-serif"="">[[File:DHL API7.png]]</span></span></span> | |||
In ein Ordner eines anderen Addins legen um diese zu „installieren“ und noch umbenennen wie das entsprechende Addin des Ordners – entweder dann den Dienst neu starten oder die .xml mit einem .update versehen. Hier im Beispiel HTKVersendenApi.dll.xml umbenannt zu HTKFTP.dll.xml und in das Addinverzeichnis des FTP Addins gelegt. | |||
[[File:API DHL8.png]] | |||
Im Anschluss den Dienst starten und das Logbuch analysieren ob hier Fehler auftauchen. Kontrollieren kann man auch ob die DHL Versenden API Pluginfiles korrekt geladen wurden in dem man im Logbuch entsprechend. | |||
Nach dem nun das Addin erfolgreich geladen wurde kann man dies als Job hinzufügen: | |||
[[File:DHL API9.png]] | |||
Als Konfiguration sollte in den DHL Einstellungen die | |||
*<span style="font-size:10.5pt"><span style="line-height:107%"><span style="font-family:" segoe="" ui",sans-serif"="">'''ApplikationsID''': HTKShippingConnectDHL_1</span></span></span> | |||
*<span style="font-size:10.5pt"><span style="line-height:107%"><span style="font-family:" segoe="" ui",sans-serif"="">'''Token''': xeUuqatLqTVfvtSr9OgYCsQieONPGu</span></span></span> | |||
<span style="font-size:10.5pt"><span style="line-height:107%"><span style="font-family:" segoe="" ui",sans-serif"="">hinterlegt werden. Dies sind die von DHL freigegebenen Daten für uns.</span></span></span> | |||
<span style="font-size:10.5pt"><span style="line-height:107%"><span style="font-family:" segoe="" ui",sans-serif"="">[[File:DHL API10.png]]</span></span></span> | |||
In den Addin-Grundeinstellungen wird lediglich die Pfade sowie die SQL Abfrage für die Stornierung hinterlegt sowie ob die Sendungsnummer an OL übermittelt werden soll. | |||
[[File:DHL API11.png]] | |||
Dann wird noch ein weiterer Job im BPM benötigt die sogenannte „Datenbank Analyse“ was nur eine SQL Abfrage ist die je nach Kunde eventuell etwas angepasst werden muss. | |||
[[File:DHL API12.png]] | |||
Als SQL Statement kann man hier folgendes hinterlegen : | |||
'''<span style="color:red">ACHTUNG! Hier muss entsprechend der Mandant geprüft werden und die Besonderheit hier in dem Statement das wenn kein Gewicht im Artikel existiert im Beleg 1 KG eingetragen wird da ansonsten ein Fehler kommt und der Beleg nicht erzeugt werden kann.</span>''' | |||
| |||
| | ||
</div> </div> </div> </div> </div> </div> </div> </div> </div> </div> | </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> | ||
Version vom 2. März 2021, 20:07 Uhr
ShippingConnect DHL API Versenden einrichten
!! DIES IST EINE INTERNE ANLEITUNG UND NUR INNERHALB DER HTK GmbH & Co. KG zu nutzen !!
BPM Installation
Im ersten Schritt muss man den BPM installieren hierzu unter : \\ellst001.lan.htk.de\Entwicklung\Standard\Tools-Erweiterungen-die-nicht-Add-in-sind\HTKService\Setup-Projekt - hier das letzte Setup nehmen und auf dem entsprechenden Server installieren. In der Regel ist dies der Appserver des Kunden - wobei je nach Kunde durchaus bedacht werden sollte ob es nicht sinnvoller wäre einen eigenen Server für den BPM zu haben denn dieser kann je nach Anzahl der Jobs etc. eine hohe Auslastung mit sich bringen.
Beim ausführen der .exe muss der „Shared“ Ordner des Sage Verzeichnisses ausgewählt werden.
Dann im Anschluss noch die Vollständige Installation auswählen um alle benötigten Module etc. des BPM zu installieren.
Um eine erfolgreiche Installation des BPM zu vollziehen wird, insofern es noch nicht existent ist, das Open XML SDK 2.0 installiert.
Nach einer erfolgreichen Installation muss man sich im Anschluss mit der HTK BPM GUI an der Datenbank anmelden um auch entsprechende Tabellen zu generieren.
Öffnet man den BPM zum ersten mal sind noch keinerlei Daten hinterlegt. Hier müssen dann SQL Server sowie Anmeldename und Kennwort hinterlegt werden. Im Anschluss auf „Verbinden“ drücken.
Sobald die Verbindung hergestellt wurde, kann man nun eine entsprechende Datenbank auswählen und das Feld ist nicht mehr ausgegraut.
Nun bei „Anmelden“ werden Sie bezüglich der Grundlagen und Voraussetzungen gefragt ob diese in der entsprechenden Datenbank.
Sind die Tabellen etc. alle entsprechend angelegt worden sollte man nun im ersten Schritt die Datenbankverbindung im HTK Service hinterlegen.
Installation DHL Versenden Jobs / API
Nun kann man noch das entsprechende Addin [file://ds01/Entwicklung/Standard/Tools-Erweiterungen-die-nicht-Add-in-sind/HTKService/BPM-AddIns \\ellst001.lan.htk.de\Entwicklung\Standard\Tools-Erweiterungen-die-nicht-Add-in-sind\HTKService\BPM-AddIns]
Sich kopieren und in dem Sage Shared Ordner in HTKData unter den Addins reinkopieren. Des Weiteren müssen diese Files auch noch in HTKBPM – Plugins Ordner reinkopiert werden. Ebenso wie in den Shared Ordner der Sage Installation direkt. Sprich an 3 Stellen müssen die Files vorhanden sein.
Nun muss man die .dll.xml der Versenden API
In ein Ordner eines anderen Addins legen um diese zu „installieren“ und noch umbenennen wie das entsprechende Addin des Ordners – entweder dann den Dienst neu starten oder die .xml mit einem .update versehen. Hier im Beispiel HTKVersendenApi.dll.xml umbenannt zu HTKFTP.dll.xml und in das Addinverzeichnis des FTP Addins gelegt.
Im Anschluss den Dienst starten und das Logbuch analysieren ob hier Fehler auftauchen. Kontrollieren kann man auch ob die DHL Versenden API Pluginfiles korrekt geladen wurden in dem man im Logbuch entsprechend.
Nach dem nun das Addin erfolgreich geladen wurde kann man dies als Job hinzufügen:
Als Konfiguration sollte in den DHL Einstellungen die
- ApplikationsID: HTKShippingConnectDHL_1
- Token: xeUuqatLqTVfvtSr9OgYCsQieONPGu
hinterlegt werden. Dies sind die von DHL freigegebenen Daten für uns.
In den Addin-Grundeinstellungen wird lediglich die Pfade sowie die SQL Abfrage für die Stornierung hinterlegt sowie ob die Sendungsnummer an OL übermittelt werden soll.
Dann wird noch ein weiterer Job im BPM benötigt die sogenannte „Datenbank Analyse“ was nur eine SQL Abfrage ist die je nach Kunde eventuell etwas angepasst werden muss.
Als SQL Statement kann man hier folgendes hinterlegen :
ACHTUNG! Hier muss entsprechend der Mandant geprüft werden und die Besonderheit hier in dem Statement das wenn kein Gewicht im Artikel existiert im Beleg 1 KG eingetragen wird da ansonsten ein Fehler kommt und der Beleg nicht erzeugt werden kann.