modified-Connector - Eine Einführung

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-Shop zusammenführen: Sie arbeiten 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.

Warnhinweis

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?

Sie möchten modified als neues Shop-System nutzen (Sie nutzen JTL-Wawi um Ihren modified-Shop automatisiert zu befüllen und zu pflegen)
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)
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

Was müssen Sie beachten, wenn Sie den modified-Connector verwenden möchten? JTL-Wawi:

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
Aktiviertes Modul für Kundengruppen-Check
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 modified-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-Systems“ Ihres JTL-Connectors vertraut (vgl. Abschnitt Erweiterbarkeit), wenn Sie viele zusätzliche Eigene Felder, Attribute und Merkmale angelegt haben.

Weitere Besonderheiten:

Sie müssen die Status von JTL-Wawi mit den Status von Modified verknüpfen, siehe Statusübernahme.
Sonderpreise haben in Modified kein Startdatum und keine Bestandsgrenze.
Der UVP wird in Modified nicht korrekt angezeigt und daher vom Connector nicht unterstützt.
Modified unterstützt nur Variationen, keine Varkombis, siehe Artikelstammdaten
Kundengruppen und Staffelpreise können nur mit aktivem Zusatzmodul verwendet werden (standardmäßig ist dieses deaktiviert)
Zusatzbilder müssen explizit eingerichtet werden.
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?

JTL-Connector in JTL-Wawi anbinden:

Onlineshop > Onlineshop-Anbindung > Anlegen > Fenster: Onlineshop-Anbindung > Verbindung Testen / Lizenz aktivieren

JTL-Connector in JTL-Wawi konfigurieren:

Onlineshop > Onlineshop-Anbindung > Anlegen > Fenster: Onlineshop-Anbindung > Connector konfigurieren > Shopkonfiguration

Onlineshop-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 oder neuer – Zur Website von JTL

modified-Shop / Erweiterungen: Zur Website von Modified

Lizenzen

Lesen Sie hier, wie Sie einen JTL-Connector aktivieren: Lizenz für JTL-Connector aktivieren.

Erweiterbarkeit

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

Aktueller Funktionsumfang:

Eine Übersicht des aktuellen Funktionsumfangs Ihres JTL-Connectors finden Sie im Dialogfenster „Shopkonfiguration“ oder hier in der Dokumentation. Sie können den aktuellen Leistungsumfang durch Software-Partner erweitern lassen.

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

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.