Wechseln zu: Navigation, Suche

Einführung zum JTL-Connector für modified

Verwandte Themen:


Was ist der JTL-Connector für modified?

Der JTL-Connector ist eine von JTL entwickelte Schnittstelle, mit der Sie Ihren modified-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 modified-Shop eine JTL-Wawi anschließen

Sie arbeiten bereits mit modified 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 modified-Shop mithilfe einer aktiven JTL-Wawi befüllen

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

Bestandsdaten aus JTL-Wawi und modified zusammenführen

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

Auf dieser Seite erhalten Sie zunächst allgemeine Informationen zum JTL-Connector für modified. 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!

Achtung Variationskombinationen: Wichtiger technischer Hinweis!
Bei der alten JTL-Wawi Version 099923 hat der GPL-Connector von 2006 die Varkombi-Väter als "normale" Variationsartikel zum Shop gesendet. Diese Variationsartikel konnten Kunden dann im Webshop kaufen. Bei einem Kauf haben diese Bestellungen dann einen nicht definierten Zustand in JTL-Wawi hervorgerufen und konnten von Ihnen als Händler nicht ohne Weiteres ausgeliefert werden. Stattdessen mussten Sie die Verkaufsposition zusätzlich löschen und das entsprechende Varkombi-Kind auswählen, damit Sie Ihren Auftrag weiter bearbeiten konnten.

In JTL-Wawi Version 1.0 und höher verhält es sich vergleichbar. Damit es aber nicht zu dem oben beschriebenen, undefinierten Zustand kommt, werden mit dem neuen JTL-Connector keine Varkombi-Artikel (Väter/Kinder) zu Shop-Systemen gesendet, die keine Varkombis unterstützen. Dies betrifft das Shop-System Modified im Besonderen.

Einsatzmöglichkeiten

Wofür kann ich den modified-Connector einsetzen?

    1. Sie möchten modified als neues Shop-System nutzen
      (Sie nutzen JTL-Wawi um Ihren modified-Shop automatisiert zu befüllen und zu pflegen)
    2. Sie möchten modified 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 modified als Shop-System ablösen
      (Sie nutzen den JTL-Connector, um Daten aus Ihrem modified-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 modified-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: 1.06 rev 4642 SP2
Optionen:

    1. Aktiviertes Modul für Kundengruppen-Check
    2. Zulassen zusätzlicher Produktbilder

System-Voraussetzungen: Wechseln zur Dokumentation von Modified

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

Weitere Besonderheiten:

    1. Sie müssen die Status von JTL-Wawi mit den Status von Modified verknüpfen, siehe Statusübernahme.
    2. Sonderpreise haben in Modified kein Startdatum und keine Bestandsgrenze.
    3. Der UVP wird in Modified nicht korrekt angezeigt und daher vom Connector nicht unterstützt.
    4. Modified unterstützt nur Variationen, keine Varkombis, siehe Artikeldetails
    5. Kundengruppen und Staffelpreise können nur mit aktivem Zusatzmodul verwendet werden (standardmäßig ist dieses deaktiviert)
    6. Zusatzbilder müssen explizit eingerichtet werden.
    7. Bildnummern müssen fortlaufend sein und mit 1 beginnen.

Zugriffspunkte

An welchen Stellen/Orten können Sie als Anwender in JTL-Wawi bzw. in Ihrem modified-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

Downloads

JTL-Connector für modified: 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

modified-Shop / Erweiterungen: Zur Website von Modified

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 modified-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?