Wechseln zu: Navigation, Suche

Einführung zum JTL-Connector für WooCommerce

Verwandte Themen:


Was ist der JTL-Connector für WooCommerce?

Der JTL-Connector ist eine von JTL entwickelte Schnittstelle, mit der Sie Ihren WooCommerce-Shop aus der JTL-Wawi heraus pflegen können. Der Connector wurde so entwickelt, dass Sie den initialen Datentransfer automatisiert vollziehen können. Drei typische Anwendungsfälle sind denkbar:

An einen aktiven WooCommerce-Shop eine JTL-Wawi anschließen

Sie arbeiten bereits mit WooCommerce und haben dort einen Datenbestand aufgebaut.
Jetzt möchten Sie eine leere JTL-Wawi mit den Daten aus Ihrem Shop automatisiert befüllen.

Einen neuen WooCommerce-Shop mithilfe einer aktiven JTL-Wawi befüllen

Sie arbeiten bereits mit JTL-Wawi und möchten einen, bisher leeren WooCommerce-Shop automatisiert befüllen.

Bestandsdaten aus JTL-Wawi und WooCommerce zusammenführen

Sie arbeiten bereits mit JTL-Wawi als auch mit einem WooCommerce-Shop. Jetzt möchten Sie die Daten beider Systeme zusammenführen und zukünftig den WooCommerce-Shop aus JTL-Wawi heraus pflegen.

Auf dieser Seite erhalten Sie zunächst allgemeine Informationen zum JTL-Connector für WooCommerce. Im Anschluss schildern wir Ihnen für die genannten Anwendungsfälle separat die Einrichtung des Connectors sowie den initialem Datentransfer (mit Videodokumentation). Im Anschluss gehen wir auf die Besonderheiten des Connectors im laufenden Betrieb ein. Einführende Informationen über die JTL-Connectoren-Gruppe finden Sie im Einleitungskapitel zu den JTL-Connectoren.


Allgemeine Informationen

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 WooCommerce-Connector einsetzen?

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

Voraussetzungen / Einschränkungen

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

Voraussetzungen:

JTL-Wawi:
Version: ab JTL-Wawi 1.0
Sie haben Ihre Datenbank gesichert (vgl. Abschnitt Datenbanksicherung).

JTL-Connector:
Lizenz für Ihren JTL-Connector erworben (vgl. Abschnitt Lizenzen).

Shop-System:
Version: ab WooCommerce 2.3
System-Voraussetzungen: Wechseln zur Dokumentation von WooCommerce

Hinweis:
Um zu prüfen, ob Sie die Mindestvoraussetzungen für den Betrieb des Connectors erfüllen, gehen Sie bitte folgendermaßen vor:
(Mindestvoraussetzungen prüfen)


Einschränkungen:

Managed Hosting: Sollten Sie Ihr WooCommerce in einem Managed Hosting betreiben, so kann dies dazu führen, dass der JTL-Connector fehlerhafte oder überhaupt keine Daten überträgt. Wir raten im Fall eines Managed Hostings für WooCommerce vom Einsatz des JTL-Connectors ab bzw. empfehlen Ihnen, den Hoster zu wechseln.

Wordpress-Plugins: Folgende Plugins verändern die Datenbank eines WooCommerce-Shops. Diese verhindern dadurch den Einsatz eines JTL-Connectors. Leider macht auch das Deinstallieren der Plugins die Datenbank-Änderung nicht rückgängig. Folgende Plugins gehören unserer Erfahrung nach dazu:

    1. Wordfence
    2. Anti Spam Bee
    3. WP Cerber Anti-Spam

Der Funktionsumfang von WooCommerce 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.

Beispiel zum Dateninhalt:
In JTL-Wawi können Sie standardmäßig eine breite Anzahl von Produkteigenschaften pflegen, die Sie darüber hinaus noch individuell erweitern können. In Ihren Shopware-System kann es ähnliche Erweiterungsmöglichkeiten geben. Solche divergierenden Inhalte können nicht direkt abgeglichen werden, sondern müssen zuerst in beiden Systemen sowie im JTL-Connector angelegt werden.
Beispiel zur Datenstruktur:
In JTL-Wawi können Sie sowohl Variationsartikel wie Variationskombinationen pflegen (Was sind Variationsangebote?). Diese komplexen Angebotsstrukturen werden von Software-Herstellern technisch unterschiedlich gelöst. Eine 1:1-Übertragung zwischen den Systemen ist daher nicht immer möglich.

Damit möglichst viele der von Ihnen gepflegten Daten ohne Verluste von einem System in das andere transferiert werden können, machen Sie sich mit der Funktionsweise des "Event-Moduls" Ihres JTL-Connectors vertraut (vgl. Abschnitt Erweiterbarkeit), wenn Sie viele zusätzliche Eigene Felder, Attribute und Merkmale angelegt haben.

Zugriffspunkte

An welchen Stellen/Orten können Sie als Anwender in JTL-Wawi bzw. in Ihrem WooCommerce-Shop auf den JTL-Connector zugreifen?

    1. JTL-Connector in JTL-Wawi anbinden:
      Onlineshop > Onlineshop-Anbindung > Anlegen > Fenster: Onlineshop-Anbindung > Verbindung Testen / Lizenz aktivieren
    2. JTL-Connector in JTL-Wawi konfigurieren:
      Onlineshop > Onlineshop-Anbindung > Anlegen > Fenster: Onlineshop-Anbindung > Connector konfigurieren > Shopkonfiguration
    3. Webshop-Abgleich starten:
      Onlineshop > Onlineshop-Abgleich > Starten > Starten
    4. JTL-Connector-Plugin in WooCommerce hochladen:
      Upload via FTP: /wp-content/plugins/jtlconnector > Schreibrechte setzen für: config, db, logs
    5. JTL-Connector in WooCommerce-Backend aktivieren:
      Plugins > JTL-Connector > Link: Aktivieren

