Skip to main content
Die Integration JTL Wawi (API) verbindet deine JTL-Wawi-Instanz (On-Premise oder gehostet) mit Chatarmin CX, damit Agenten und KI-Agenten Bestellungen und Tracking abrufen und — wo du es erlaubst — Adressen ändern oder Bestellungen stornieren können.
Diese Anleitung gilt für JTL-Wawi ERP mit REST-API. Das ist nicht dasselbe wie FFN Connect / Fly, wo Shopify mit einem Fulfillment-Lager synchronisiert wird.

​
Wann du sie nutzt

Nutze JTL Wawi (API), wenn:
  • Bestellungen und Kunden in JTL-Wawi liegen (typisch im DACH-Raum)
  • der Support WISMO, Adressänderungen, Stornos oder Bestellkontext aus Wawi braucht
  • KI-Agenten Wawi-Daten lesen oder — mit Freigabe — schreiben sollen

​
Voraussetzungen

Bevor du in cx verbindest, kläre auf JTL-Seite:
  • JTL-Wawi REST-API-Dienst läuft — im JTL-Wawi Administrator ist der API-/App-Registrierungsdienst für externe Apps gestartet.
  • Du kennst das Datenbank-Segment in der API-URL — der Name nach /api/ (z. B. eazybusiness). Das ist der Datenbankname, nicht zwingend der Anzeigename des Windows-Dienstes.
  • Ein JTL-Wawi-Benutzer existiert — diesen Benutzernamen trägst du in cx ein, nachdem du die App in Wawi freigegeben hast.
  • Dein API-Port ist von außen erreichbar — Chatarmin CX ruft deinen Wawi-Server aus der Cloud auf. Der Port wird in JTL gesetzt (oft 5883, Kunden nutzen auch 5679, 50443 und andere). Private LAN-Adressen (z. B. 192.168.x.x) funktionieren nicht.

​
Server-URL-Format

In cx gibst du die volle Basis-URL der Wawi REST-API an:
Beispiele (gleicher Datenbankname, unterschiedliche Ports — nutze den Port, den euer Administrator konfiguriert hat):
  • https://wawi.beispiel.de:5883/api/eazybusiness
  • https://203.0.113.10:5679/api/eazybusiness
Nutze öffentlichen Hostnamen oder öffentliche IP, keine interne VM- oder Proxmox-LAN-Adresse. Das Segment nach /api/ ist der JTL-Datenbankname (oft eazybusiness), nicht euer Shop- oder Windows-Dienstname. Wenn in Wawi kein TLS-Zertifikat hinterlegt ist, probiere http:// statt https:// in der URL.
5883 ist der häufige Standard-API-Port. Verbundene Chatarmin-Konten nutzen kundenspezifische Ports — Host, Port und Datenbank immer vom JTL-Administrator übernehmen, nicht von einem anderen Shop.

​
Netzwerk und Firewall

Chatarmin CX muss eine eingehende TCP-Verbindung auf deinen Wawi-API-Port öffnen können (derselbe Port wie in der Server-URL). Konfiguriere alle relevanten Ebenen:
  1. Windows-Firewall auf dem Wawi-Server — eingehendes TCP auf den API-Port für den Wawi-Dienst erlauben, inkl. Profil Öffentlich, wenn der Server von außerhalb des LAN erreichbar sein soll.
  2. Hypervisor-/Rechenzentrum-Firewall (z. B. Proxmox) — denselben Port auf der VM freigeben; Standard-Drop blockiert cx, auch wenn Windows schon erlaubt.
  3. Edge-Firewall beim Hoster — wenn Wawi beim Provider läuft, eingehenden Traffic auf euren API-Port zur öffentlichen VM-IP freigeben lassen.
cx stellt ausgehende Verbindungen zu dir her (kein Callback zu uns). Für die aktuelle Outbound-IP-Allowlist wende dich an deinen Chatarmin-CX-Ansprechpartner oder Support — alte IPs aus Tickets nicht raten. Schnelltest außerhalb eures Büronetzwerks:
JSON oder HTTP 401/403 bedeutet: Port erreichbar. Timeout bedeutet: Firewall, falscher Host oder API-Dienst lauscht nicht.

​
JTL Wawi (API) einrichten

​
JTL-Wawi REST-API starten

