INHALTSVERZEICHNIS
- Einrichtung Retourenmaster-Client für die JTL-Wawi
- Einrichtung der notwendigen JTL-WAWI Workflows
- DHL-Geschäftskundenportal Einstellungen prüfen
Einrichtung Retourenmaster-Client für die JTL-Wawi
Für jede größere WAWI-Version (bspw. 1.10 oder 1.11) bieten wir einen eigenen Client an. Dies ist notwendig, da sich die internen Strukturen zwischen den WAWI-Versionen unterscheiden können.
Die WaWi Clients findest du hier zum >> Download
Für jede neue JTL-WAWI-Version, wird es einen neuen Retourenmaster-Client geben. Dies ist notwendig, da sich die internen Strukturen innerhalb der Datenbank jederzeit ändern können und der Retourenmaster-Client davon abhängig ist.
Der Retourenmaster-Client besteht nur aus einer EXE-Datei, die auf allen modernen Windows-Plattformen (x86) lauffähig ist.
Der Retourenmaster-Client ist - ähnlich wie der JTL-Worker - als Dauerläufer konzipiert. Der Retourenmaster-Client benötigt eine Internetverbindung - um sich zum JTL-Shop zu verbinden, und einen Zugang zur JTL-WAWI-Datenbank.
Der Retourenmaster-Client sollte in einem eigenen Unterordner laufen, da beim ersten Programmstart benötigte Dateien angelegt werden, um die Konfiguration und Lizenz abzuspeichern. Unter %AppData%..\Local\Temp\retourenmaster werden zusätzlich temporäre Dateien abgelegt.
Weitere Änderungen wird der Retourenmaster-Client an Deinem Windows nicht vornehmen.
Für jeden Shop muss der Retourenmaster-Client einmal eingerichtet und gestartet werden.
Beim ersten Start des Retourenmaster-Clients öffnet sich der Einstellung-Tab - hier werden alle notwenigen Einstellungen vorgenommen. Mittels [?] kann zu jedem Punkt ein Hilfetext angezeigt werden.
Allgemeine Einstellungen
[JTL-Shop URL:]
Hier muss die JTL-Shop-URL eingetragen werden. Bitte gib die URL genauso ein, wie sie in der JTL-WAWI unter Plattformen > Verkaufskanäle > Webserver > JTL-Shop-URL: eingegeben ist.
[Sicherheitsschlüssel:]
Mit diesem Schlüssel wird die Kommunikation zum JTL-Shop zusätzlich abgesichert. Mit dem rechten Button (2 Pfeile) kannst Du jederzeit einen neune Schlüssel generieren. Du kannst auch einen eigenen Schlüssel eintragen, es gibt hier keine Einschränkungen. Wichtig: dieser Schlüssel muss im JTL-Shop-Retourenmaster-Plugin ebenfalls genauso eingetragen werden. Mit dem linken Button (Zwischenablage) kannst Du den Schlüssel bequem in die Zwischenablage kopieren.
[Auftrag bei Widerruf stornieren]
Diese Einstellung ist nur eine Checkbox.
Wenn der Haken gesetzt ist, werden Aufträge im JTL-Shop, die per Widerruf-Funktion widerrufen werden, sofort in der JTL-WAWI storniert. Da dies nicht immer gewünscht ist, kannst Du diese Funktion deaktivieren.
Wenn der Haken nicht gesetzt ist, und ein Rückhaltegrund mit dem Namen "Widerruf" existiert, dann wird statt der Stornierung der Rückhaltegrund gesetzt. Der Auftrag ist dann auch sofort für die Auslieferung gesperrt.
Zusätzlich wird bei beiden Einstellungsmöglichkeiten (Haken drin, Haken draußen) ein manuelles Workflow-Ereignis mit dem Namen "Widerruf" ausgelöst - sofern es existiert. Hier kannst Du beliebige Workflows hinterlegen und den Auftrag so individuell behandeln. (Bspw. bei Auslandsbestellungen eine Mail an die Export-Abteilung senden)
Datenbank
[Server:]
Hier muss die IP oder der Hostname des Datenbankserver eingetragen werden. Wichtig: bitte ohne Instanz oder Port eingeben. Beispiel: sql.hostname.de oder 192.168.2.5
[Port:]
Hier muss der TCP-Port, an dem die Datenbank erreichbar ist, eingetragen werden. Wenn der MSSQL-Server auf dem selben Rechner läuft, wie der Retourenmaster-Client, kannst Du einfach den Button [finde Port] drücken, hier wird dann der Port des ersten gefundenen SQL-Servers auf dem Rechner automatisch eingetragen. Solltest Du den MSSQL-Server extern hosten, oder keinen direkten Zugriff darauf haben, dann kannst Du den Port auch über folgenden Datenbank-Query herausfinden:
SELECT DISTINCT
local_net_address AS IP,
local_tcp_port AS Port
FROM sys.dm_exec_connections
WHERE local_tcp_port IS NOT NULL
ORDER BY local_tcp_port
Solltest Du auch keinen Query absetzen können, wende Dich bitte an Deinen Hoster, um den TCP-Port herauszufinden.
[Name:]
Hier muss der Name der Datenbank eingetragen werden. In JTL-Wawi ist das immer eazybusiness .
[Benutzer:]
Hier muss ein gültiger Benutzername für den MSSQL-Datenbankserver eingegeben werden. Der Benutzer benötigt Schreib- und Leserechte auf der Datenbank.
[Passwort:]
Hier muss das Passwort des oben eingegebenen Benutzers eingetragen werden. Das Passwort wird im Klartext in der lokalen Datei "Einstellungen.txt" abgespeichert. Sorge also dafür, dass der Rechner gesichert ist.
JTL Einstellungen
[Firma:]
Trage hier den Namen der Firma ein, unter welcher die Retouren in der JTL-WAWI angelegt werden sollen. Der Name muss genauso geschrieben sein, wie in der JTL-WAWI unter Admin > Firmen- und E-Mail-Einstellungen
[Lager:]
Trage hier das Lager ein, in welches die Retouren gebucht werden sollen. Der Name des Lager muss genauso geschrieben sei, wie in der JTL-WAWI unter Lager > Lager > Name des Lagers
[Benutzer:]
Trage hier einen JTL-WAWI Anmeldenamen ein, unter dem die Retoure angelegt werden soll. Der Benutzername muss genauso geschrieben sein, wie ein gültiger JTL-WAWI-Benutzer unter Admin > Benutzer / Rechte > Benutzer > Anmeldung
Weitere Besonderheiten
Falls einmal die Datenbank-Verbindung abbrechen sollte, wird der Retourenmaster-Client immer wieder, auf eine resourcenschonende Art, versuchen, eine neue Verbindung aufzubauen. Wenn die Verbindung zur Datenbank wieder hergestellt ist, wird der Retourenmaster-Client seine Arbeit fortsetzen.
Trotzdem kann es nicht schaden, ab und zu einmal auf die Meldungen im Tab Ausgabe zu schauen, um Fehler zu erkennen.
Eine neue Retoure
Kunden können im JTL-Shop Widerrufe oder Retouren zu einer Bestellung anlegen. Eine Retoure wird mit den ausgewählten Retourepositionen, dem Retourengrund und der gewünschten Aktion des Kunden in der JTL-WAWI angelegt. Zusätzlich werden alle JTL-Workflow-Ereignisse zu einer neuen Retoure und Retoureposition ausgelöst.
Über diese Funktion werden nun die Rücksendeetiketten des Kunden erzeugt und anschließend per Email an ihn versendet.
Der Vorteil ist, dass nun mit allen Versanddienstleistern, die in der JTL-WAWI eingerichtet sind und die eine Retouremöglichkeit bieten, Etiketten an den Kunden versendet werden können.
Es können über verschiedene JTL-Workflows auch für verschiedene Kunden verschiedene Versanddienstleister angesprochen werden bspw. der des Ursprungsauftrages.
Einrichtung der notwendigen JTL-WAWI Workflows
Wie kannst du nun steuern, welcher Auftrag ein kostenfreies Retourenetikett bekommt, und welcher nicht?
Dies geschieht mittels eines WAWI-Workflows, der eine Datei erzeugt, die der Retourenmaster-Client verarbeitet.
JTL-Workflow für den Retourenmaster-Client
- lege einen neuen Workflow unter Auftrag > Ausgeliefert an
- Gib dem Workflow einen Namen (Retourenmaster) und stelle oben rechts unter Ausführungsplan den Workflow auf Zeitverzögert bspw. 5 Minuten. Dies ist notwendig, damit der Workflow immer auf deinem Worker-Server ausgeführt wird, und nicht wie bei "sofort" auf den Packtischen
- lege eine Bedingung für den Workflow an: Lieferung.Lieferadresse.LandISO gleich DE, um bspw. nur für Aufträge nach Deutschland Retourenetiketten erzeugen zu können. Der Retourenmaster kann auch internationale Retourenetiketten erzeugen.
- lege eine weitere Bedingung an: Sonstiges.Plattform.Name gleich Onlineshop , damit nur Retourenetiketten für Bestellungen aus dem Onlineshop erzeugt werden.
- Workflow-Aktion: Datei schreiben, Pfad:
{{ Verzeichnisse.Desktop }}\Retourenmaster\Workflow\(bitte mit Installationspfad und Einstellung INPUT_DIR prüfen und anpassen), Dateiname:{{ Vorgang.Stammdaten.Auftragsnummer }}.txt, Dateiinhalt: 1 (eine Eins als Zahl) , Aktion bei vorhandener Datei: Ersetze bestehende Datei - Dateiinhalt: die Eins (1) bedeutet hier, dass für diesen Auftrag ein Retourenetikett erzeugt und in deinen Shop hochgeladen wird. Wenn du nicht möchtest, dass der Kunde ein kostenfreies Retourenetikett erhält, dann schreibe einfach statt der 1 eine 0 in die Datei. (bspw bei Aufträgen mit geringem Auftragswert). Dies geht nur mit einem weiteren Workflow, in den Bedingungen muss dann entsprechend gefiltert werden.
- wenn du bswp. mit dem Retourenmaster nur deine einfache Widerrufsmöglichkeit umsetzen möchtest, dann lasse immer eine 0 in die Datei schreiben. Deine Kunden können nun alle Shopbestellungen einfach widerrufen, so wie es der Gesetzgeber vorsieht.
- Dies ist natürlich nur ein Beispiel Workflow, du kannst auch mehrere Workflows für mehrere Lieferländer und/oder mehrere Onlineshops einrichten. Sprich uns an, wir helfen dir bei der Einrichtung.
JTL-Multishop Installation
Wenn du mehrere JTL-Onlineshops hast, und den Retourenmaster in mehreren Shops nutzen möchtest, dann musst du den Retourenmaster für jeden Shop in einem eigenen Unterordner einrichten und starten.
Über die JTL-Workflows musst du dann die einzelnen Shops filtern, hier eine "Erweiterte Eigenschaft" (bitte nur ab JTL-WAWI 1.6 nutzen), die dir den Namen des Shops zurückgibt:
{% capture query %}
SELECT TOP 1
ISNULL(tShop.cName, '') AS cShopName
FROM Verkauf.tAuftrag
JOIN tShop ON tShop.kShop = Verkauf.tAuftrag.kShop
WHERE Verkauf.tAuftrag.cAuftragsNr = '{{ Vorgang.Stammdaten.Auftragsnummer
}}'
{% endcapture -%}
{% assign result = query | DirectQueryScalar -%}
{{ result }}So kannst du nach deinen einzelnen Shops filtern und die Workflows richtig aufteilen.
DHL-Geschäftskundenportal Einstellungen prüfen
Einstellung DHL-Rücksendeadresse prüfen
Gehe bitte in das DHL-Geschäftskundenportal und prüfe unter "Paket & Waren" > Retoure > Einstellungen > "Allgemeine Einstellungen" die Einstellung "EMPFÄNGER DHL RETOURE ONLINE"
Hier musst du für jedes Land, für welches du Retourenetiketten erzeugen möchtest, eine Adresse hinterlegen unter der "Receiver Id" als kleingeschriebener! ISO3-Code (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3). Für Deutschland ist das "deu".
Solltest du Probleme bei der Einrichtung des Retourenmasters haben, kontaktiere uns, wir helfen dir gern weiter.
Tags: