Benutzer-Werkzeuge

Webseiten-Werkzeuge


public:faqtradebyte2oxid6

OXID Plugin - Tradebyte 2 OXID Connector

Voraussetzungen

  • OXID Version 6
  • FTP-Zugang zu Ihrem Shop-System
  • Für OXID-Versionen ab 6.2. benötigen Sie SSH-Zugriff auf die Shop-Installation.

Installation

Composer

Öffnen Sie die Datei composer.json im Stammverzeichnis Ihres Shops und fügen Sie das Repository hinzu oder vervollständigen Sie die vorhandene Konfiguration:

"repositories": [{
  "type": "composer",
  "url": "https://packages.fatchip.de/packages"
}]

Nach erfolgter Ergänzung der Datei composer.json können Sie da Plugin installieren.
Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden.
Führen Sie folgenden Befehl aus, um das Plugin zu installieren

  composer require fatchip-gmbh/plugin-oxid6-tradebyte2oxid

Beachten Sie, dass der genaue Aufruf des Composers für Ihre konkrete OXID-Installation abweichen kann.

Sie werden nun nach einem Benutzer und einem Passwort gefragt. Geben Sie die Zugangsdaten ein, welche Ihnen per E-Mail übersandt wurden.
Bitte speichern Sie diese Zugangsdaten nicht auf Ihrem Server, da es sonst zu Problemen kommt, sollten Sie mehrere unserer Plugins einsetzen oder einsetzen wollen.

Nach korrekter Eingabe der Zugangsdaten wird das Plugin installiert.

Manuell

Inhalt aus dem Ordner „modules“ kopieren

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

composer.json aktualisieren

Öffnen Sie die Datei composer.json im Stammverzeichnis Ihres Shops und fügen Sie diese Autoload-Konfiguration hinzu oder vervollständigen Sie die vorhandene Konfiguration:

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

Nach erfolgreicher Aktion wird folgende Meldung angezeigt: Generating autoload files

In OXID-Versionen ab 6.2 (ältere Versionen können den Schritt überspringen) muss die Modulkonfiguration eingelesen werden.
Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden. Führen Sie die folgenden Befehle aus:

vendor/bin/oe-console oe:module:install-configuration source/modules/fc/fctradebytemarket
vendor/bin/oe-console oe:module:apply-configuration 

Bei erfolgreichem Einlesen/Import erscheint die Nachricht
Module configuration has been installed

FATCHIP Tradebyte2Oxid Connector aktivieren

Aktivieren Sie das Plugin im OXID Administrationsbereich unter Erweiterungen → Module → FATCHIP Tradebyte2Oxid Connector.


Konfiguration

Erweiterungen → Module → FATCHIP Tradebyte2Oxid Connector → Einstell.

Einstellungen: Verbindung

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 IDTradebyte Händler ID
VertriebskanalTradebyte 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 versuchenFalls die aktuelle XML-Datei noch nicht vorhanden ist, wird alle 5 Minuten eine neuer Download Versuch gestartet

Einstellungen: Script

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.

Konfiguration Beschreibung
Kommunikationsart Tradebyte VollimportKommunikationsart für den Tradebyte Vollimport

Rest API: Verbindung über die Tradebyte REST API
Order: Datei wird aus dem Import Ordner in Ihrem OXID Hauptverzeichnis importiert
FTP: Verbindung über den Tradebyte FTP Server
Kommunikationsart Tradebyte Delta-ImportKommunikationsart für den Tradebyte Delta-Import
Kommunikationsart Lagerbestands-VollimportKommunikationsart für den Lagerbestands-Vollimport
Kommunikationsart Lagerbestands-Detla-ImportKommunikationsart für den Lagerbestands-Delta-Import
Kommunikationsart Order-ExportKommunikationsart für den Order-Export
Kommunikationsart Bestell-Status-ImportKommunikationsart für den Bestell-Status-Import
Kommunikationsart Stock-ExportKommunikationsart für den Lagerbestands-Export
Kommunikationsart Tradebyte Kategorie-ImportKommunikationsart für den Tradebyte Kategorie-Import

Einstellungen: Produkt-Import

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.

