Inhaltsverzeichnis

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

    Ihre Aufgabe/Ausgangslage

    Sie möchten den JTL-Connector für Shopify über die JTL-Connector-App einrichten.

    Informationen zum JTL-Connector für Shopify

    Der JTL-Connector für Shopify ist eine Schnittstelle, die es Ihnen ermöglicht, Ihren Shopify-Shop aus JTL-Wawi heraus zu pflegen. Der JTL-Connector wurde so entwickelt, dass Sie den initialen Datentransfer automatisiert vollziehen können. Auf dieser Seite erhalten Sie Informationen dazu, wie Sie den JTL-Connector für  Shopify über die JTL-Connector-App einrichten.

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

    Einsatzmöglichkeiten

    • Shopify als Ihr neues Shop-System: Sie nutzen JTL-Wawi, um Ihren Shopify-Shop automatisiert zu befüllen und zu pflegen. Lesen Sie mehr zum Thema hier: Daten von JTL-Wawi an Shopify übertragen.
    • Shopify als Ihr zusätzliches Shop-System: Sie nutzen JTL-Wawi zusammen mit dem Multishop-Modul und pflegen mehrere Shop-Systeme parallel.
    • 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. Lesen Sie mehr zum Thema hier: Daten von Shopify an JTL-Wawi übertragen.

    Voraussetzungen

    Wenn Sie den JTL-Connector für Shopify verwenden möchten, müssen Sie die folgenden Voraussetzungen erfüllen:

    JTL-Wawi:

    • Version: Der JTL-Connector für Shopify läuft prinzipiell mit allen Versionen ab JTL-Wawi 1.0. In Versionen kleiner als JTL-Wawi 1.3.20 kann es jedoch zu unerwarteten Fehlern kommen.
    • Datenbank: Sie haben Ihre Datenbank gesichert. Lesen Sie mehr zum Thema hier: Datenbank-Backup von JTL-Wawi erstellen.

    JTL-Connector:

    Shop-System:

    Einschränkungen

    Der Funktionsumfang von Shopify und JTL-Wawi ist nicht deckungsgleich. Das bedeutet, dass sich die im Standardumfang integrierten Datenfelder der beiden Systeme in der Regel voneinander unterscheiden werden. Dies kann sowohl den Inhalt als auch 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 und klicken Sie im Menü auf Apps > Alle empfohlene Apps. Der Dialog Für dich ausgewählt öffnet sich.
    1. Klicken Sie auf die Verlinkung Shopify App Store. Der App Store von Shopify öffnet sich.
    1. Geben Sie in der Suchleiste JTL-Connector ein und wählen Sie JTL ERP-Connector aus. Die Detailseite der JTL-Connector App öffnet sich.
    1. Klicken Sie auf Installieren. Die Installationsseite der App öffnet sich.
    1. Klicken Sie auf App installieren.
    1. Scrollen Sie an das Ende der Seite und klicken Sie auf Mit JTL verbinden. Sie gelangen zum zentralen Login von JTL.
    1. Melden Sie sich über den zentralen Login von JTL im JTL-Kundencenter an. Wenn Sie noch keine Zugangsdaten zum JTL-Kundencenter haben, können Sie diese hier erstellen: Zum JTL-Kundencenter. Nach der Authentifizierung gelangen Sie zu Konfigurationsseite für den JTL-Connector.
    1. Bestätigen Sie das Abonnement, wählen Sie eine Zahlungsmethode und klicken Sie auf Genehmigen.
    1. Konfigurieren Sie den JTL-Connector Ihren Anforderungen entsprechend.

    Die folgenden Optionen stehen Ihnen zur Konfiguration zur Verfügung:

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


    Onlineshop-Sprache: Geben Sie hier die Sprache an, in der die Produkte in Ihrem Shopify-Shop angeboten werden sollen.


    Steuersätze: Definieren Sie in diesem Feld die Steuersätze für Ihren Shop. Diese werden bei Tax Overrides verwendet. Für Deutschland können die Steuersätze beispielsweise 7% und 19% sein.


    Shopify-SKU als Artikelnummer importieren: Wenn Sie Produkte aus dem Shopify-Shop in JTL-Wawi importieren, wird die in Shopify hinterlegte SKU als Artikelnummer in JTL-Wawi verwendet. In Shopify können SKUs allerdings mehrfach vergeben werden. Daher sollten Sie diese Option ausschließlich mit Vorsicht verwenden. Wenn Sie SKUs mehrfach verwenden, sollten Sie diese Checkbox deaktivieren. Wenn Sie Artikel ohne SKU importieren, wird stattdessen die interne ID, die der Artikel in Shopify hat, als Artikelnummer in JTL-Wawi hinterlegt. Wenn Sie diese Checkbox aktiviert haben und es in Shopify Artikel mit doppelter SKU gibt, überschreiben sich die Artikel beim Import. Dies sollten Sie unbedingt vermeiden. Wenn der Artikel keine SKU hat, wird eine fortlaufende Zahl anstelle der SKU verwendet, beispielsweise 1-Shopify, 2-Shopify etc.


    Aufträge ab einem bestimmten Datum importieren: Aktivieren Sie diese Checkbox, um ein Datum anzugeben, ab dem eingegangene Aufträge importiert werden sollen. Ältere Aufträge stehen Ihnen nicht in JTL-Wawi, sondern ausschließlich in Shopify zur Verfügung.


    Shopify-Metafelder in JTL-Wawi über Attribute verwalten für…: Über Metafelder können Sie Ihren Shopify-Shop erweitern. Generell ist es sinnvoll, diese für Produkte und Produkt-Varianten in JTL-Wawi zu verwalten. Dort können Sie auch neue Metafelder anlegen und bestehende bearbeiten. 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! Beispiel: 50 Produkte ohne Metafelder können in ca. 10 Sekunden abgerufen werden. Mit Metafeldern dauert der gleiche Abruf ca. 60 Sekunden.

    Schritt 2: JTL-Connector in JTL-Wawi einrichten

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

    1. Öffnen Sie JTL-Wawi und klicken Sie im Menü auf Plattformen > Verkaufskanäle. Das Dialogfenster Verkaufskanalverwaltung öffnet sich.
    2. Klicken Sie auf die Schaltfläche Hinzufügen. Ein neuer Verkaufskanal wird angelegt.
    3. Wechseln Sie in die Registerkarte Verbindung und geben Sie im Bereich Verbindungseinstellungen die Onlineshop URL und den JTL-Connector Token (Passwort) ein. Sie finden diese Informationen im Backend Ihres Shopify-Shops unter Apps > JTL ERP-Connector > Connector-Konfiguration.
    4. Klicken Sie auf die Schaltfläche Verbindung testen.
    5. Wechseln Sie in die Registerkarte Zuordnungen und wählen Sie im Bereich Kundengruppen die gewünschte Kundengruppe für JTL-Wawi.
    6. Schließen Sie das Dialogfenster mit Speichern. Der JTL-Connector ist jetzt erfolgreich angebunden.

    Weitere Besonderheiten

    Mehrsprachigkeit

    Sie erreichen Mehrsprachigkeit durch den Einsatz mehrerer Shopify-Shops. Über JTL-Wawi können Sie Artikel, Kunden und Bestellungen für mehrere Shopify-Shops zentral verwalten. Dafür muss für jeden Shopify-Shop ein eigener JTL-Connector eingerichtet und in den Einstellungen des JTL-Connectors im JTL-Kundencenter die entsprechende Shop-Sprache gesetzt werden. Wenn Texte beispielsweise 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:

    • CustomCollection
    • SmartCollection

    SmartCollections sind nicht sinnvoll über JTL-Wawi abbildbar. Daher werden bei einem Abgleich von Shopify zu JTL-Wawi ausschließlich CustomCollections importiert und bei einem Abgleich von JTL-Wawi zu Shopify Kategorien als CustomCollections angelegt.

    Kategorien in JTL-Wawi

    Wir empfehlen Ihnen in JTL-Wawi eine eigene Wurzelkategorie für den/die Shopify-Connector/en anzulegen. In Shopify gibt es nur ein Kategorie-Level. Aus diesem Grund 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, in dem die verschiedenen Produktvarianten enthalten sind. Bilder können nur dem Produkt zugewiesen werden. Sie können allerdings ein bestimmtes Produktbild mit einer Produktvariante verknüpfen. Das ausgewählte Produktbild wird dann im Shopify-Shop angezeigt, wenn die entsprechende Variante ausgewählt wurde. Sie können immer nur ein Bild mit einer Produktvariante verknüpfen.

    Um dies in JTL-Wawi abzubilden, werden alle Produktbilder dem Vaterartikel zugewiesen. Ausschließlich das Bild, das mit einer Produktvariante verknüpft ist, wird in JTL-Wawi im entsprechenden Kindartikel hinterlegt. Da in Shopify nur ein Produktbild mit einer Produktvariante verknüpft werden kann, wird beim Abgleich ausschließlich das Produktbild eines Kindartikels mit der höchsten Priorität hochgeladen.

    Shopify Meta Felder

    Sie können Shopify Metafelder für Produkte, Produktvarianten, Kunden und Bestellungen über Attribute verwalten. Damit Sie dies tun können, müssen Sie die entsprechenden Checkboxen in den Einstellungen des JTL-Connectors im JTL-Kundencenter setzen.

    Folgendes müssen Sie beachten, wenn Sie Meta-Attribute nutzen:

    • Metafeld-Attribute beginnen immer mit meta_. Das Attribut meta_field repräsentiert beispielsweise ein Metafeld mit dem Namen „field“.
    • Metafelder in Shopify besitzen einen Namespace. Der Namespace kann durch einen Doppelpunkt an den Namen des Attributs angehängt werden (meta_field:namespace). Ist dieser nicht angehängt (meta_field), wird der Namespace global verwendet.
    • Meta-Felder in Shopify haben zudem einen Typ. Der Typ wird ebenfalls durch einen Doppelpunkt an den Namen des Attributs angehängt: (meta_field:namespace:type). Ist kein Typ im Attributnamen angegeben (meta_name[:namespace]), wird standardmäßig der Deprecated Typ String verwendet. Der Standardtyp String wird längerfristig durch einen nicht Deprecated Typ ersetzt. Welche Metafeldtypen existieren, können Sie hier nachlesen: https://shopify.dev/apps/metafields/definitions/types

    Shopify Tax Overrides

    Steuersätze, die Sie per Tax Override Feature festgelegt haben, können Sie nicht über die Shopify Admin API ermitteln. In diesen Fällen müssen Sie die Steuersätze händisch in den Einstellungen des JTL-Connectors in der App festlegen. Wenn Sie dies nicht tun, kann es in JTL-Wawi Probleme beim Setzen der richtigen Steuerklasse eines Artikels geben. Lesen Sie mehr zum Thema hier: Mehrwertsteuersätze, kommasepariert.

    Produktspezifische Attribute für Shopify

    Sie können die Eigenschaften von Shopify-Produkten und Produktvarianten in JTL-Wawi über die folgenden Produktattribute setzen:

    • vendor: Hersteller
    • product_type: Produkt-Typ
    • tags: Kommaseparierte Liste
    • barcode: Beliebiger Barcode
    • barcode_type: Barcode-Typ, der beim Shopabgleich vom JTL-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 können Sie hier eine SKU angeben. Ist das Attribut nicht gesetzt, wird die Artikelnummer aus JTL-Wawi im Shopify-Shop als SKU hinterlegt.
    Hinweis: Die Attribute vendor, product_type und tags werden bei Variationsartikeln nur beim Vaterartikel gesetzt, barcode, barcode_type und sku hingegen nur bei den Kindartikeln.

    Datenbanksicherung

    Beim Transfer großer Datenmengen kann es 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.

    Beachten Sie außerdem, dass Sie mit dem Onlineshop-Abgleich möglicherweise große Datenmengen abgleichen werden, beispielsweise viele Bilddateien. Der initiale Onlineshop-Abgleich kann entsprechend viel Zeit beanspruchen. Reservieren Sie sich ein entsprechendes Zeitfenster, um Einrichtung und initialen Datentransfer durchzuführen sowie sich mit den wichtigsten Funktionen der Systeme vertraut zu machen.

    Daten von JTL-Wawi an Shopify übertragen

    Nachdem sie den JTL-Connector erfolgreich in JTL-Wawi eingerichtet haben, können Sie jetzt die Artikel und Kategorien, die sich in JTL-Wawi befinden, an Ihren Shopify-Shop übertragen. Lesen Sie mehr zum Thema hier: Daten von JTL-Wawi an Shopify übertragen.

    Daten von Shopify an JTL-Wawi übertragen

    Sie nutzen bereits einen Shopify-Shop und möchten jetzt JTL-Wawi verwenden. Aktuell enthält die Datenbank von JTL-Wawi noch keine Positionen. Sie möchten daher die Daten von Shopify an JTL-Wawi übertragen. Lesen Sie mehr zum Thema hier: Daten von Shopify an JTL-Wawi übertragen.