Inhaltsverzeichnis

    Oxid -Connector - Eine Einführung

    Der JTL-Connector unterstützt nur Oxid von Version 4.9.6 bis 4.9.8. JTL hat die Weiterentwicklung des JTL-Connectors für neuere Oxid-Versionen eingestellt. Die Entwicklung wird nun durch unseren Technologiepartner itratos fortgeführt. Zur Website von itratos.

    Was ist der JTL-Connector für Oxid?

    Der JTL-Connector ist eine von JTL entwickelte Schnittstelle, mit der Sie Ihren Oxid-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:

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

    Einsatzmöglichkeiten

    Wofür kann ich den Oxid-Connector einsetzen?

    • Sie möchten Oxid als neues Shop-System nutzen (Sie nutzen JTL-Wawi um Ihren Oxid-Shop automatisiert zu befüllen und zu pflegen)
    • Sie möchten Oxid als zusätzliches Shop-System nutzen (Sie nutzen JTL-Wawi zusammen mit dem Multishop-Modul und pflegen mehrere Shop-Systeme parallel)
    • Sie möchten Oxid als Shop-System ablösen (Sie nutzen den JTL-Connector, um Daten aus Ihrem Oxid-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 Oxid-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:

    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 Oxid 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 Oxid-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:

    Bitte beachten Sie folgende Besonderheiten im Zusammenspiel zwischen JTL-Wawi und Oxid:

    • Oxid hat keine eindeutigen Kundengruppen, d. h. in Oxid ist eine Zuordnung der Kunden zu mehreren Gruppen möglich
    • Als Kundengruppen werden nur die statischen Benutzergruppen Kunde, Preis A, Preis B und Preis C aus Oxid übermittelt, siehe Kundengruppen aufeinander abstimmen
    • Staffelpreise gibt es nur als globale Differenz zu den Standard-Preisen der einzelnen Kundengruppen. Staffelpreise werden daher bei einem Push basierend auf dem Std-VK-Netto in eine prozentuale Differenz umgerechnet.
    • Staffelpreise haben erzwungenermaßen einen Bis-Anzahl-Wert in Oxid. Da die Staffelpreise aus JTL-Wawi nur einen Ab-Wert haben, wird die jeweils nächste Staffel-Menge als Bis-Wert verwendet. Dadurch bedingt wird der allerletzte Staffelpreis in Oxid mit dem Wert 99999 belegt.
    • Suchbegriffe sind in JTL-Wawi einsprachig in Oxid jedoch mehrsprachig. Bei einem Push werden daher in Oxid die Suchbegriffe für alle Sprachen gleichgesetzt.

    Sonderpreise werden aufgrund folgender Gründe nicht unterstützt:

    • Sonderpreise haben im Gegensatz zu Oxid in JTL-Wawi keine Einkaufsmenge oder einen Einkaufswert. Die Parameter müssten somit ignoriert werden.
    • Sonderpreise können in Oxid mehreren Artikeln zugeordnet werden.
    • Sonderpreise werden in Oxid an Variationskombinationen vom Vater vererbt. Eigenständige Sonderpreise pro Varkombi sind nicht möglich.
    • Sonderpreise werden in Oxid als Differenz zum Standardpreis angegeben, nicht als eigenständige Preise

    Zugriffspunkte

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

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

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