Konfiguration Beschreibung
Neue Kategorien als versteckt importierenNeue Kategorien werden als versteckte Kategorien in OXID importiert.
Große Dateien zur Verarbeitung in kleine XMLs aufteilen (bei Problemen mit memory_limit aktivieren)Eine große Tradebyte XML-Datei wird in mehrere kleinere Dateien aufgeteilt.
Zeitfenster (in Sekunden) für Delta-ImportDas erlaubte Zeitfenster für den Delta-Import
in Tradebyte nicht mehr vorhandene Produkte in OXID löschenProdukte, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
in Tradebyte nicht mehr vorhandene Varianten in OXID löschenVarianten, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
in Tradebyte nicht mehr vorhandene Attribute in OXID löschenAttribute, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
in Tradebyte nicht mehr vorhandene Kategorien in OXID löschenKategorien, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
in Tradebyte nicht mehr vorhandene Marken in OXID löschenMarken, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
in Tradebyte nicht mehr vorhandene Lieferanten in OXID löschenLieferanten, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
in Tradebyte nicht mehr vorhandene Produktkategorisierungen in OXID löschenProduktkategorisierungen, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
in Tradebyte nicht mehr vorhandene Crosssellings in OXID löschenCrosssellings, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
in Tradebyte nicht mehr vorhandene Produkt zu Attribut Beziehungen in OXID löschenProdukt zu Attribut Beziehungen, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
in Tradebyte nicht mehr vorhandene Produkt-Logos zu Attribut Beziehungen in OXID löschenProdukt zu Attribut Beziehungen, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
in Tradebyte nicht mehr vorhandene Produkt-Logos in OXID löschenProdukt-Logos, die nicht mehr in Tradebyte vorhanden sind, werden auch im OXID eShop gelöscht.
Varianten Bilder in Vaterprodukt einfügenDie Varianten Bilder aus Tradebyte werden auch bei dem OXID Hauptartikel hinterlegt.
Tradebyte-Artikelnummer anstatt Tradebyte-Produkt-ID als oxarticles.OXID verwendenDie Tradebyte-Artikelnummer wird anstatt der Tradebyte-Produkt-ID als oxarticles verwendet.
Variantenmerkmale auch als Attribut importierenVariantenmerkmale aus Tradebyte werden im OXID eShop auch als Attribut angelegt.
Standard Lieferstatus wenn Artikel wieder beschaffbar
Hier können Sie den OXID Lieferstatus für wieder beschaffbare Artikel festlegen.
Standard Lieferstatus wenn Artikel nicht wieder beschaffbarHier können Sie den OXID Lieferstatus für NICHT wieder beschaffbare Artikel festlegen.
Artikel import XML file handling
Hier können Sie entscheiden, was mit der Tradebyte XML-Datei nach dem Import passieren soll.
Archivierte XMLs Aufbewahrungszeit in Tagen.Hier können Sie entscheiden, wie lange die Tradebyte XML-Datei aufbewahrt werden soll.
leere Kategorien löschenLeere Kategorien werden im OXID eShop gelöscht.
ungenutzte Attribute löschenUngenutzte Attribute werden im OXID eShop gelöscht.
ungenutzte Marken löschenUngenutzte Marken werden im OXID eShop gelöscht.
Artikel mit Streichpreis automatisch auf negative Nachlässe ignorieren setzen.Artikel die einen Streichpreis haben, können keine negativen Nachlässe bekommen.
Während des Imports keine Bilder runterladen (nur zu Testzwecken aktivieren)Wenn diese Einstellung aktiv ist, werden während des Imports keine Produktbilder herunter geladen.
Master-Bilder beim Download von Tradebyte auf konfigurierte Zoom-Größe verkleinern (spart Speicherplatz)Master-Bilder aus Tradebyte werden beim Import auf die OXID Zoom-Größe skaliert.
Tradebyte last change Timestamp auswerten Wenn der Tradebyte last change Timestamp eines Produktes älter als die angegebene Differenz ist, werden nur Preis und Lagerbestand abgeglichen, sonst alle Felder.
Tradebyte last change Timestamp Differenz in SekundenDie Differenz in Sekunden, wenn die Option „Tradebyte last change Timestamp auswerten“ aktiv ist.
XML Dateigrößen-Validierung, Mindestgröße im Vergleich zur letzten XML in Prozent (z.B. 80), nur für VollimportBei dem Vollimport können Sie die Dateigröße der XML-Datei überprüfen und eine Mindestgröße in Prozent angeben.
Sprach-Mapping (leer lassen wenn das multilinguale Format nicht verwendet wird)
Format-Beispiel:
0 ⇒ deutsch
1 ⇒ englisch
Wenn Sie einen mehrsprachigen Shop verwenden, können Sie hier das Sprach-Mapping hinterlegen.

Einstellungen: FATCHIP FatSearch

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 synchronisierenDie Tradebyte Attribute werden mit den FatSearch Attributen abgeglichen.

Einstellungen: Bestell-Export

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 exportierenEs 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-DateiDer Pfad zu der Bestell-Export XML-Datei in Ihrem OXID eShop Verzeichnis.
ihr-oxid-eshop.de/export/orders/

Einstellungen: Lagerbestands-Export

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/

Andere Einstellungen

Weitere Tradebyte 2 OXID Connector Einstellungen finden Sie unter FC Tradebyte → TB2OXID → Konfiguration → Andere Einstellungen.

Konfiguration Beschreibung
Logging aktivEs wird ein Logfile im log Ordner des OXID eShops erstellt.
Verbose-Modus aktivWeitere 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-PfadDer Pfad Lockfile z.B. /var/www/localhost/tmp/
Empfänger-Email-Adresse für Fehler-EmailsE-Mail Adresse für Fehlermeldungen.

Sytemcheck

Im OXID Administrationsbereich unter FC Tradebyte → Systemcheck können Sie prüfen ob alle Systemvoraussetzungen für eine korrekte Pluginfunktion gegeben sind.


Anwendung

Tradebyte 2 OXID Cronjobs einstellen

Damit die Synchronisation der Artikeldaten funktioniert, müssen die folgenden Cronjobs einrichten werden.

  • /source/modules/fc/fctradebytemarket/batch/TradebyteImportBatch.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.

  • /source/modules/fc/fctradebytemarket/batch/TradebyteImportDeltaBatch.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.

  • /source/modules/fc/fctradebytemarket/batch/TradebyteStockBatch.php
    Dieses Script importiert alle Lagerbestände aus Tradebyte in den OXID eShop.
    Wir empfehlen diesen Cronjob jede halbe Stunde zu starten.

  • /source/modules/fc/fctradebytemarket/batch/TradebyteOrderExportBatch.php
    Dieses Script exportiert alle Bestellungen aus dem OXID eShop zu Tradebyte.
    Wir empfehlen diesen Cronjob stündlich zu starten.

  • source/modules/fc/fctradebytemarket/batch/TradebyteOrderStatusImportBatch.php
    Dieses Script importiert alle Bestellstatus aus Tradebyte in den OXID eShop.
    Wir empfehlen diesen Cronjob stündlich zu starten.

  • /source/modules/fc/fctradebytemarket/batch/TradebyteArchiveCleanupBatch.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.

Tradebyte 2 OXID Übersicht

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.


FAQs

1. Welche OXID eShop Versionen sind mit dem Tradebyte 2 OXID Connector von FATCHIP kompatibel?

Die aktuellsten Informationen hierzu erhalten Sie in der Kompatibilitätsmatrix in unserem Shop.

2. Wie werden die Bilddaten zwischen Tradebyte und OXID übertragen?

Bei der Übertragung der Bilddaten finden insgesamt 2 Schritte statt:

  • Schritt 2
    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).


Support

Sollten Sie Hilfe von FATCHIP benötigen, schicken Sie bitte eine detaillierte Fehlerbeschreibung inkl. Plugin- und Shopversion an support@fatchip.de.


Weitere Informationen

Sollte das OXID Plugin Tradebyte 2 OXID Connector nach der Installation nicht wie erwartet funktionieren, prüfen Sie ob alle Installationsschritte richtig durchgeführt worden sind.
Weitere Informationen 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
https://www.fatchip.de/Servicepakete/Plugin-Installationsservice-OXID-eShop-EE.html

public/faqtradebyte2oxid6.txt · Zuletzt geändert: 2023/03/14 10:46 von markusmichalski