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
Der Retourenmaster-Client besteht nur aus einer EXE-Datei, die auf allen modernen Windows-Plattformen (x86) lauffähig ist. Kopiere die Datei auf deinen Server, auf dem der JTL-Worker läuft. Dies ist notwendig, weil der Retourenmaster-Client über zeitversetzte JTL-Workflows gesteuert wird. Desweiteren benötigt der Retourenmaster-Client eine Internetverbindung, um die Retourenetiketten erzeugen zu können, und einen Zugang zu deiner 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. Der Retourenmaster-Client nimmt keine Veränderungen an deinem Windows außerhalb dieses Unterordners vor.
Konfiguration mittels Einstellungen.txt Starte den Retourenmaster-Client einmalig, es werden nun zwei Dateien erzeugt, license.key und Einstellungen.txt . Die Datei Einstellungen.txt ist eine einfache Textdatei mit "NAME = Wert"-Zuweisungen. Die einzelnen Einstellungen sind ausgiebig kommentiert.
Wichtig ist in der Einstellung.txt die Einstellung "SICHERHEITSSCHLUESSEL". Der Wert wird automatisch beim ersten Programmstart des Retourenmasters auf einen sicheren und einmaligen Wert voreingestellt. Du kannst diesen Wert in der Einstellungen.txt so belassen, du musst ihn zusätzlich im Retourenmaster JTL-Shop Plugin hinterlegen. Mit diesem Schlüssel wird die Kommunikation zwischen Retourenmaster Shop Plugin und dem Retourenmaster-Client abgesichert.
Wenn alle Einträge in der Einstellungen.txt vorgenommen wurden, kannst du den Retourenmaster-Client starten und laufen lassen. Der Retourenmaster-Client ist dafür ausgelegt, ähnlich wie der JTL-Worker dauerhaft auf deinem Rechner zu arbeiten.
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: