Dies ist eine alte Version des Dokuments!
https://www.fatchip.de/Plugins/OXID-eShop/Tradebyte-2-OXID-Connector.html
https://github.com/FATCHIP-GmbH/plugin-oxid6-tradebyte2oxid (private)
OXID Version 6.x
In dem Pluginpaket fcTradebyte2Oxid_oxid6_source befindet sich der Ordner copy_this, kopieren Sie den Inhalt aus diesem Ordner in das „Source“ Ordner Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen).
Der zweite Schritt der Installation besteht in der Anpassung der Datei composer.json, die sich im Hauptverzeichnis Ihrer OXID 6-Installation befindet. Dieser müssen Sie zunächst die nachfolgenden Zeilen an geeigneter Stelle hinzufügen (siehe Abbildung unten).
"autoload": { "psr-4": { "FATCHIP\\": "./source/modules/fc" } },
Nach erfolgter Ergänzung der Datei composer.json müssen die Änderungen dem OXID-System mitgeteilt werden.
Rufen Sie hierzu das Programm composer mit der Aktion dump-autoload auf (composer dump-autoload).
Beachten Sie, dass der genaue Aufruf des Composers für Ihre konkrete OXID-Installation abweichen kann.
Aktivieren Sie das Plugin im OXID Administrationsbereich unter Erweiterungen > Module > FATCHIP Tradebyte2Oxid Connector.
Sollte der Tradebyte 2 OXID Connector nach der Installation nicht wie erwartet funktionieren, prüfen Sie ob alle Installationsschritte richtig durchgeführt worden sind.
Weitere Informationen zu dem Tradebyte 2 OXID Connector finden Sie in unserem Online Shop unter https://www.fatchip.de/Plugins/OXID-eShop/Tradebyte-2-OXID-Connector.html.
Außerdem bietet FATCHIP einen Plugin-Installationsservice an. Weitere Informationen hierzu finden Sie unter
https://www.fatchip.de/Servicepakete/Plugin-Installationsservice-OXID-eShop-PE.html oder
https://www.fatchip.de/Servicepakete/Plugin-Installationsservice-OXID-eShop-EE.html.
Die Tradebyte 2 OXID Connector Verbindungseinstellungen finden Sie unter Konfiguration > Tradebyte Verbindungseinstellungen REST oder Konfiguration > Tradebyte Verbindungseinstellungen FTP. Hier können Sie zwischen der Verbindung über die REST API oder über FTP Server wählen.
Konfiguration | Beschreibung |
Benutzername (REST API) | Benutzername für die Verbindung über die REST API |
Passwort (REST API) | Passwort für die Verbindung über die REST API |
REST Server (Format: rest.trade-server.net) | REST Server URL im Format rest.trade-server.net |
Händler ID | Tradebyte Händler ID |
Vertriebskanal | Tradebyte Vertriebskanal |
Kanalzeichen | |
Benutzername (FTP Server) | Benutzername für die Verbindung über den FTP Server |
Passwort (FTP Server) | Passwort für die Verbindung über den FTP Server |
FTP Server (Format: ftp.trade-server.net) | FTP Server URL im Format ftp.trade-server.net |
Datei nach dem Download vom FTP Server löschen (nur zu Testzwecken deaktivieren) | Die XML-Datei wird nach dem erfolgreichen Download vom Tradebyte Server gelöscht. |
falls noch nicht vorhanden, Download der Datei mehrfach im 5 Minuten Takt versuchen | Falls die aktuelle XML-Datei noch nicht vorhanden ist, wird alle 5 Minuten eine neuer Download Versuch gestartet |
Die Tradebyte 2 OXID Connector Script-Einstellungen finden Sie unter Konfiguration > Script-Einstellungen. Hier können Sie die Kommunikationsart für die verschiedenen Scripte festlegen.
Die Tradebyte 2 OXID Connector Produkt-Import-Einstellungen finden Sie unter Konfiguration > Produkt-Import-Einstellungen. Hier können Sie den Import der Produktdaten aus Tradebyte konfigurieren und auf Ihren OXID eShop abstimmen.
Die Tradebyte 2 OXID Connector Produkt-Import-Einstellungen finden Sie unter Konfiguration > FATCHIP FatSearch Einstellungen. Wenn Sie das FATCHIP FatSearch Plugin verwenden, können Sie hier den Import konfigurieren.
Konfiguration | Beschreibung |
Verwendet Ihr Shop das FATCHIP FatSearch Plugin? | Wenn Sie das FATCHIP FatSearch Plugin einsetzten, aktivieren Sie die Option. |
Tradebyte Attributswerte mit FatSearch Attributswerten synchronisieren | Die Tradebyte Attribute werden mit den FatSearch Attributen abgeglichen. |
Die Tradebyte 2 OXID Connector Bestell-Export-Einstellungen finden Sie unter Konfiguration > Bestell-Export-Einstellungen. Bestellungen aus Ihrem OXID eShop werden zu Tradebyte exportiert, hier können Sie diesen Bestell-Export konfigurieren.
Konfiguration | Beschreibung |
Nur bezahlte Bestellungen an TB.Market exportieren | Es werden lediglich als bezahlt markierte Bestellungen an Tradebyte exportiert. |
Versandart-Typ ausgeben (nur zu Testzwecken aktivieren) | Die Versandart wird mit der Bestellung exportiert. |
Zahlart-Typ ausgeben (nur zu Testzwecken aktivieren) | Die Zahlungsart wird mit der Bestellung exportiert. |
Artikel MwSt.-Satz ausgeben (nur zu Testzwecken aktivieren) | Der Mehrwertsteuersatz wird mit der Bestellung exportiert. |
Pfad zu Bestell-Export-Datei | Der Pfad zu der Bestell-Export XML-Datei in Ihrem OXID eShop Verzeichnis. ihr-oxid-eshop.de/export/orders/ |
Die Tradebyte 2 OXID Connector Lagerbestands-Export Einstellungen finden Sie unter Konfiguration > Lagerbestands-Export Einstellungen. Bestellungen aus Ihrem OXID eShop werden zu Tradebyte exportiert, hier können Sie diesen Bestell-Export konfigurieren.
Konfiguration | Beschreibung |
Pfad zu Lagerbestands-Export-Datei | Der Pfad zu der Lagerbestands-Export XML-Datei in Ihrem OXID eShop Verzeichnis. ihr-oxid-eshop.de/export/stock/ |
Weitere Tradebyte 2 OXID Connector Einstellungen finden Sie unter FC Tradebyte > TB2OXID > Konfiguration > Andere Einstellungen.
Konfiguration | Beschreibung |
Logging aktiv | Es wird ein Logfile im log Ordner des OXID eShops erstellt. |
Verbose-Modus aktiv | Weitere Debuging Informationen im Logfile anzeigen. |
Skript läuft schon Lockfile Logik deaktivieren (nur zu Testzwecken aktivieren) | Hier können Sie die Lockfile Logik zu Testzwecken deaktivieren. |
Skript läuft schon Lockfile-Pfad | Der Pfad Lockfile z.B. /var/www/localhost/tmp/ |
Empfänger-Email-Adresse für Fehler-Emails | E-Mail Adresse für Fehlermeldungen. |
Im OXID Administrationsbereich unter FC Tradebyte > Systemcheck können Sie prüfen ob alle Systemvoraussetzungen für eine korrekte Pluginfunktion gegeben sind.
Damit die Synchronisation der Artikeldaten funktioniert, müssen die folgenden Cronjobs einrichten werden.
/modules/fcTradebyteMarket/batch/fctradebyteimport_batch.php
Dieses Script importiert alle Artikel-, Kategorie-, Hersteller- und Attributinformationen. Bei OXID Enterprise Edition müssen Sie noch die Shop-ID als ersten Paramater hinzufügen. Der Change-Date-Check Flag kann mit einem zweiten Paramater überschrieben werden (0 = do full import, 1 = do change-date-check import). Wir empfehlen diesen Cronjob einmal täglich zu starten.
/modules/fcTradebyteMarket/batch/fctradebyteimport_delta_batch.php
Dieses Script importiert Preis- und Lagerbestandsaktualisierungen von Tradebyte in den OXID eShop. Bei OXID Enterprise Edition müssen Sie noch die Shop-ID als ersten Paramater hinzufügen. Wir empfehlen diesen Cronjob stündlich zu starten.
/modules/fcTradebyteMarket/batch/fctradebyteorderexport_batch.php
Dieses Script exportiert alle Bestellungen aus dem OXID eShop zu Tradebyte. Wir empfehlen diesen Cronjob stündlich zu starten.
/modules/fcTradebyteMarket/batch/fctradebyteorderstatusimport_batch.php
Dieses Script importiert alle Bestellstatus aus Tradebyte in den OXID eShop. Wir empfehlen diesen Cronjob stündlich zu starten.
/modules/fcTradebyteMarket/batch/fctradebytearchivecleanup_batch.php
Dieses Script löscht archivierte XML-Dateien, die älter sind als die konfigurierte Aufbewahrungszeit in Tagen. Wir empfehlen diesen Cronjob stündlich zu starten.
Im OXID Administrationsbereich unter FC Tradebyte > TB2OXID > Main können Sie den aktuellen Bestand Ihrer OXID Datenbank einsehen und die Tradebyte 2 OXID Jobausführungen überwachen.
Die aktuellsten Informationen hierzu erhalten Sie in der Kompatibilitätsmatrix in unserem Shop.
Bei der Übertragung der Bilddaten finden insgesamt 2 Schritte statt:
Vom Tradebyte Server wird die hinterlegte XML-Datei im Shop Verzeichnis /import/tradebyte/ generiert, die Variante des Uploads hängt von der Konfiguration des Tradebyte Plugins ab:
Nachdem die XML-Datei ins Verzeichnis /import/tradebyte/ kopiert wurde, liest der Connector die XML-Datei ein und crawlt dabei alle hinterlegten Bildlinks aus den folgenden Tags:
<P_MEDIADATA> <P_MEDIA type="image" sort="0">Bildlink</P_MEDIA> </P_MEDIADATA>
<A_MEDIADATA> <A_MEDIA type="IMAGE" sort="0">Bildlink</A_MEDIA> </A_MEDIADATA>
Der hinterlegte Bildlink ist die absolute URL des Bildes. Wenn das gecrawlte Bild vorhanden ist, wird es im OXID eShop im Master Bild Verzeichnis gespeichert z.B. „/out/pictures/master/“ oder „/out/pictures/master/product/“ (je nach OXID Version).
Sollten Sie Hilfe von FATCHIP benötigen, schicken Sie bitte eine detaillierte Fehlerbeschreibung inkl. Plugin- und Shopversion an support@fatchip.de.