Bevor du in cx verbindest, starte die JTL-Wawi-API auf deinem Server und stelle sicher, dass sie unter einem öffentlichen Hostnamen oder einer öffentlichen IP erreichbar ist (siehe Netzwerk und Firewall). JTL beschreibt den REST-Server-Start hier: API REST-Server starten.

​
In Chatarmin CX verbinden

1

Integrationen öffnen

Öffne die Integrationen und wähle JTL Wawi (API).
2

Server-URL eintragen

Klick auf Konto hinzufügen. Trage einen Integrationsnamen und deine Server-URL ein (z. B. https://wawi.beispiel.de:5883/api/eazybusiness). Klick noch nicht auf Verbinden — schließe zuerst den App-Registrierungs-Assistenten in JTL-Wawi ab (nächster Abschnitt).
3

In cx abschließen

Nach der Freigabe in JTL-Wawi: zurück in cx, JTL-Wawi-Benutzernamen eintragen (empfohlen: chatarmin/v1) und Einrichtung abschließen. Das Konto erscheint unter verbundenen Integrationen.

​
App in JTL-Wawi registrieren (vor Verbinden)

Der Assistent muss auf dem Bildschirm Warten auf Registrierungsanfrage stehen, bevor du in cx auf Verbinden klickst. Klickst du zu früh auf Verbinden, empfängt JTL die Anfrage nicht und der Ablauf wirkt hängend.
Am Wawi-Server-PC:
  1. JTL-Wawi öffnen und Admin → JTL-Wawi API → App-Registrierungen wählen.
JTL-Wawi Menü Admin bis JTL-Wawi API App-Registrierungen
  1. Auf Hinzufügen klicken. Der Registrierungs-Assistent startet.
JTL-Wawi API Anwendungsregistrierungen mit Hinzufügen-Button
  1. Auf der Einführungsseite Weiter klicken.
JTL-Wawi App-Registrierung Assistent Einführung
  1. Bei Registrierung beginnen wartet JTL-Wawi auf eine Registrierungsanfrage aus cx. Diesen Bildschirm offen lassen. Der Status zeigt, dass auf die Anwendung gewartet wird — Weiter bleibt deaktiviert, bis die Anfrage ankommt.
JTL-Wawi wartet auf Registrierungsanfrage der externen App
  1. Zurück in cx auf Verbinden klicken. In JTL-Wawi sollten die Anwendungsinformationen zu chatarmin/v1 / chatarmin.com (chatarmin.com GmbH) erscheinen.
JTL-Wawi empfangene Anwendungsinformationen für chatarmin/v1
  1. In JTL-Wawi Weiter klicken, API-Benutzernamen setzen (empfohlen: chatarmin/v1), Weiter durch die Zugriffsverwaltung und den Assistenten abschließen.
  2. In cx denselben Benutzernamen eintragen und Einrichtung abschließen klicken.

​
JTL Wawi im Posteingang

Wenn ein Ticket-Kontakt zu einem Wawi-Kunden passt, kann Bestellkontext in der Ticket-Seitenleiste erscheinen — ohne Wechsel nach Wawi.

​
KI-Agenten-Aktionen

JTL-Wawi-Aktionen können KI-Agenten z. B.:
  • eine Bestellung abrufen
  • Tracking abfragen
  • eine Lieferadresse ändern
  • Custom Fields oder Liefertermine aktualisieren
  • eine Bestellung stornieren (mit Stornogrund, wenn konfiguriert)
Lass Schreibaktionen auf Freigabe, bis Testläufe zu euren Lagerregeln passen. Bestehende Workflows können JTL-Aktionen weiter für feste Legacy-Abläufe nutzen.

​
Best practices

  • Nutze den Datenbanknamen im URL-Pfad — falsche Pfade wirken wie generische Verbindungsfehler.
  • Dokumentiere öffentliche URL und Firewall-Regeln mit dem Team für Proxmox/Hosting — cx kann Rechenzentrum-Firewall nicht aus dem Produkt heraus öffnen.
  • HTTPS, sobald ein Zertifikat in Wawi liegt; HTTP nur, wenn die API ohne TLS antwortet.

​
Troubleshooting

Für REST-Feldreferenz nach erfolgreicher Verbindung: JTL Wawi API-Dokumentation (Herstellerreferenz).