JTL Wawi mit Shopify verbinden — der Connector im Überblick

Der JTL Connector Shopify verbindet JTL-Wawi mit eurem Shopify-Store — Artikel, Bestände, Bestellungen und Versanddaten laufen automatisch zwischen beiden Systemen. Kein manueller Abgleich, kein doppelter Pflegeaufwand. Vlarom richtet den Connector ein, konfiguriert das Mapping und sorgt für stabilen Betrieb.

Der Connector läuft als Managed SaaS bei JTL — kein eigener Server, keine eigene Hosting-Infrastruktur notwendig. Seit Januar 2026 erfolgt die Installation ausschließlich über den Shopify App Store. Wer noch eine Custom-App-Installation betreibt: die funktioniert weiter, aber neue Installationen laufen nur noch über den Store.


JTL-Wawi ist das Herzstück — der Connector ist die Verbindung zu Shopify. Ohne ihn landet keine Shopify-Bestellung automatisch in der Wawi, kein aktualisierter Bestand im Shop, kein Tracking-Link beim Kunden.

Was synchronisiert wird: Artikel, Varianten, Kategorien, Preise und Verfügbarkeiten fließen fortlaufend zwischen Shop und Wawi. Bestellungen aus Shopify kommen in die Wawi, Versandstatus und Tracking-IDs gehen zurück. Kundendaten werden beim ersten Bestelleingang automatisch in JTL angelegt. Zusätzlich synchronisiert der Connector Metafields — damit lassen sich Shopify-App-Erweiterungen wie individuelle Produktoptionen steuern.

Ein wichtiger Unterschied zum JTL Connector WooCommerce: Bei Shopify betreibt JTL den Connector als SaaS auf eigenem Cluster-Hosting. Ihr braucht keinen eigenen Connector-Server. JTL übernimmt Updates, Monitoring und Failover — das ist ein echter Vorteil gegenüber selbst gehosteten Lösungen.

Mehrere Shopify-Shops lassen sich ohne Aufpreis an eine JTL-Wawi-Instanz anbinden. Mehr zur offiziellen Connector-Dokumentation findet ihr im JTL Guide. Den Connector direkt im Shopify App Store findet ihr unter JTL ERP-Connector.

Häufige Fehlerquellen die wir in der Praxis sehen: Webhook-Timeouts wenn Shopify-Events nicht korrekt empfangen werden, Variantenmapping das bei Produktupdates auseinanderfällt, und Auth-Fehler nach Shopify-App-Berechtigungsänderungen. All das lässt sich durch saubere Erstkonfiguration und dokumentiertes Setup deutlich reduzieren.


Wir sehen regelmäßig, wo Connector-Projekte scheitern: nicht bei der Installation, sondern beim Mapping. Shopify hat eine eigene Datenbankstruktur für Varianten, Metafields und Tags — wer die nicht sauber auf JTL-Felder abbildet, hat hinterher falsche Bestände oder fehlende Produktdaten im Shop. Als JTL Service Partner Gold kennen wir diese Fallstricke und konfigurieren von Anfang an sauber.

Wer wissen will, wie eine Echtzeit-Anbindung in der Praxis aussieht: Für innocigs.com haben wir einen eigenen Konnektor gebaut. Er synchronisiert Shopify-Bestellungen, Bestände und Produktdaten in Echtzeit mit JTL-Wawi — mit eigener Fehlerlogik für Randszenarien, die ein Standardkonnektor nicht abdeckt. Die Arbeit dahinter ist dokumentiert, nicht bloß beschrieben.


Was Vlarom beim JTL Connector Shopify übernimmt

Von der Ersteinrichtung über das Variantenmapping bis zur Fehlerbehebung nach Updates — alles aus einer Hand.

Connector-Einrichtung

Installation über den Shopify App Store, API-Verbindung herstellen, Testlauf mit echten Artikeln vor dem Produktivstart. Vlarom dokumentiert jede Konfigurationsentscheidung.

Variantenmapping

Shopify-Varianten (Größe, Farbe, Material) auf JTL-Attribute mappen — sauber und vollständig. Fehler beim Variantenmapping sind die häufigste Ursache für falsche Bestände.

Bestandsabgleich konfigurieren

