Shopware 6 an JTL-Wawi anbinden

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.

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

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.

Schritt 1: Integration in Shopware 6 vorbereiten

Zunächst legen Sie im Backend Ihres Shopware 6-Shops eine Integration an. 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.

2. Klicken Sie auf die Schaltfläche Integration anlegen, um das Eingabefenster zu öffnen.
3. Geben Sie im Feld Name einen Namen für die Integration an, z. B. JTL-Connector.
4. Wählen Sie aus dem Dropdown-Menü eine Rolle, die alle benötigten Berechtigungen besitzt. Mehr zum Thema Rollen in Shopware 6 lesen Sie hier.

5. 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.
6. Klicken Sie abschließend auf Integration speichern.

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

In diesem Schritt erstellen Sie die Lizenz für den JTL-Connector (SaaS) für Shopware 6. Je nachdem, ob Sie schon mit JTL-Wawi arbeiten und welche Edition Sie haben, unterscheidet sich die Vorgehensweise.

Möglichkeit 1: Shopware 6 buchen/aktivieren für Neukunden

1. Öffnen Sie den JTL-Store: Drittshopanbindungen
2. Wählen Sie die Option Paketkonfigurator. Sie werden zum Paketkonfigurator in Ihrem JTL-Kundenkonto weitergeleitet.
3. Prüfen Sie, welche Editionen und Pakete Sie buchen möchten, und durchlaufen Sie den gesamten Buchungsprozess bis zum Ende.
4. Klicken Sie in Ihrem JTL-Kundenkonto auf die Registerkarte Bestellungen & Lizenzen.
5. Navigieren Sie zum Menüpunkt Shop-Connectoren > Connector-Verwaltung und buchen/aktivieren Sie die Lizenz für Shopware 6.
6. Bestätigen Sie, dass Sie die Bestellung als Unternehmen und nicht als Privatperson tätigen, und klicken Sie auf die Schaltfläche Jetzt erstellen.
7. Geben Sie in das Feld Onlineshop URL die Shop-URL inklusive http(s):// ein.
8. Tragen Sie die Zugangs-ID und den Sicherheitsschlüssel  ein, die Sie sich in Schritt 1 notiert haben.

9. Nehmen Sie die Einstellungen gemäß Ihren Anforderungen vor. Zur Verfügung stehen Ihnen unter anderem die folgenden Optionen:

• 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.

10. Klicken Sie auf Speichern.
11. Scrollen Sie an den Anfang der Seite. Dort sehen Sie die Connector-URL und den Connector-Token. Notieren Sie sich diese Informationen.
12. Schließen Sie das Fenster.

Möglichkeit 2: Shopware 6 buchen/aktivieren für Bestandskunden mit korrekter Edition

1. Klicken Sie in Ihrem JTL-Kundenkonto auf die Registerkarte Bestellungen & Lizenzen.
2. Navigieren Sie zum Menüpunkt Shop-Connectoren > Connector-Verwaltung und buchen/aktivieren Sie die Lizenz für Shopware 6.
3. Bestätigen Sie, dass Sie die Bestellung als Unternehmen und nicht als Privatperson tätigen, und klicken Sie auf die Schaltfläche Jetzt erstellen.
4. Geben Sie in das Feld Onlineshop URL die Shop-URL inklusive http(s):// ein.
5. Tragen Sie die Zugangs-ID und den Sicherheitsschlüssel  ein, die Sie sich in Schritt 1 notiert haben.

6. Nehmen Sie die Einstellungen gemäß Ihren Anforderungen vor. Zur Verfügung stehen Ihnen unter anderem die folgenden Optionen:

• 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.

7. Klicken Sie auf Speichern.
8. Scrollen Sie an den Anfang der Seite. Dort sehen Sie die Connector-URL und den Connector-Token. Notieren Sie sich diese Informationen.
9. Schließen Sie das Fenster.

Möglichkeit 3: Shopware 6 buchen/aktivieren für Bestandskunden mit nötigem Editionswechsel

1. Öffnen Sie den JTL-Store: Drittshopanbindungen
2. Wählen Sie die Option Paketkonfigurator. Sie werden zum Paketkonfigurator in Ihrem JTL-Kundenkonto weitergeleitet.
3. Prüfen Sie, welche Editionen und Pakete Sie buchen möchten, und durchlaufen Sie den gesamten Buchungsprozess bis zum Ende.
4. Klicken Sie in Ihrem JTL-Kundenkonto auf die Registerkarte Bestellungen & Lizenzen.
5. Navigieren Sie zum Menüpunkt Shop-Connectoren > Connector-Verwaltung und buchen/aktivieren Sie die Lizenz für Shopware 6.
6. Bestätigen Sie, dass Sie die Bestellung als Unternehmen und nicht als Privatperson tätigen, und klicken Sie auf die Schaltfläche Jetzt erstellen.
7. Geben Sie in das Feld Onlineshop URL die Shop-URL inklusive http(s):// ein.
8. Tragen Sie die Zugangs-ID und den Sicherheitsschlüssel  ein, die Sie sich in Schritt 1 notiert haben.

9. Nehmen Sie die Einstellungen gemäß Ihren Anforderungen vor. Zur Verfügung stehen Ihnen unter anderem die folgenden Optionen:

• 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.

10. Klicken Sie auf Speichern.
11. Scrollen Sie an den Anfang der Seite. Dort sehen Sie die Connector-URL und den Connector-Token. Notieren Sie sich diese Informationen.
12. Schließen Sie das Fenster.

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

Nun richten Sie den JTL-Connector in JTL-Wawi ein.

1. Öffnen Sie dazu JTL-Wawi und klicken Sie im Menü auf Plattformen > Verkaufskanäle. Das Dialogfenster Verkaufskanalverwaltung wird angezeigt.

2. Klicken Sie auf Hinzufügen. Das Dialogfenster Neues Konto anlegen wird angezeigt.
3. Wählen Sie in dem Dropdown-Menü Verkaufsweg die Option JTL-Connector und bestätigen Sie mit OK.

4. 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, Punkt 9 notiert haben, ein und klicken Sie auf Verbindung testen.

5. Wechseln Sie in die Registerkarte Zuordnungen und bestimmen Sie im Bereich Kundengruppe die Kundengruppe für JTL-Wawi.

6. Schließen Sie das Dialogfenster mit Speichern.