Shopify-Connector ü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.

Einsatzmöglichkeiten

• Shopify als Ihr neues Shop-System: Sie nutzen JTL-Wawi, um Ihren Shopify-Shop automatisiert zu befüllen und zu pflegen. Siehe 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. Siehe Daten von Shopify an JTL-Wawi übertragen

Voraussetzungen

• 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. JTL-Wawi herunterladen
• Edition/Paketkonfiguration: Sie haben eine Edition/Paketkonfiguration gebucht, in der die hier beschriebenen Softwarekomponenten enthalten sind. Die JTL-Editionen im Überblick
• JTL-Wawi-Datenbanksicherung: Sie haben Ihre Datenbank gesichert. Siehe Datenbank-Backup von JTL-Wawi erstellen
• Shopify-Shop: Sie haben einen aktiven Shopify-Shop. Mehr zum Thema siehe Dokumentation von Shopify
• JTL-Kundencenter: Sie haben Ihre Zugangsdaten für das JTL-Kundencenter zur Hand. Wenn Sie noch kein JTL-Kundencenter-Konto haben, erstellen Sie dieses Konto jetzt. Zum JTL-Kundencenter

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.

JTL-Connector für Shopify aktivieren

Schritt 1: JTL-Connector App in Shopify aktivieren

Aktivieren Sie zuerst im Backend Ihres Shopify-Shops die JTL-Connector-App JTL ERP‑Connector.

1. Melden Sie sich im Backend von Shopify an.
2. Rufen Sie im Shopify App Store die App JTL ERP-Connector auf. Zur App JTL ERP-Connector
3. Klicken Sie auf die Schaltfläche Installieren.

4. Sie sehen die Installationsseite der App. Prüfen Sie, auf welche Daten Ihres Shopify-Kontos die App zugreifen wird. Wenn Sie damit einverstanden sind, dass JTL ERP-Connector auf diese Daten zugreift, klicken Sie auf die Schaltfläche Installieren.

5. Sie sehen eine Quickstart-Seite. Scrollen Sie bis zum Ende der Seite und klicken Sie auf Mit JTL verbinden.

6. Sie werden zum zentralen Login von JTL geleitet. Melden Sie sich im JTL-Kundencenter an.

7. Nachdem Sie Shopify mit JTL-Wawi verbunden haben, werden Sie zur Konfigurationsseite für den JTL-Connector geleitet. Bestätigen Sie das Abonnement und klicken Sie auf Genehmigen.

8. Passen Sie den JTL-Connector an Ihre Anforderungen an.

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 Sprache 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 Steuersätze 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 aber mehrfach vergeben werden. Deshalb 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 nur 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 Metafelder für Produkte und Produkt-Varianten in JTL-Wawi zu verwalten. Dort können Sie auch neue Metafelder anlegen und bestehende Metafelder bearbeiten. Metafelder werden in JTL-Wawi als Attribute gespeichert und beginnen mit dem Präfix „meta_“.

Schritt 2: JTL-Connector in JTL-Wawi einrichten

Richten Sie jetzt den JTL-Connector in JTL-Wawi ein.

1. Öffnen Sie in JTL-Wawi das Menü Plattformen > Verkaufskanäle.
2. Sie sehen das Dialogfenster Verkaufskanalverwaltung. Klicken Sie auf die Schaltfläche Anlegen.
3. Wählen Sie im Dialogfenster Verkaufskanal mit JTL-Wawi verknüpfen die Option Drittshop – JTL-Connector und klicken Sie auf die Schaltfläche Hinzufügen.
4. Der Verkaufskanal wird zur Liste Alle Konten hinzugefügt. Die Registerkarte Allgemein des Verkaufskanals wird angezeigt. Wechseln Sie in die Registerkarte Verbindung.
5. 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.
6. Klicken Sie auf die Schaltfläche Verbindung testen.
7. Wechseln Sie in die Registerkarte Zuordnungen und wählen Sie im Bereich Kundengruppen die gewünschte Kundengruppe für JTL-Wawi.
8. Klicken Sie auf die Schaltfläche Speichern. Der JTL-Connector ist jetzt angebunden.

Weitere Besonderheiten

Mehrsprachigkeit

Mehrsprachigkeit erreichen Sie 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 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 nur CustomCollections importiert. Bei einem Abgleich von JTL-Wawi zu Shopify werden Kategorien als CustomCollections angelegt.

Kategorien in JTL-Wawi

Wir empfehlen Ihnen, in JTL-Wawi eine eigene Wurzelkategorie für Shopify-Connectoren anzulegen. In Shopify gibt es nur ein Kategorie-Level. Aus diesem Grund wird ein Artikel, der einer Unterkategorie angehört, bei einem Abgleich der jeweils 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 aber ein bestimmtes Produktbild mit einer Produktvariante verknüpfen. Das ausgewählte Produktbild wird dann im Shopify-Shop angezeigt, wenn die Variante ausgewählt wurde. Sie können immer nur ein Bild mit einer Produktvariante verknüpfen.

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

Shopify-Metafelder

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

Beachten Sie die folgenden Hinweise, wenn Sie Meta-Attribute nutzen:

• Metafeld-Attribute beginnen immer mit dem Präfix meta_. Beispiel: Das Attribut meta_field ist ein Metafeld mit dem Namen „field“.
• Metafelder in Shopify haben einen Namespace. Der Namespace kann durch einen Doppelpunkt an den Namen des Attributs angehängt werden (meta_field:namespace). Ist dieser Namespace nicht angehängt (meta_field), wird der Namespace global verwendet.
• Metafelder in Shopify haben 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 die Steuersätze nicht festlegen, kann es in JTL-Wawi Probleme beim Setzen der richtigen Steuerklasse eines Artikels geben. Siehe 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.

Datenbanksicherung

Beim Transfer großer Datenmengen kann es zu Fehlern kommen, die die Integrität der Daten gefährden (zum Beispiel durch Anwendungsfehler, Verbindungsfehler usw.). Stellen Sie deshalb 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, zum Beispie viele Bilddateien. Der initiale Onlineshop-Abgleich kann deshalb lange dauern. Reservieren Sie sich ein entsprechend großes Zeitfenster, um die Einrichtung und den initialen Datentransfer durchzuführen und 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. Siehe 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. Siehe Daten von Shopify an JTL-Wawi übertragen