Sync-Intervalle, Lagerort-Zuordnung, Puffermengen — Vlarom richtet den Bestandsabgleich so ein, dass kein Overselling entsteht, auch bei schnell drehenden Artikeln.

Fehlerbehebung & Updates

Shopify-Updates verändern API-Strukturen und App-Berechtigungen. Vlarom prüft vor relevanten Updates und behebt Webhook-Timeouts, fehlgeschlagene Bestellimporte und Auth-Fehler direkt.

Metafields & Tags

Produktgruppenlogik über Tags, Shopify-App-Erweiterungen über Metafields — wer diese Felder sauber in der Wawi pflegt, spart manuelle Nacharbeit im Shop-Backend.

Multi-Shop-Anbindung

Mehrere Shopify-Shops in verschiedenen Sprachen oder Märkten an eine Wawi anbinden — ohne Aufpreis für weitere Shopify-Instanzen. Vlarom konfiguriert die Mandanten-Trennung korrekt.


10+

Jahre Erfahrung im JTL-Ökosystem

300+

Aktive JTL-Händler betreut

100%

JTL Service Partner Gold


Voraussetzungen für den JTL Connector Shopify

Bevor der Connector eingerichtet werden kann, klären wir im ersten Gespräch welche Voraussetzungen auf Shopify- und Wawi-Seite erfüllt sein müssen. Wer das vorab weiß, spart Zeit beim Einrichtungstermin.

Shopify-Plan: Der Connector läuft auf allen Shopify-Plänen. Wichtige Ausnahme: Ab dem 24. Januar 2024 überträgt Shopify personenbezogene Kundendaten (Name, Adresse, E-Mail) nur noch an Apps die auf dem Grow-Plan oder höher laufen. Wer auf dem Basic-Plan bleibt, bekommt keine Kundendaten mehr in die Wawi. Bestellungen kommen an, aber ohne Kundenzuordnung. Shopify Plus bietet zusätzlich höhere API-Limits und stabilere Webhooks — bei hohem Bestellvolumen ist das eben ein echter Unterschied.

JTL-Wawi-Version: Mindestens JTL-Wawi 1.9 wird benötigt. Ab dieser Version läuft die GraphQL-API-Kommunikation vollständig. Seit Juni 2025 kommuniziert der Connector ausschließlich über GraphQL, alte REST-Endpoints sind abgekündigt.

App-Store-Pflicht seit Januar 2026: Neue Connector-Installationen laufen ausschließlich über den Shopify App Store. Custom-App-Installationen die vor diesem Datum eingerichtet wurden, funktionieren weiter, werden von JTL aber nicht mehr aktiv unterstützt.

Datenbank: JTL-Wawi läuft auf MS SQL Server oder SQL Express (Wawi-Standard). Eine laufende Wawi-Installation ist Voraussetzung, der Connector verbindet sich direkt mit der Wawi-Datenbank.


Häufige Fehler beim JTL Connector Shopify — und wie ihr sie löst

„Shopify begrenzt die Anzahl der API-Anfragen pro Zeitfenster. Wenn der Connector zu viele Artikel-Updates oder Bestandsabfragen in kurzer Zeit schickt, antwortet Shopify mit dem HTTP-Fehler 429. Der Sync bricht ab, Bestände laufen auseinander. Die Lösung: im Connector das Sync-Intervall verlängern (z.B. von 5 auf 15 Minuten) und die Batch-Größe pro Sync-Durchlauf reduzieren. Shopify Plus bietet deutlich höhere Rate-Limits, bei hohem Artikelvolumen lohnt sich der Plan-Upgrade auch aus diesem Grund.“

„Diese Fehlermeldung erscheint wenn ein Artikel in Shopify mehreren Lagerorten zugeordnet ist, der Connector aber nur einen Lagerort kennt. Shopify erlaubt pro Artikel genau einen aktiven Standort pro Bestandsdatensatz. Der Fix liegt im Lagerort-Mapping der Connector-Konfiguration: prüfen welcher Shopify-Lagerort dem JTL-Lagerort entspricht und die Zuordnung eindeutig setzen. Bei Multi-Warehouse-Setups muss das Mapping für jeden Lagerort einzeln konfiguriert werden.“

