JTL Connect ab JTL Wawi 1.10

Viele JTL-Kunden wollen wissen, ob es die Möglichkeit gibt, die Mails der Marktplätze anhand ihrer Bestellnummer automatisch einem JTL-Auftrag zuzuordnen – insbesondere die Kundennachrichten. Regulär versucht das JTL Connect Addon in GREYHOUND anhand der Absenderadresse nach passenden Aufträgen zu suchen, wobei bei der Marktplatz-Kommunikation leider nichts gefunden werden kann, da die Mails, welche über die Marktplätze selbst kommen, meist kryptische Absenderadressen haben oder alle von ein- und derselben globalen Absenderadresse des jeweiligen Marktplatzes kommen.

Die Bestellnummern stehen allerdings meistens im Betreff oder sind irgendwo im Inhalt der Mail enthalten. Gibt es hier einen Trick, sodass das JTL Addon die passenden Aufträge auch bei Marktplatz-Mails findet?

• Sofern die Bestellnummer am JTL-Auftrag geführt wird und sie in der Mail-Kommunikation vorkommt, gilt: Ja, das geht!

Im Folgenden ist beschrieben, wie man sicherstellen kann, dass das JTL-Addon auch anhand der Bestellnummer aus Marktplätzen wie Kaufland, Otto & Co. den passenden Auftrag findet.

Es gibt in GREYHOUND kostenlos im Lieferumfang enthaltenen Marktplatz-Regeln, die vollautomatisch Bestellnummern von Käufen erkennen, die via Marktplatz getätigt wurden. Die Regeln sorgen dafür, dass Bestellnummern automatisch in ein benutzerdefiniertes Feld namens Referenznummer geschrieben werden.

Aktuell ist dies möglich für folgende Markplätze:

• Amazon
• eBay
• Kaufland
• Otto

Damit dann auch anhand dieser Bestellnummern im JTL-Addon der passende Auftrag gefunden wird, ist lediglich einmal in den Einstellungen des JTL Connect Addons im Reiter „Datenübernahme“ folgende Konfiguration vorzunehmen:

Damit die Zuordnung vollautomatisch passieren kann, müssen entsprechend die folgenden Regeln (in aktuellster Version) im GREYHOUND Regelwerk vorhanden und aktiviert sein:

• Eingangsverarbeitung: Amazon
• Eingangsverarbeitung: eBay
• Eingangsverarbeitung: Kaufland
• Eingangsverarbeitung: Otto

Außerdem braucht es ein benutzerdefiniertes Feld namens „Referenznummer“. Falls noch nicht vorhanden, ist also bitte ein benutzerdefiniertes Feld namens „Referenznummer“ wie folgt anzulegen:

Möchte man weitere Marktplätze ergänzen, für die es bisher keine Standard-Regel gibt, ist dies natürlich auch möglich. Dazu ist folgendes nötig (in Kurzform): Via Regex die Bestellnummer auslesen, in ein benutzerdefiniertes Feld schreiben und im JTL-Addon im Reiter “Datenübernahme” einstellen, in welches Feld das geschrieben werden soll, sodass Elemente automatisch gematcht werden.

Die Langfassung zur Lösung eines solchen Vorhabens ist wie folgt:

• Ziel: Wir wollen in diesem Beispiel die Auftragsnummer aus Mails des Portals CHECK24 automatisch erkennen und dafür sorgen, dass das JTL Addon bei diesen Mails den passenden Auftrag zuordnen kann.
• Lösungsansatz: In jeder Kundenmail via CHECK24 kommt im Regelfall die Auftragsnummer vor – diese muss via Regel automatisch ausgelesen werden. Der Regelknoten hierfür lautet “Automatischer Wert“. Das Suchmuster wird im regulären Ausdruck an einem benutzerdefinierten Feld festgehalten. Zuletzt muss nur noch die Verknüpfung über die Addon-Einstellungen erfolgen.

1.) Regex am Userfield hinterlegen: Unter Einstellungen > Benutzerdefinierte Felder sollte es einen Eintrag namens „Referenznummer“ geben. Sollte noch kein gleichnamiges Feld vorhanden sein, ist ein neues Feld anzulegen. Das Feld muss am Ende wie folgt aussehen:

Im Feld Beschreibung muss „Referenznummer“ eingetragen sein. Im Reiter „Datenübernahme“ ist im Feld Regulärer Ausdruck der Suchausdruck einzutragen für das Portal, das man ergänzen will, in diesem Fall CHECK24:

\b(\d{4}-\d{7}-\d{1})\b

Tipp: Im Feld „Regulären Ausdruck prüfen“ kann man den Inhalt einer E-Mail kopieren, in der die Bestellnummer enthalten ist. Klickt man auf den grünen Pfeil neben „Ergebnisse“ kann man prüfen, ob der reguläre Ausdruck korrekt funktioniert – dort sollte dann die Bestellnummer angezeigt werden.

Exkurs: Es ist auch möglich, mehrere Abfragen für verschiedene Markplätze oder Portale in einem Feld zu speichern – es sind dafür nicht mehrere Felder nötig. Aufgrund der besseren Übersichtlichkeit bietet es auf jeden Fall an, ein benutzerdefiniertes Feld zu alles zu verwenden und nicht für jeden Marktplatz ein eigenes. Dazu einfach mit dem Pipe-Symbol für die Oder-Verknüpfung verschiedene Ausdrücke verbinden. Ein RegEx für Otto ODER Check24 ODER Amazon sähe zum Beispiel so aus:

\b(cbn4b[a-z0-9]{5})\b|\b(\d{4}-\d{7}-\d{1})\b|\b(\d{3}-\d{7}-\d{7})\b

2.) Anschließend via Regel die Bestellnummer(n) automatisch aus dem Inhalt ODER dem Betreff auslesen. Dazu ist erforderlich, folgende im Screenshot gezeigte Regelknoten sinnvoll in einer bestehenden Regel zu ergänzen, die als Trigger „Nachrichteneingang“ hat. VOR diesen Regelknoten müssen innerhalb der Regel eine oder mehrere Abfrage erfolgen, die die Auswahl der Elemente eingrenzt, auf welche diese Regelknoten angewandt werden, z. B. die Basics: Elementtyp = E-Mail, Absender = beispiel@marktplatz.de, Gruppe = Kundenservice. Je genauer man die Auswahl eingrenzt, desto besser, da reguläre Ausdrücke ressourcenintensiv sind und der Regeldurchlauf pro Element ziemlich lange dauert.

Wichtig: Sind beide Regelknoten wie gezeigt bei beiden Ausgängen miteinander verbunden, werden Inhalt ODER Betreff auf die Bestellnummer hin untersucht.

3.) Nun noch das benutzerdefinierte Feld mit dem Datenfeld des Addons „verbinden“. Das geht im Reiter “Datenübernahme” des JTL Addons:

4.) Fertig! Elemente, an welchen die Referenz erkannt wurde, sollten nun mit dem JTL-Auftrag gematcht werden. Oder anders ausgedrückt: Bei allen Mails via CHECK24, in denen eine Auftragsnummer enthalten ist, kann das JTL-Addon in GREYHOUND nun den passenden Auftrag zuordnen.