Inhaltsverzeichnis

    Shopify-Connector über die JTL-Connector-App einrichten

    Wichtiger Hinweis: Aktuell ist der JTL-Connector für Shopify noch nicht über den Shopify-Store verfügbar. Diese Anleitung ist daher nur eingeschränkt gültig.

    Shopify an JTL-Wawi anbinden

    Was ist der JTL-Connector für Shopify?

    Der JTL-Connector ist eine von JTL entwickelte Schnittstelle, mit der Sie Ihren Shopify-Shop aus JTL-Wawi heraus pflegen können. Der Connector wurde so entwickelt, dass Sie den initialen Datentransfer automatisiert vollziehen können. Auf dieser Seite erhalten Sie zunächst allgemeine Informationen zum JTL-Connector für Shopify.

    Warnhinweis

    Merksatz: Ihr Warenwirtschaftssystem führt! Nach der Installation des Connectors und dem ersten Datenabgleich wird Ihre JTL-Wawi federführend sein und Sie dürfen keine Daten mehr im Backend Ihres Shop-Systems ändern – weder Artikel, Kategorien noch sonstige Benutzerdaten. Änderungen an Datensätzen dürfen Sie ausschließlich über Ihre JTL-Wawi vornehmen!

    Einsatzmöglichkeiten

    Wofür kann ich den Shopify-Connector einsetzen?

    • Sie möchten Shopify als neues Shop-System nutzen (Sie nutzen JTL-Wawi um Ihren Shopify-Shop automatisiert zu befüllen und zu pflegen)
    • Sie möchten Shopify als zusätzliches Shop-System nutzen (Sie nutzen JTL-Wawi zusammen mit dem Multishop-Modul und pflegen mehrere Shop-Systeme parallel)
    • Sie möchten Shopify als Shop-System ablösen (Sie nutzen den JTL-Connector, um Daten aus Ihrem Shopify-Shop einzuziehen, in JTL-Wawi zu speichern und von dort in ein neues Shop-System einzuspielen)

    Voraussetzungen

    Was müssen Sie beachten, wenn Sie den Shopify-Connector verwenden möchten?

    JTL-Wawi:

    • Version: ab JTL-Wawi 1.3.20, der JTL-Connector für Shopify ist prinzipiell für alle Versionen ab JTL-Wawi 1.0 lauffähig. In Versionen kleiner als JTL-Wawi 1.3.20 kann es jedoch zu unerwarteten Fehlern kommen.
    • Sie haben Ihre Datenbank gesichert.
    • Sie möchten Shopify als Shop-System ablösen (Sie nutzen den JTL-Connector, um Daten aus Ihrem Shopify-Shop einzuziehen, in JTL-Wawi zu speichern und von dort in ein neues Shop-System einzuspielen)

    JTL-Connector:

    • Sie haben eine Lizenz für Ihren JTL-Connector aktiviert.

    Shop-System:

    • Sie benötigen einen aktiven Shopify-Shop.
    Wichtiger Hinweis: Der Produktivbetrieb des Connectors funktioniert nicht im Wartungsmodus Ihres Shop-Systems! Deaktivieren Sie den Wartungsmodus, sobald Sie den Connector testen möchten.

    Einschränkungen

    Der Funktionsumfang von Shopify und JTL-Wawi ist nicht deckungsgleich. Was bedeutet das für Sie?

    Die im Standardumfang integrierten Datenfelder der beiden Systeme werden sich in der Regel voneinander unterscheiden. Dies kann sowohl den Inhalt wie die Struktur der Daten betreffen.

    Downloads

    JTL-Connector für Shopify: Sie müssen den JTL-Connector für Shopify nicht installieren, da Shopify eine Online-Anwendung ist.

    JTL-Wawi: Zum Download von JTL-Wawi auf der Website von JTL

    JTL-Connector für Shopify aktivieren

    Schritt 1: JTL-Connector App in Shopify aktivieren

    Zunächst müssen Sie im Backend Ihres Shopify-Shops die JTL-Connector App aktivieren. Gehen Sie dazu folgendermaßen vor:

    1. Melden Sie sich im Backend von Shopify an. Klicken Sie in der Seitenleiste auf Apps. Es öffnet sich die Seite Apps.
    1. Klicken Sie auf die Verlinkung Visit Shopify App Store. Es öffnet sich die der App Store von Shopify.
    1. Suchen Sie über die Suchleiste nach der App JTL-Connector. Klicken Sie auf das Suchergebnis. Die Detailseite der JTL-Connector App öffnet sich.
    1. Klicken Sie auf die Schaltfläche Add App. Sie gelangen nun zur Installationsseite für die App.
    2. Klicken Sie auf die Schaltfläche Install app. Es startet der Installationsvorgang für die App.
    1. Melden Sie sich über den zentralen Login von JTL im JTL-Kundencenter an. Falls Sie noch keine Zugangsdaten zum JTL-Kundencenter haben, können Sie diese hier erstellen: Zum JTL-Kundencenter. Nach der Authentifizierung gelangen Sie zur Konfigurationsseite für den JTL-Connector.
    1. Konfigurieren Sie den JTL-Connector für Shopify nach Ihren Bedürfnissen.

    Ihnen stehen folgende Optionen zur Verfügung:

    Onlineshop-URL: Hier sehen Sie die Onlineshop-URL, die später in der Onlineshop-Anbindung in JTL-Wawi angegeben werden muss (siehe Schritt 3).


    Passwort: Hier sehen Sie das Passwort, das später in der Onlineshop-Anbindung in JTL-Wawi angegeben werden muss (siehe Schritt 3).


    Hauptsprache von JTL-Wawi: Geben Sie hier an, welche Sprache die Standardsprache in JTL-Wawi ist. In der Regel ist dies Deutsch (German).


    Onlineshop-Sprache: Sprache, in der die Produkte in Ihrem Shopify-Shop angeboten werden.


    Mehrwertsteuersätze: Manchmal funktioniert die Steuersatzerkennung über den Shopify-Shop nicht, bspw. wenn Tax Overrides verwendet werden. In so einem Fall können alle im Shop vorhandenen Steuersätze an dieser Stelle definiert werden. Für Deutschland könnte das z. B. 7 und 19 sein.


    Shopify-SKU als Artikelnummer importieren: Beim Import von Produkten aus dem Shopify-Shop in JTL-Wawi wird die in Shopify hinterlegte SKU als Artikelnummer verwendet. Da in Shopify allerdings SKUs mehrfach vergeben werden können, sollten Sie vorsichtig bei der Nutzung dieser Option sein. Falls Sie SKUs mehrfach verwenden, sollten Sie diese Option lieber deaktivieren. Die Artikelnummern werden dann anhand der in JTL-Wawi definierten Nummernkreise generiert.


    Aufträge ab einem bestimmten Datum importieren: Hier können Sie angeben, ab welchem Datum eingegangene Aufträge importiert werden sollen. Ältere Aufträge stehen Ihnen nicht in JTL-Wawi, sondern lediglich in Shopify zur Verfügung.


    Shopify-Metafelder in JTL-Wawi über Attribute verwalten für…: Über Metafelder kann ein Shopify-Shop erweitert werden. Normalerweise ist es sinnvoll, diese für Produkte und Produkt-Varianten in JTL-Wawi zu verwalten. Dort können auch neue Metafelder angelegt und bestehende bearbeitet werden. Metafelder werden in JTL-Wawi als Attribute gespeichert und beginnen mit dem Präfix „meta_“.

    Achtung: Durch das Abfragen von Metafeldern wird der Abgleich langsamer, da für jedes Element (Collection/Produkt/Kunde/Bestellung) ein zusätzlicher API-Call ausgeführt werden muss. Zum Vergleich: 50 Produkte ohne Metafelder können in ca. 10 Sekunden abgerufen werden. Mit Metafeldern dauert der gleiche Abruf ca. 60 Sekunden.

    Schritt 2: Lizenz für JTL-Connector aktivieren

    Als nächstes müssen Sie die Lizenz für den JTL-Connector für Shopify aktivieren. Diesen Schritt müssen Sie nur einmal pro JTL-Kundenkonto durchführen. Wenn Sie also einen zweiten oder dritten Shopify-Shop an JTL-Wawi anschließen möchten, entfällt dieser Schritt.

    1. Melden Sie sich im JTL-Kundencenter unter kundencenter.jtl-software.de an.
    2. Navigieren Sie zum Bereich Lizenzen > JTL-Connector.
    3. Klicken Sie für Shopify auf die Schaltfläche Buchen. Führen Sie den Buchungsvorgang durch.

    Schritt 3: JTL-Connector in JTL-Wawi einrichten

    Nun müssen Sie den JTL-Connector in JTL-Wawi einrichten.

    1. Öffnen Sie dazu JTL-Wawi und klicken Sie im Menü auf Onlineshop > Onlineshop-Anbindung. Es öffnet sich das Dialogfenster Übersicht Ihrer Onlineshops.
    2. Klicken Sie auf Anlegen. Es öffnet sich das Dialogfenster Onlineshop-Anbindung.
    3. Tragen Sie unter Onlineshop-URL die URL Ihres Connectors (siehe Schritt 1) und unter Passwort den Connector Token (ebenfalls Schritt 1) ein. Klicken Sie auf Verbindung testen / Lizenz aktivieren.

    Hinweise

    Mehrsprachigkeit

    Mehrsprachigkeit innerhalb der Shopify Welt kann durch den Einsatz mehrerer Shopify Shops erreicht werden. Dank Wawi ist trotzdem die zentralisierte Verwaltung von Artikeln, Kunden sowie Bestellungen möglich. Dafür muss für jeden Shop ein eigener Connector eingerichtet und in den Einstellungen des Connectors im Kundencenter die entsprechende Shop Sprache gesetzt werden. Wenn Texte bspw. für einen Artikel nicht in der Shop-Sprache vorliegen, werden die Texte in der Hauptsprache von JTL-Wawi hinterlegt.

    Shopify Collections

    In Shopify werden Kategorien durch sogenannte Collections abgebildet. Es gibt zwei Arten von Collections:

    • Custom Collection
    • Smart Collection

    Da Smart Collections nicht sinnvoll über JTL-Wawi steuerbar sind, werden bei einem Shopify-zu-JTL-Wawi-Abgleich nur Custom Collections importiert und bei einem JTL-Wawi-zu-Shopify-Abgleich Kategorien als Custom Collections angelegt.

    Kategorien in JTL-Wawi

    Es ist zu empfehlen in JTL-Wawi eine eigene Wurzelkategorie für den/die Shopify Connector/en anzulegen.

    In Shopify gibt es nur ein Kategorie-Level. Aus diesem Grunde wird ein Artikel, der einer Unterkategorie angehört, bei einem Abgleich der jeweilig höchsten übergeordneten Kategorie (Level 1) zugeordnet.

    Produktbilder bei Variationsartikeln

    In Shopify besteht ein Variationsartikel aus einem Produkt, an welchem die verschiedenen Produktvarianten hängen. Bilder können dabei nur dem Produkt zugewiesen werden. Allerdings ist es möglich ein bestimmtes Produktbild mit einer Produktvariante zu verknüpfen, welches dann im Shopify-Shop angezeigt wird, wenn die entsprechende Variante ausgewählt wurde. Es kann allerdings immer nur ein Bild mit einer Variante verknüpft werden.

    Um das in JTL-Wawi abbilden zu können, werden alle Produktbilder dem Vaterartikel zugewiesen. Lediglich das Bild, welches mit einer Produktvariante verknüpft ist, wird in JTL-Wawi am entsprechenden Kindartikel hinterlegt. Aufgrund der Einschränkung, dass in Shopify nur ein Produktbild mit einer Produktvariante verknüpft werden kann, wird bei Abgleich lediglich das Bild mit der höchsten Priorität eines Kindartikels hochgeladen.

    Shopify Meta Felder

    Shopify Meta Felder für Produkte, Produktvarianten, Kunden und Bestellungen können in JTL-Wawi über Attribute verwaltet werden. Damit Meta Felder über JTL-Wawi verwaltet werden können, müssen die entsprechenden Checkboxen in den Einstellungen des Connectors im Kundencenter gesetzt sein.

    Folgendes ist bei dem Umgang mit „Meta Attributen“ zu beachten:

    • Meta Feld Attribute beginnen immer mit meta_. Das Attribut „meta_field“ repräsentiert also ein Meta Feld mit dem Namen „field“.
    • Meta-Felder in Shopify besitzen einen Namespace. Der Namespace kann durch einen Doppelpunkt an den Namen des Attributes angehängt werden (meta_field:namespace). Ist dieser nicht angehängt (meta_field), wird der „global“-Namespace verwendet.

    Shopify Tax Overrides

    Leider ist es über die Shopify Admin API nicht möglich, Steuersätze zu ermitteln, die per Tax Override Feature festgelegt wurden. In diesen Fällen müssen die Steuersätze händisch in den Einstellungen des Connectors im Kundencenter festgelegt werden (siehe: Mehrwertsteuersätze, kommasepariert). Ansonsten kann es in JTL-Wawi Probleme beim Setzen der richtigen Steuerklasse eines Artikels geben.

    Produktspezifische Attribute für Shopify

    Folgende Produktattribute existieren, über die Eigenschaften von Shopify-Produkten und -Produktvarianten in JTL-Wawi gesetzt werden können:

    • vendor: Der Hersteller
    • product_type: Der Produkt-Typ
    • tags: Kommaseparierte Liste
    • barcode: Ein beliebiger Barcode
    • barcode_type: Typ, der bei einem Shopabgleich vom Connector ermittelt wird. Zulässig sind EAN, ISBN und UPC
    • sku: Die in Shopify hinterlegte SKU beim Import in JTL-Wawi. Beim Senden eines Artikels von JTL-Wawi in einen Shopify-Shop kann hier eine SKU angegeben werden. Ist das Attribut nicht gesetzt, wird die Artikelnummer aus JTL-Wawi im Shopify-Shop als SKU hinterlegt.
    Die Attribute vendor, product_type und tags werden bei Variationsartikeln nur beim Vater-Artikel gesetzt, barcode, barcode_type und sku nur bei den Kind-Artikeln.

    Datenbanksicherung

    Beim Transfer großer Datenmengen kann es stets zu Fehlern kommen, die die Integrität der Daten gefährden (Anwendungsfehler, Verbindungsfehler usw.). Stellen Sie daher unbedingt sicher, dass Sie Ihre Datenbank von JTL-Wawi vor Einsatz des JTL-Connectors sichern – insbesondere bevor Sie den Onlineshop-Abgleich starten!

    Bedenken Sie bitte außerdem, dass Sie mit dem Onlineshop-Abgleich möglicherweise große Datenmengen abgleichen werden (z.B. viele Bilddateien). Der initiale Onlineshop-Abgleich kann entsprechend lange dauern. Reservieren Sie sich ein entsprechendes Zeitfenster, um Einrichtung und initialen Datentransfer durchzuführen sowie sich mit wichtigsten Funktionen der Systeme vertraut zu machen.

    Daten von JTL-Wawi an Shopify übertragen

    Ihre Aufgabe / Ausgangslage

    Sie haben den JTL-Connector erfolgreich in JTL-Wawi eingerichtet. In JTL-Wawi befinden sich bereits Artikel und Kategorien. Ihr Shopify-Shop ist noch leer.

    Schritt 1: Wurzelkategorie anlegen

    Im ersten Schritt sollten Sie eine Wurzelkategorie für Ihren Shopify-Shop erstellen. Gehen Sie dazu folgendermaßen vor:

    1. Wechseln Sie in JTL-Wawi in den Bereich Artikel und klicken Sie auf Kategorie anlegen. Es öffnet sich das Dialogfenster Neue Kategorie anlegen.
    1. Geben Sie der Kategorie einen passenden Namen, z. B. „Shopify“ und klicken Sie auf Speichern.
    1. Erstellen Sie nun auf die gleiche Weise Unterkategorien bzw. verschieben Sie bestehende Kategorien in die neu angelegte Wurzelkategorie.
    Hinweis: Shopify unterstützt nur eine Kategorie-Ebene unterhalb der Wurzelkategorie. Alle Artikel, die sich in Unterkategorien der 2. oder noch tieferer Ebene befinden, werden automatisch in der obersten Kategorie angezeigt.
    1. Fügen Sie den neu angelegten Kategorien alle Artikel hinzu, die Sie in Ihrem Shopify-Shop anbieten möchten.
    1. Doppelklicken Sie erneut auf die Wurzelkategorie, um die Kategoriestammdaten zu öffnen.
    2. Aktivieren Sie unter dem Punkt Aktivierung für Onlineshops Ihren Shopify-Shop. Schließen Sie das Dialogfenster anschließend über die Schaltfläche Speichern.

    Schritt 2: Connector konfigurieren

    1. Öffnen Sie über das Menü Onlineshop > Onlineshop-Anbindung das Dialogfenster Übersicht Ihrer Onlineshops.
    2. Doppelklicken Sie auf Ihren Shopify-Shop. Es öffnet sich das Dialogfenster Onlineshop-Anbindung.
    3. Klicken Sie neben dem Punkt Wurzelkategorie auf die Schaltfläche Kategorie wählen. Es öffnet sich das Dialogfenster Kategorien wählen.
    1. Markieren Sie die in Schritt 1 erstellte Wurzelkategorie und klicken Sie auf Wählen. Das Fenster wird geschlossen und Sie sehen wieder das Dialogfenster Onlineshop-Anbindung.
    1. Klicken Sie im Dialogfenster Onlineshop-Anbindung auf Connector konfigurieren. Es öffnet sich das Dialogfenster Shopkonfiguration.
    1. Aktivieren Sie im Bereich Synchronisation den Punkt Daten zum Onlineshop senden. Wählen Sie Artikel komplett und aktivieren Sie auch die Option Bilder. Klicken Sie anschließend auf Speichern und schließen Sie alle offenen Dialoge.

    Schritt 3: Komplettabgleich durchführen

    Nun können Sie einen Komplettabgleich für Ihren Shopify-Shop durchführen.

    1. Wählen Sie dazu im Menü Onlineshop den Punkt Komplettabgleich. Es öffnet sich das Fenster Komplettabgleich vorbereiten.
    2. Markieren Sie für Ihren Shopify-Shop den Punkt Alles und klicken Sie auf Speichern.
    1. Wählen Sie Menü Onlineshop den Punkt Onlineshop-Abgleich. Es öffnet sich das Dialogfenster Onlineshop-Abgleich. Klicken Sie dort auf Starten. Der Onlineshop-Abgleich wird nun durchgeführt.
    Hinweis: Die Dauer des Abgleichs hängt unter anderem von der Sortimentsgröße und Ihrer Internetverbindung ab.

    Weiteres Arbeiten mit Shopify

    Sobald Ihre Artikel übertragen sind, können diese von Kunden in Ihrem Shopify-Shop erworben werden. Sobald ein Auftrag erstellt wurde, kann dieser über einen Onlineshop-Abgleich abgeholt werden und normal, wie alle anderen Aufträge auch, mit JTL-Wawi und JTL-WMS ausgeliefert werden.

    Daten von Shopify an JTL-Wawi übertragen

    Ihre Aufgabe / Ausgangslage

    Sie haben bereits einen laufenden Shopify-Shop und möchten nun gerne JTL-Wawi verwenden. Aktuell ist Ihre Datenbank von JTL-Wawi noch komplett leer. Die Einrichtung von Shopify in JTL-Wawi haben Sie grundlegend schon abgeschlossen.

    Schritt 1: Wurzelkategorie anlegen

    Sie sollten für Ihren Shopify-Shop immer eine Wurzelkategorie verwenden. Dazu können Sie ganz einfach eine neue leere Kategorie in JTL-Wawi anlegen.

    1. Geben Sie der Kategorie einen Namen, z. B. „Shopify“ und klicken Sie auf Speichern.

    Schritt 2: Onlineshop-Anbindung konfigurieren

    1. Öffnen Sie in JTL-Wawi über das Menü Onlineshop > Onlineshop-Anbindung das Dialogfenster Übersicht Ihrer Onlineshops.
    2. Doppelklicken Sie auf Ihren Shopify-Shop, um das Dialogfenster Onlineshop-Anbindung zu öffnen. Klicken Sie dort auf die Schaltfläche Connector konfigurieren. Es öffnet sich das Dialogfenster Shopkonfiguration.
    1. Wählen Sie im Fensterbereich Synchronisation den Punkt Daten aus dem Onlineshop importieren. Markieren Sie alle Daten, die Sie importieren möchten.
    1. Schließen Sie das Fenster über die Schaltfläche Speichern. Klicken Sie anschließend im Dialogfenster Onlineshop-Anbindung neben dem Punkt Wurzelkategorie auf die Schaltfläche Kategorie wählen.
    1. Wählen Sie die in Schritt 1 angelegte Wurzelkategorie und klicken Sie auf Wählen. Schließen Sie anschließend das Dialogfenster Onlineshop-Anbindung über die Schaltfläche OK.

    Schritt 3: Abgleich durchführen

    Nun können Sie einen Abgleich mit Ihrem Shopify-Shop durchführen und so alle Daten in JTL-Wawi importieren.

    1. Öffnen Sie das Dialogfenster Onlineshop-Abgleich über das Menü Onlineshop > Onlineshop-Abgleich.
    2. Klicken Sie auf die Schaltfläche Starten. Der Onlineshop-Abgleich wird nun durchgeführt.

    Nach einem erfolgreichen Abgleich finden Sie alle Artikel, Aufträge und Kunden in JTL-Wawi.