„Wenn Bestellungen in Shopify eingehen aber nicht in der JTL-Wawi ankommen, liegt das häufig an einem Fulfillment-Service-Konflikt. Shopify leitet Bestellungen nur dann an den Connector weiter, wenn kein konkurrierender Fulfillment-Service für denselben Artikel aktiv ist. Lösung: im Shopify-Backend unter Einstellungen → Versand und Lieferung unter dem Menüpunkt „Versand und Lieferung“ prüfen ob ein externer Fulfillment-Service den Artikel beansprucht. Wenn ja, diesen entfernen oder die Artikel-Zuordnung korrigieren. Der Connector muss als einziger Fulfillment-Service für die betreffenden Artikel eingetragen sein.“

„Seit Juni 2025 nutzt der JTL Connector ausschließlich die Shopify GraphQL-API. Wer noch eine ältere Connector-Version (vor 2.x) betreibt, bekommt Verbindungsfehler weil die alten REST-Endpoints nicht mehr antworten. Lösung: Connector-Version im JTL-Backend prüfen und auf die aktuelle Version updaten. Nach dem Update müssen in Shopify neue App-Berechtigungen bestätigt werden. Ohne diese Bestätigung baut der Connector keine funktionierende Verbindung auf. Wir helfen bei diesem Update wenn ihr nicht sicher seid welche Schritte nötig sind.“

„Seit dem 24. Januar 2024 überträgt Shopify personenbezogene Daten (Kundenname, Lieferadresse, E-Mail) nur noch an Apps die auf dem Shopify Grow-Plan oder höher laufen. Auf dem Basic-Plan kommen Bestellungen zwar an, aber ohne Kundendaten. In der Wawi erscheint dann kein Kundenname. Das ist keine Fehlfunktion des Connectors, sondern eine Plattform-Entscheidung von Shopify. Lösung: Shopify-Plan auf Grow oder höher upgraden. Danach überträgt der Connector die Kundendaten wieder vollständig. Bestehende Bestellungen ohne Kundendaten können nicht nachträglich angereichert werden.“


So läuft die Shopify-Connector-Einrichtung bei Vlarom

Von der ersten Anfrage bis zum stabilen Produktivbetrieb — klar strukturiert, ohne Überraschungen.

1.Schritt 1: Voraussetzungen prüfen (30 Min.)

Vlarom prüft JTL-Wawi-Tarif, Shopify-Plan und ob die nötigen Berechtigungen im Shopify-Backend vorhanden sind. Bei Shops die nach dem 24.01.2024 erstellt wurden, braucht ihr mindestens den Shopify Grow-Plan für die Übertragung personenbezogener Daten — das klären wir vorab.

2.Schritt 2: App installieren und Verbindung herstellen (1 Std.)

Installation des JTL ERP-Connectors aus dem Shopify App Store, API-Key-Konfiguration, Verbindungstest mit der Wawi. Ab Januar 2026 ist der App-Store-Weg Pflicht für Neuinstallationen — Custom-App-Methoden funktionieren für bestehende Installationen weiter, werden von JTL aber nicht mehr aktiv unterstützt.

3.Schritt 3: Mapping konfigurieren (1–2 Std.)

Artikel-Mapping, Variantenzuordnung, Kategoriestruktur, Steuerklassen, Preisfelder — Vlarom konfiguriert jede Zuordnung gezielt und dokumentiert die Mapping-Entscheidungen. Fehler hier verursachen später falsche Bestände oder fehlende Produktdaten.

4.Schritt 4: Testlauf und Bestandsabgleich (1 Std.)

Kein Go-Live ohne Testlauf. Vlarom überträgt eine Auswahl echter Artikel, prüft Bestände und Variantenlogik, löst eine Test-Bestellung aus und kontrolliert ob Tracking-Daten korrekt zurück an Shopify gehen.

5.Schritt 5: Produktivbetrieb und Dokumentation

Nach grünem Licht geht der Connector in den Produktivbetrieb. Vlarom dokumentiert Sync-Intervalle, Mapping-Konfiguration und API-Credentials — damit bei Shopify-Updates oder JTL-Versionsänderungen alles nachvollziehbar ist.


Hinweis

Was sich 2025 und 2026 am JTL Connector Shopify geändert hat

Zwei Breaking Changes haben in den letzten Monaten bestehende Connector-Setups beeinflusst. Wer im Betrieb ist und seit Mitte 2024 kein Update durchgeführt hat, sollte prüfen ob sein Setup noch vollständig funktioniert.

