JTLWawi Tradoria Connector
--------------------------
--------------------------
Basis: Aktuelle XTC-Connector von JTL
Veränderung von Fabian Lauer (5/2010)
Prinzip
-------
Der Connector wird auf einen beliebigen Webspace mit PHP Support gelegt.
Die Wawi spricht die Scripte an. Die Scripte wiederrum rufen über HTTP-Get und HTTP-Post die Tradoria API auf.
Dabei sind die Eingaben an das Script identisch mit den Daten die an den XTC-Connector fließen.
Die zurückgegebenen Daten des Scripts entsprechen ebenfalls der XTC-Connector-Variante.
Des weiteren wird eine MySQL-DB für das zwischenspeichern von diversen Infos benötigt.
Infos zum Abgleich
------------------
Übertragen werden neben Artikel, Kategorien, Bildern auch die Bestellungen und der Versandstatus.
Bestellungen werden erst übertragen wenn diese freigegeben, also bezahlt sind.
Artikel können angelegt, bearbeitet und gelöscht werden. Artikel können nicht von Tradoria nach JTL geschoben werden.
Soll heißen vorhandene Tradoria Artikel landen nicht in der Wawi.
Kategorien werden sortiert und mit Beschreibung versehen.
Bestellungen umfassen alle Informationen welche zur Verfügung stehen. Nur die Zahlung wird in der Wawi nicht gesetzt (geht mit der XTC-Schnittstelle auch nicht?)
Einrichtung
-----------
1. Scripte (also den kompletten Ordner 'jtlwawi-tradoria_connector') auf den Webserver kopieren.
Muss durch JTLWawi erreichbar sein
2. Die Unterordner 'logs' und 'temp' müssen beschreibar sein (chmod 777)
3. Einstellugen in der Datei config.php vornehmen (ist hoffentlich alles selbst erklärend).
4. SQL-Script in die einstellte MySQL DB importieren
5. Falls gewünscht die Zuordnung zwischen Artiel/Kategorie und Tradoria Portal-Kategorie vornehmen
6. Fertig. JTL einrichten und testen!
Der Ordner tmp
--------------
Hier werden zur Zeit noch die Bilder zwischengespeichert bevor diese dann von Tradoria gespeichert werden.
Man kann die Bilder auch direkt als String übertragen. Dies ist aber bis jetzt noch nicht umgesetzt und ist für später gedacht.
Ich hab zur Zeit ca. 600 Produkte bei Tradoria drin mit je 2-3 Bildern. Es entsteht ein Volumen von ca 90 MB im tmp-Ordner.
Dieser kann aber auch immer wieder nach dem Abgleich gelöscht werden.
DB-Tabellen Erklärung
---------------------
Da es kein Admin oder Config-Front-End gibt, muss einiges von Hand direkt in der MySQL-DB gemacht werden.
Die Tabellen haben die folgenden Aufgaben:
- jtlwawi-tradoria_martikel: Mapping zwischen Wawi-Artikel-Id (intern, quasi der PK der Wawi-Artikel-Tabelle)
und der Produkt-Nummer (wird für Tradoria abgleich verwendet).
Mir fällt gerade ein, dass man bei Tradoria auch eine Produkt-ID übergeben kann...evtl. ist diese Tabelle über...mal schauen *TODO*
- jtlwawi-tradoria_martikeltradoriakat: Es gibt die Möglichkeit bei Tradoria Artikeln einer Portal-Kategorie zuzuordnen.
Dies wird hier je Artikel erledigt.
- jtlwawi-tradoria_mkategorietradoriacat: Es gibt die Möglichkeit bei Tradoria Artikeln einer Portal-Kategorie zuzuordnen.
Dies wird hier je Kategorie erledigt. Achtung hier wird die WAWI-Interne Kategorie-ID benötigt.
Muss soweit ich weiß aus der MSSQL-DB ausgelesen werden und per Hand hier zugeordnet werden.
Beim Zuordnen der Artikel zu Kategorie (Tradoria-Shop-Kategorie) wird dann auf diesen Daten zugegriffen und die Zurodnung Artikel zu Portal-Kat vorgenommen.
Nachteil: Hat ein Artikel mehrere Kategorien (Shop intern) wird der Artikel immer der letzten Zuordnung dem Portal zugewiesen (versteht man das?)
- jtlwawi-tradoria_sendorders: Hier stehen die Bestellungen drin, die schon übertragen wurden und nun nicht mehr übertragen werden.