Inhaltsverzeichnis

    Shopware 6 an JTL-Wawi anbinden

    Ihre Aufgabe/Ausgangslage

    Sie nutzen Shopware 6 und möchten den JTL-Connector verwenden, um Shopware 6 an JTL-Wawi anzubinden.

    Was ist der JTL-Connector (SaaS) für Shopware 6?

    Der JTL-Connector ist eine von JTL entwickelte Schnittstelle, mit der Sie Ihren Shopware 6-Shop aus JTL-Wawi heraus pflegen können. Der Connector wurde so entwickelt, dass Sie den initialen Datentransfer automatisiert vollziehen können.

    Achtung: Ihr Warenwirtschaftssystem führt! Das bedeutet, dass nach der Installation des 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

    Sie können den Shopware 6-Connectore in den folgenden Szenarien einsetzen:

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

    Voraussetzungen

    Wenn Sie den Shopware 6-Connector verwenden möchten, müssen Sie die folgenden Voraussetzungen erfüllen:

    JTL-Wawi:

    • Version: Der JTL-Connector für Shopware 6 ist prinzipiell für alle Versionen ab JTL-Wawi 1.0 lauffähig. In Versionen kleiner als JTL-Wawi 1.5.27.1 kann es jedoch zu unerwarteten Fehlern kommen.
    • Datenbank: Sie haben Ihre Datenbank gesichert.

    JTL-Connector:

    • Lizenz: Sie haben eine Lizenz für JTL-Connector in JTL-Wawi aktiviert.

    Shop-System:

    • Shopware 6-Shop: Sie verfügen über einen aktiven Shopware 6-Shop.

    Einschränkungen

    Der Funktionsumfang von Shopware 6 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 (SaaS) für Shopware 6: Sie müssen den JTL-Connector für Shopware 6 nicht installieren, da Shopware 6 eine Online-Anwendung ist.

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

    Datenbanksicherung

    Achtung: Sichern Sie Ihre Datenbank von JTL-Wawi vor Einsatz des JTL-Connectors! Beim Transfer großer Datenmengen kann es stets zu Fehlern kommen, die die Integrität der Daten gefährden (Anwendungsfehler, Verbindungsfehler etc.). Sichern Sie daher Ihre Datenbank bevor Sie den Onlineshop-Abgleich starten.

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

    JTL-Connector (SaaS) für Shopware aktivieren

    Schritt 1: Integration in Shopware 6 vorbereiten

    Zunächst müssen Sie im Backend Ihres Shopware 6-Shops eine Integration anlegen. Durch diesen Schritt erhalten Sie die Zugangsdaten, die Sie für die Verbindung der Systeme benötigen.

    1. Melden Sie sich im Backend von Shopware 6 an und wählen Sie Einstellungen > System > Integrationen.
    1. Klicken Sie auf die Schaltfläche Integration anlegen, um das Eingabefenster zu öffnen.
    2. Geben Sie im Feld Name einen Namen für die Integration an, z. B. JTL-Connector.
    3. Wählen Sie aus dem Dropdown-Menü eine Rolle aus, welche alle benötigten Berechtigungen besitzt. Mehr zum Thema Rollen in Shopware 6 lesen Sie hier.
    Alternative: Sie können an dieser Stelle auch die Option Administrator aktivieren. In diesem Fall ist es nicht notwendig, eine eigene Rolle für den JTL-Connector auszuwählen, die die benötigten Rechte hat.
    1. Notieren Sie sich die Zugangs-ID und den Sicherheitsschlüssel. Diese Daten benötigen Sie für die Buchung Ihrer JTL-Connector-Lizenz in Schritt 2.
    2. Klicken Sie abschließend auf Integration speichern.

    Schritt 2: Lizenz für JTL-Connector (SaaS) buchen

    In diesem Schritt müssen Sie die Lizenz für den JTL-Connector (SaaS) für Shopware 6 aktivieren.

    1. Melden Sie sich im JTL-Kundencenter unter kundencenter.jtl-software.de an.
    2. Navigieren Sie zum Bereich Produkte > Shop-Connectoren > Connector Verwaltung. Klicken Sie alternativ auf den folgenden Link, um direkt zur Übersicht der Connectoren im JTL-Kundencenter zu gelangen: Shop-Connectoren – Connector-Verwaltung
    1. Klicken Sie für JTL-Wawi zu Shopware 6 (SaaS) auf die Schaltfläche Lizenz erstellen.
    1. Prüfen und ergänzen Sie gegebenenfalls Ihre Firmendaten und klicken Sie auf Fortfahren.
    2. Geben Sie im Feld Onlineshop URL die Shop-URL inklusive  http(s):// an.
    3. Tragen Sie die Zugangs-ID und den Sicherheitsschlüssel  ein, die Sie sich in Schritt 1 notiert haben.
    1. Nehmen Sie die Einstellungen entsprechend Ihren Anforderungen vor. Zur Verfügung stehen Ihnen unter anderem:

    Für Kindartikel im Onlineshop den Namen des Vaterartikels übernehmen: Aktivieren Sie diese Option, damit für die Kindartikel im Onlineshop die Namen des jeweiligen Vaterartikels übernommen werden.


    Meta Description von Artikeln für den Onlineshop kürzen, wenn die Länge von 255 Zeichen überschritten wurde: Die maximal gültige Länge der Meta Description seitens Shopware beträgt 255 Zeichen, sobald diese überschritten wird, ist ein Abgleich nicht möglich. Wenn Sie diese Option aktivieren, wird die Meta Description von Artikeldaten auf 255 Zeichen gekürzt. Wir empfehlen Ihnen, diese Option zu aktivieren.


    Eigene Felder zum Onlineshop senden für Artikel/Kategorien: Ist diese Option aktiviert, werden die Eigenen Felder für Artikel und Kategorien an den Onlineshop übermittelt.


    1. Klicken Sie auf Speichern.
    2. Scrollen Sie an den Anfang der Seite, dort sehen Sie Connector-URL und den Connector-Token. Notieren Sie sich diese.
    3. Sie können das Fenster jetzt schließen.

    Schritt 3: JTL-Wawi mit Ihrem Shopware 6-Shop verbinden

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

    1. Öffnen Sie dazu JTL-Wawi und klicken Sie im Menü auf Plattformen > Verkaufskanäle. Das Dialogfenster Verkaufskanalverwaltung öffnet sich.
    1. Klicken Sie auf Hinzufügen. Das Dialogfenster Neues Konto anlegen öffnet sich.
    2. Wählen Sie in dem Dropdown-Menü Verkaufsweg die Option JTL-Connector und bestätigen Sie mit OK.
    1. Wechseln Sie in die Registerkarte Verbindung und geben Sie im Bereich Verbindungseinstellungen die Onlineshop URL und den JTL-Connector Token, den Sie sich in Schritt 2 notiert haben, ein und klicken Sie auf Verbindung testen.
    1. Wechseln Sie in die Registerkarte Zuordnungen und bestimmen Sie im Bereich Kundengruppe die Kundengruppe für JTL-Wawi.
    Hinweis: Wenn Sie in der Registerkarte Allgemein weitere Einstellungen zur Übertragung vornehmen und die Checkbox Auftragsnummer aus dem Shop verwenden aktivieren, müssen Sie sicherstellen, dass sich die Konfigurationen der jeweiligen Nummernkreise unterscheiden. Wenn Sie die Nummernkreise gleich konfigurieren, können Fehler in JTL-Wawi auftreten. Lesen Sie mehr zum Thema hier: Überschneidung von Nummernkreisen vermeiden.
    1. Schließen Sie das Dialogfenster mit Speichern.