Juni 2025 — GraphQL-API-Pflicht: JTL hat die REST-API-Endpoints für den Shopify Connector abgekündigt. Seit Juni 2025 kommuniziert der Connector ausschließlich über die GraphQL-API. Bestehende Installationen die noch auf Connector-Versionen vor 2.x laufen, müssen auf die aktuelle Version updaten und dabei neue App-Berechtigungen in Shopify bestätigen. Wer dieses Update nicht durchgeführt hat, verliert die Verbindung zwischen Wawi und Shop.

Januar 2026 — App-Store-Pflicht für Neuinstallationen: Shopify hat Custom-App-Installationen für den JTL Connector für Neuinstallationen geschlossen. Neue Setups laufen ausschließlich über die offizielle App im Shopify App Store. Bestandsinstallationen über Custom-Apps bleiben funktionsfähig, werden von JTL aber nicht mehr aktiv weiterentwickelt.

März 2026 — Erweiterte API-Berechtigungen in Version 2.1.0: JTL hat den Shopify Connector am 25. März 2026 auf Version 2.1.0 aktualisiert. Die neue Version führt zwei zusätzliche Shopify-API-Berechtigungen ein: write_translations und read_translations. Wer den Connector über den Shopify App Store installiert hat, bekommt diese Berechtigungen automatisch, ohne manuellen Eingriff. Wer dagegen eine Custom-App-Installation über das JTL-Kundencenter betreibt, muss die Berechtigungen selbst nachziehen. Fehlen sie, schlägt der Artikel-Abgleich mit Fehlermeldungen wie „Invalid extra variables provided for ProductOptionUpdate query“ fehl, und Tracking-Übertragungen sowie Produktupdates brechen ab. Die nötigen Schritte: im Shopify-Backend unter Einstellungen den Bereich Apps öffnen, dort „Apps entwickeln“ wählen, die JTL-Integration aufrufen und die Konfiguration bearbeiten, anschließend im Suchfeld „translations“ eingeben und die Berechtigungen write_translations und read_translations aktivieren. Wenn ihr nicht sicher seid, ob euer Setup eine Custom-App-Installation ist oder ob das Update bei euch korrekt durchgelaufen ist, prüfen wir das gern.

Juni 2026 — Version 2.1.6 (automatisches Update, live seit 08.06.2026): Der Artikel-Abgleich läuft jetzt rund 2,5x schneller als in Version 2.1.5 — bei gleichem Datenvolumen sinken die Übertragungszeiten um rund 60 Prozent. Den Unterschied merkst du vor allem, wenn dein Shop viele Varianten hat und sich Bestände häufig ändern. Vier Tickets sind raus: CO-3222 korrigiert eine falsche Datentyp-Zuordnung bei Meta-Feldern, CO-3430 behebt einen Fehler beim Product Pull, CO-3431 beseitigt den Fehler „Invalid extra variables provided for ProductOptionUpdate query“ bei Variationsnamen mit Schrägstrich, und CO-3433 bringt ein Partial-Sync-Error-Handling — ein fehlerhafter Einzeldatensatz bricht den Abgleich nicht mehr komplett ab. Drei Einschränkungen solltest du kennen: Die Performance-Verbesserung gilt nicht für Bildübertragungen, Shopify lehnt Bilder über 25 Megapixel ab, und doppelte SEO-URLs passt der Connector automatisch an. Das Update rollt automatisch aus, du musst nichts anstoßen. Falls danach Meta-Felder fehlen oder Varianten nicht mehr vollständig ankommen, meld dich — wir schauen uns dein Setup an. Die Release-Details stehen im JTL-Forum.

→ JTL Connector Shopify im App Store


Häufige Fragen zum JTL Connector Shopify

Ja, der JTL Connector läuft auch mit Shopify Plus. Shopify Plus bietet erweiterte API-Limits und bessere Webhook-Stabilität — das kommt dem Connector direkt zugute. Bei hochvolumigen Shops mit vielen gleichzeitigen Bestellungen lohnt sich Plus auch aus Connector-Sicht. Für die meisten JTL-Händler reicht aber der Standard-Shopify-Plan.