Downloads

JTL-Connector für WooCommerce: Im JTL-Kundencenter | später auch: Im JTL-Webshop
Der Download eines JTL-Connectors ist mit einem Lizenzerwerb verbunden (siehe Abschnitt Lizenzen).

JTL-Wawi: Version 1.0 - Zur Website von JTL

WooCommerce-Shop / Erweiterungen: Zur Plugin-Website von WooCommerce

Erweiterbarkeit

    1. Über das Event-System:
      Generell kann jeder Entwickler die JTL-Connectoren über ein sogenanntes "Event-System" erweitern. Hier finden Sie die Dokumentation für Entwickler: Developer Dokumentation.
    2. Aktueller Funktionsumfang:
      Eine Übersicht des aktuellen Funktionsumfangs Ihres JTL-Connectors finden Sie im Dialogfenster "Shopkonfiguration" (vgl. Abschnitt Zugriffspunkte) oder hier in der Dokumentation (vgl. Synchronisationsoptionen, Funktion). Sie können den aktuellen Leistungsumfang durch Software-Partner erweitern lassen.
    3. Über die API:
      Des Weiteren ist es möglich, die JTL-Connectoren als API für die Anbindung an Fremd-Shop-Systeme zu benutzen. Auch hier folgt demnächst eine technische Dokumentation.

Lizenzen

Um die JTL-Connectoren verwenden zu können, benötigen Sie eine Lizenz pro Connector und Domain. Wenn Ihr Shop-System z.B. unter der Adresse http://Mein-Online-Shop.de zu erreichen ist, dann müssen Sie genau für diese Domain eine Lizenz freischalten. Und so geht's:

Loggen Sie sich in Ihr JTL-Kundencenter ein. Klicken Sie auf Lizenzen (Icon) und dann auf JTL-Connector (Icon). Es öffnet sich die Lizenzverwaltung für die JTL-Connectoren. Sie werden dort alle Connectoren, die aktuell von JTL-Wawi zur Verfügung gestellt werden aufgelistet sehen:

Jtl-kundencenter-lizenzen-jtl-connectoren.png

Lizenzschlüssel: Für JTL-Wawi 1.0 wurde die Lizenzverwaltung umstrukturiert. Sie haben von nun an nur noch einen Lizenzschlüssel, den Sie in JTL-Wawi eintragen. Durch diesen Lizenzschlüssel weiß Ihre JTL-Wawi, für welche Module Sie aktuell freigeschaltet sind oder welche Module Sie im Moment testen. Notieren Sie sich diesen Lizenzschlüssel, um ihn später in Ihrer JTL-Wawi eintragen zu können.

Wählen Sie den für Ihr Shop-System passenden JTL-Connector aus, beispielsweise den Gambio-Connector, wenn Sie einen Gambio-Shop anbinden möchten, den Shopware 5 Connector, wenn Sie eine Shopware 5 anbinden möchten usw. Klicken Sie anschließend auf Buchen. Führen Sie den Bestellvorgang durch.
Klicken Sie nun im Auswahlmenü zu Ihrem Connector auf den Eintrag Download, um die Installationsdatei für den JTL-Connector herunterzuladen. Sie werden die Datei später bei der Einrichtung der Systeme benötigen. Für die aktuelle Lizenzfreischaltung benötigen wir die Datei noch nicht.

Jtl-kundencenter-lizenzen-jtl-connector-aktionen-download.png

Klicken Sie auf Aktionen.
Es öffnet sich ein Auswahlmenü. Wählen Sie den Eintrag Webshop-URL ändern. Eine Eingabemaske zum Anlegen bzw. Ändern Ihrer Lizenzdomain.

Jtl-kundencenter-jtl-connectoren-webshop-url-aendern.png

Tragen Sie hier die genaue Adresse Ihres Online-Shops ein, z.B. Mein-Online-Shop.de. Bestätigen Sie die Eingabe mit Ändern und klicken Sie anschließend auf zurück

Jtl-kundencenter-jtl-connectoren-webshop-url-eintragen.png

Wechsel Sie in Ihre JTL-Wawi.
Klicken Sie auf Hilfe/Lizenzen > Lizenzverwaltung. Es öffnet sich eine Übersicht Ihrer aktuell aktiven Lizenzen.

Jtl-connectoren-DF-aktive-lizenzen-einsehen-SF-lizenschluessel-eintragen.png

Klicken Sie auf den Button Lizenzschlüssel. Es öffnet sich eine Eingabemaske. Tragen Sie hier den Lizenzschlüssel ein, wie Sie ihn zuvor im JTL-Kundencenter vorgefunden haben und bestätigen Sie Ihre Eingabe. Die neue Lizenz für den JTL-Connector wird in der Übersicht der aktiven Lizenzen angezeigt.

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 Datenbanken von JTL-Wawi und/oder Ihrem WooCommerce-Shop vor Einsatz des JTL-Connectors sichern - insbesondere bevor Sie den Webshop-Abgleich starten!

Bedenken Sie bitte außerdem, dass Sie mit dem Webshop-Abgleich möglicherweise große Datenmengen abgleichen werden (z.B. viele Bilddateien). Der initiale Webshop-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.


Wie geht es weiter?