Skip to main content
Die Integration JTL Wawi (API) verbindet die JTL-Wawi REST-API mit Chatarmin CX. So kannst du Bestellungen und Tracking abrufen und freigegebene Bestelländerungen ausführen.
Diese Anleitung gilt für JTL-Wawi ERP. FFN Connect / Fly verbindet dagegen Shopify mit einem Fulfillment-Lager.

​
Voraussetzungen

Kläre vor der Einrichtung:
  • Die JTL-Wawi REST-API und der App-Registrierungsdienst laufen.
  • Du kennst den Datenbanknamen nach /api/ in der URL, oft eazybusiness.
  • Ein JTL-Wawi-API-Benutzer ist für cx verfügbar.
  • Die API hat einen öffentlichen Hostnamen und einen erreichbaren Port.
  • Ein gültiges TLS-Zertifikat deckt diesen Hostnamen ab und wird von Standard-Clients akzeptiert.
Neue Verbindungen brauchen geprüftes HTTPS. Private Adressen und HTTP-Endpunkte funktionieren nicht.

​
Server-URL

Nutze die vollständige HTTPS-Basis-URL:
Zum Beispiel: https://wawi.beispiel.de:5883/api/eazybusiness. Der Port wird in JTL-Wawi festgelegt. 5883 ist häufig, aber nutze den Wert deines Administrators. Das letzte Pfadsegment ist der JTL-Datenbankname, nicht der Shop- oder Windows-Dienstname.

​
Netzwerk und Zertifikat

Chatarmin CX muss den API-Port aus dem öffentlichen Internet erreichen. Erlaube eingehendes TCP auf diesem Port in allen relevanten Windows-, Hypervisor-, Rechenzentrums- und Provider-Firewalls. Die aktuelle Chatarmin-Outbound-IP-Allowlist bekommst du beim Chatarmin-Support. Teste außerhalb deines Büronetzwerks, ohne die Zertifikatsprüfung abzuschalten:
JSON oder HTTP 401/403 bestätigt, dass Host und Port erreichbar sind. Ein Timeout weist meist auf Host, Port, Dienst oder Firewall hin. Ein Zertifikatsfehler muss vor der Verbindung mit cx behoben werden.
Wechsle nicht zu HTTP und umgehe die Zertifikatsprüfung nicht. Installiere oder erneuere das Zertifikat, liefere die vollständige Zertifikatskette aus und stelle sicher, dass der Name zum öffentlichen Hostnamen in der Server-URL passt. Lass das bei Bedarf vom Server- oder Hosting-Administrator korrigieren.

​
Einrichtung

1

JTL-Wawi REST-API starten

Starte die REST-API und stelle sie über geprüftes HTTPS bereit. JTL erklärt, wie du den REST-Server startest.
2

App-Registrierung in JTL-Wawi öffnen

Öffne am Wawi-Server Admin → JTL-Wawi API → App-Registrierungen, klick auf Hinzufügen und geh weiter, bis JTL-Wawi auf eine Registrierungsanfrage wartet. Lass den Bildschirm offen.
3

Verbindung in cx eintragen

Öffne JTL Wawi in den Integrationen, klick auf Konto hinzufügen und trage Integrationsname und geprüfte HTTPS-Server-URL ein. Klick erst auf Verbinden, wenn JTL-Wawi wartet.
4

Freigeben und abschließen

Gib chatarmin/v1 / chatarmin.com GmbH in JTL-Wawi frei. Setze den API-Benutzernamen, geh zurück zu cx, trage denselben Namen ein und klick auf Einrichtung abschließen.

​
Verbindung prüfen

Prüfe, ob das Konto als verbunden erscheint. Öffne dann ein Ticket zu einem bekannten JTL-Kunden und teste zuerst Bestell- und Tracking-Abfragen, bevor du Schreibaktionen aktivierst.

​
KI-Agenten-Aktionen

JTL-Aktionen können Bestellungen und Tracking abrufen, Lieferadressen oder Lieferdaten ändern und Bestellungen stornieren. Lass jede Schreibaktion auf Jedes Mal fragen, bis du das genaue Verhalten in JTL und im Lager mit repräsentativen Bestellungen geprüft hast.

​
Fehlerbehebung

Die JTL Wawi API-Dokumentation enthält die REST-Referenz des Herstellers.