Der Aufwand hängt von Artikelanzahl, Variantenstruktur und Mapping-Komplexität ab — eine konkrete Einschätzung folgt nach dem Erstgespräch. Der größte Aufwand steckt im Mapping: Varianten, Kategorien, Preisfelder und Tags müssen sauber auf JTL-Strukturen abgebildet werden. Bei Shops mit angepassten Produktstrukturen oder vielen Varianten verschiebt sich der Rahmen entsprechend.

Produktbilder werden nicht vom JTL Connector direkt synchronisiert. Bilder werden in Shopify gepflegt — der Connector überträgt Artikeldaten, Bestände und Bestellungen, aber keine Mediendateien. Wer Bilder aus JTL-Wawi in Shopify übertragen will, braucht dafür einen separaten Prozess oder ein zusätzliches Tool.

Der JTL Connector arbeitet mit der Wawi als führendem System. Bei Abweichungen gewinnt der Wawi-Bestand — Shopify-Bestände werden überschrieben. Wer Shopify als Lagerquelle nutzen will, muss das explizit in der Mapping-Konfiguration festlegen. In der Standardkonfiguration ist JTL-Wawi immer die Quelle.

Die Connector-Lizenz selbst ist in allen JTL-Tarifen enthalten — auch im kostenfreien JTL-Start. JTL berechnet transaktionsbasiert über flexible Bestellpakete je nach Auftragsvolumen. Hinzu kommen Vlarom-Kosten für Einrichtung und Betreuung — diese sind projektabhängig und werden nach einem kurzen Erstgespräch kalkuliert.

Bestehende Setups müssen auf Connector-Version 2.x oder höher aktualisiert werden. Das Update selbst ist unkritisch — es gibt keinen Datenverlust. Nach dem Update müssen in Shopify einmalig neue App-Berechtigungen bestätigt werden. Wer das nicht rechtzeitig erledigt, verliert die Verbindung zwischen Wawi und Shop. Bei Unsicherheit helfen wir beim Update-Prozess.

Ja. Wenn in JTL-Wawi eine Bestellung nur teilweise geliefert wird, überträgt der Connector den Versandstatus für die gelieferten Positionen einzeln zurück an Shopify. Der Kunde sieht im Shop-Frontend welche Positionen bereits unterwegs sind, ohne dass ihr manuell nachtragen müsst.

Ja. Standard-Shopify-Pläne erlauben maximal 100 Varianten pro Produkt (also 100 Kombinationen aus Größe, Farbe etc.). Shopify Plus erweitert dieses Limit auf 2.000 Varianten pro Produkt. Wer Artikel mit vielen Varianten über den Connector synchronisiert, sollte dieses Limit im Blick behalten. Artikel die das Limit überschreiten, werden nicht vollständig übertragen.

Retouren werden in JTL-Wawi angelegt und verarbeitet. Der Connector überträgt den aktualisierten Bestand nach der Retouren-Buchung zurück an Shopify, der Lagerbestand steigt entsprechend wieder an. Eine automatische Rückerstattung in Shopify löst der Connector nicht aus. Das muss manuell im Shopify-Backend oder über ein separates Rückerstattungs-Tool erfolgen.

Error 429 bedeutet dass die Shopify-API-Rate-Limit-Grenze überschritten wurde. Shopify erlaubt nur eine bestimmte Anzahl API-Anfragen pro Zeitfenster. Wenn der Connector zu viel auf einmal überträgt, wird er temporär blockiert. Lösung: Sync-Intervall verlängern, Batch-Größe reduzieren. Details dazu stehen weiter oben im Troubleshooting-Abschnitt.

Der Connector trägt keine Steuersätze selbst. Die Steuerklassen kommen aus JTL-Wawi. In Shopify sollten die automatischen Steuerberechnungen deaktiviert oder auf ‚Steuern nicht berechnen‘ gesetzt werden, sonst berechnen Shopify und Wawi parallel. Das ergibt Doppelberechnungen in der Bestellung. Wir prüfen diese Einstellung bei der Erstkonfiguration mit.


Shopify mit JTL-Wawi verbinden?

Schildert kurz welchen Shopify-Plan ihr nutzt, ob es eine Neueinrichtung ist oder ein bestehendes Setup optimiert werden soll, und welche Probleme ihr habt. Ruf uns an unter +49 30 91473862, schreib an info@vlarom.de oder nutze unser Kontaktformular.