JTL-Wawi-Schnittstelle: JTL-Wawi anbinden
JTL-Wawi lässt sich auf drei Wegen anbinden: über die Wawi API mit REST und GraphQL, über den JTL-Connector für gängige Shopsysteme und über Dateiimporte mit JTL-Ameise. Die Wawi API gibt es lokal und über JTL Cloud. Eine eigene Schnittstelle lohnt sich, wenn Ihr Zielsystem keinen fertigen Connector hat oder der Standardabgleich nicht reicht.
Was JTL-Wawi ist und wer es nutzt
JTL-Wawi ist die Warenwirtschaft der JTL-Software. Händler verwalten darin Artikel, Lager, Aufträge, Lieferungen und Rechnungen. Eingerichtet wird sie über einen Desktop-Client. Typisch ist ihr Einsatz als Zentrale zwischen Shop, Marktplätzen, Versand und Buchhaltung.
Welche Schnittstellen JTL-Wawi anbietet
| Weg | Was gilt laut JTL-Doku |
|---|---|
| Wawi API, OnPremise | REST und GraphQL auf dem Rechner oder im Netz des Händlers (Port 64110). Die App registriert sich, der Händler gibt sie unter „Admin > App-Registrierung“ frei und erhält einen API-Schlüssel, der nur einmal angezeigt wird. Aufrufe tragen den Header Authorization: Wawi <Schlüssel>. |
| Wawi API, Cloud | Gleiche API über api.jtl-cloud.com, wenn die Wawi mit JTL Cloud verbunden ist. Anmeldung per OAuth 2.0 Client Credentials über das JTL Partner Portal; das Token gilt eine Stunde, dazu kommt die Mandanten-ID im Header X-Tenant-ID. |
| JTL-Connector | Tauscht Artikel, Kategorien und Kundendaten in beide Richtungen mit Shopsystemen aus. Fertig verfügbar für Shopware 6, WooCommerce, Shopify und PrestaShop. |
| JTL-Ameise | Import und Export über Dateien, zum Beispiel CSV mit Artikeldaten oder Beständen. |
Für die Planung zählt vor allem der Betriebsort. Die OnPremise-Variante läuft dort, wo die Wawi läuft. Ein Dienst im Internet erreicht sie nur über die Cloud-Variante oder einen eigenen, abgesicherten Weg ins Firmennetz. Webhooks der Wawi API beschreibt die Übersichtsseite nicht. Wir planen deshalb mit kurzen Abfragetakten, bis ein Ereignisweg belegt ist.
Typische Verbindungen und Datenobjekte
- Auftrag aus dem Shop übernehmen, Status zurückmelden alle 15 Minuten
- Bestand an Shop und Marktplätze melden alle 15 Minuten
- Artikel und Preise an den Shop geben stündlich
- Rechnung und Gutschrift als Buchung übergeben täglich
- Lieferung mit Sendungsnummer an den Shop melden bei Versand
Häufige Verbindungen sind Shopware mit JTL-Wawi und JTL-Wawi mit DATEV. Die Takte sind Beispiele und werden pro Projekt festgelegt.
Wo Standard-Connectoren an Grenzen kommen
Systeme ohne Connector
Für Shops, Branchensoftware oder Buchhaltungen ohne fertigen Connector bleibt nur die Wawi API oder der Dateiweg.
Eigene Felder
Zusatzfelder, eigene Artikelmerkmale oder besondere Preislogik übertragen Standard-Connectoren oft nicht vollständig.
Erreichbarkeit
Steht die Wawi im Büro, muss die Verbindung auch bei Neustarts und Netzausfällen sauber wieder anlaufen.
Dateiimporte
Importe per Ameise sind praktisch, aber ohne Prüfung und Protokoll fallen fehlerhafte Zeilen erst spät auf.
Wie wir JTL-Wawi anbinden
Wir prüfen zuerst, ob ein JTL-Connector Ihren Fall abdeckt. Wenn nicht, bauen wir die Verbindung auf der Wawi API: in der Cloud-Variante, wenn die Wawi mit JTL Cloud verbunden ist, sonst mit einem kleinen Dienst im Firmennetz. Die App fordert nur die nötigen Berechtigungen an. Jeder Lauf wird protokolliert, Fehler werden wiederholt und gemeldet. Wo keine API passt, nutzen wir den Dateiweg mit Prüfung, siehe Anbindung ohne API.
Häufige Fragen
Hat JTL-Wawi eine API?
Ja, die Wawi API mit REST und GraphQL. Sie läuft lokal beim Händler oder wird über JTL Cloud erreicht.
Brauche ich den JTL-Connector oder eine eigene Schnittstelle?
Für Shopware 6, WooCommerce, Shopify und PrestaShop gibt es fertige Connectoren. Reichen deren Felder und Abläufe, ist das oft die günstigere Wahl. Eine eigene Schnittstelle lohnt sich bei anderen Systemen oder besonderen Regeln.
Kann die Wawi an DATEV angebunden werden?
Ja. Rechnungen und Gutschriften aus der Wawi lassen sich als Buchungsstapel an DATEV übergeben. Details stehen auf der Seite JTL-Wawi mit DATEV.
Quellen
- JTL Developer: ERP Integration Overview (Wawi API OnPremise und Cloud), abgerufen am 20.10.2026
- JTL-Guide: JTL-Connector, abgerufen am 20.10.2026
- JTL-Guide: FAQ zu Installation und Einrichtung (CSV-Import mit JTL-Ameise), abgerufen am 20.10.2026
Verbindungen mit JTL-Wawi
JTL-Wawi → DATEV
JTL-Wawi und DATEV nach dem Ende des Rechnungsdatenservice 2.0: was der Buchungsdatenservice abdeckt, wo Debitoren haken und wann eigener Code hilft.
Shopware → JTL-Wawi
Shopware 6 und JTL-Wawi: was der JTL-Connector abgleicht, warum der Abgleich hängen bleibt und wann eigener Code für Teile davon sinnvoll ist.
Passend dazu
JTL-Wawi → DATEV
JTL-Wawi und DATEV nach dem Ende des Rechnungsdatenservice 2.0: was der Buchungsdatenservice abdeckt, wo Debitoren haken und wann eigener Code hilft.
Shopware → JTL-Wawi
Shopware 6 und JTL-Wawi: was der JTL-Connector abgleicht, warum der Abgleich hängen bleibt und wann eigener Code für Teile davon sinnvoll ist.
Shop-ERP-Anbindung
Artikel, Bestände, Preise und Bestellungen automatisch zwischen Shop und Warenwirtschaft.
