JTL-Wawi verbinden (Beta)

API von außen freigeben

Die JTL-Wawi-API läuft oft im eigenen Firmennetz. Boardarc muss sie aus dem Internet erreichen können.

1. 1REST-API in der JTL-Wawi aktivieren.
2. 2Den Port (z. B. 5883) in Router/Firewall nach außen freigeben, nur für HTTPS.
3. 3Ein gültiges HTTPS-Zertifikat verwenden – Boardarc verbindet sich nicht über unverschlüsseltes HTTP.
4. 4Boardarc als App registrieren; du erhältst App-ID und API-Key.

Verbinden

1. 1Boardarc › Einstellungen › Workspace › Integrationen › ERP › JTL-Wawi.
2. 2API-Adresse, API-Key und App-ID eintragen (App-Version und „Ausführen als“ sind optional), „Verbinden“.

Abgleich

JTL-Wawi bietet keine Webhooks. Boardarc fragt alle 5 Minuten nach Änderungen (über das Änderungsdatum).

Datenquelle einrichten

1. 1Öffne ein Board und klicke oben auf „Datenquelle“.
2. 2Wähle „ERP“ und die JTL-Wawi-Verbindung, dann das Objekt (z. B. Aufträge) und optional Filter (Status, Kunde, Kanal).
3. 3Wähle den Zeitraum (nur neue, letzte X Tage, ab Datum) und prüfe die Vorschau mit Anzahl und Beispielen.
4. 4Klicke „Aktivieren“. Der Erst-Sync läuft im Hintergrund; danach wird alle 5 Minuten abgeglichen.

Mapping

Boardarc schlägt für jedes ERP-Feld eine passende Spalte vor (nach Name, dann nach Typ). Du kannst jede Zuordnung ändern oder leer lassen.

Status werden auf fünf gemeinsame Gruppen abgebildet: Angelegt, Freigegeben, Versendet, Abgeschlossen, Storniert. Positionen eines Auftrags erscheinen als Unteraufgaben.

Die Spalte „ERP-Verknüpfung“ zeigt die Belegnummer mit Link ins ERP und „Nachladen“.

Rückschreiben

Beta: JTL-Wawi wird nur gelesen. Rückschreiben ist für einzelne Felder vorbereitet, aber ausgeschaltet – Boardarc ändert nichts in JTL-Wawi.

Fehlerbehebung

„JTL-Wawi antwortet mit keiner Verbindung … – nicht erreichbar – ist die API von außen freigegeben?“: Port, Firewall und HTTPS prüfen.

„… mit 401 …“: API-Key oder App-ID werden abgelehnt – ist die App registriert und freigegeben?