Das Plugin bei FATCHIP: https://www.fatchip.de/Plugins/OXID-eShop/OXID-2-Tradebyte-Connector-2-0.html
Das Plugin auf Github: https://github.com/FATCHIP-GmbH/plugin-oxid5-oxid2tradebyte (private)

• OXID CE/PE ab Version 4.7.x bis 4.10.x
  
• OXID EE ab Version 5.0.x bis 5.3.x

In dem Pluginpaket fcTradebyteOne_oxid_source befindet sich der Ordner copy_this, kopieren Sie den Inhalt aus diesem Ordner in das Hauptverzeichnis Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen).

Aktivieren Sie den OXID 2 Tradebyte Connector im OXID Administrationsbereich unter Erweiterungen → Module → FATCHIP Oxid2Tradebyte Connector.

Plugin Update wenn vorherige Pluginversion unter 2.4.0

Da sich die Ordnerstruktur des Moduls geändert hat, sollten Sie unbedingt alle alten Moduldateien löschen, damit es im Modul nicht zu unvorhersehbaren Verhaltensweisen kommt.

In dem Pluginpaket fcTradebyteOne_oxid_source befindet sich der Ordner copy_this, kopieren Sie den Inhalt aus diesem Ordner in das Hauptverzeichnis Ihres OXID eShops. (bei FTP - binären Übertragungsmodus nutzen).

Wenn Sie von einer Pluginversion unter Version 2.4.0 updaten, müssen Sie das Datenbank-Migrations-Script ausführen. Das Migrations-Script können Sie auch über die Kommandozeile oder einen Browser aufrufen und ist im folgendem Verzeichnis zu finden.
/modules/fc/fcTradebyteOne/scripts/fctradebyteone_migrate_db.php

Nach der Updateinstallation müssen Sie den OXID 2 Tradebyte Connector im OXID Administrationsbereich unter Erweiterungen → Module → FATCHIP Oxid2Tradebyte Connector einmal deaktivieren und danach wieder aktiveren.

Die Grundeinstellungen des Connectors finden Sie unter Erweiterungen → Module → FATCHIP Oxid2Tradebyte Connector → Einstellungen → Grundeinstellungen.

Die OXID 2 Tradebyte Connector Channels finden Sie unter Erweiterungen → Module → FATCHIP Oxid2Tradebyte Connector → Einstellungen → Tradebyte Channels. Hier können Sie entscheiden, welche Channels aktiv oder inaktiv sein sollen. Die XML mit Ihren Produktdaten wird für die aktiven Channels aufbereitet und auf dem Tradebyte Server zur Verfügung gestellt.

Konfiguration	Beschreibung
Active Dropdown	Über das Dropdown können Sie einzelne Channels aktiv oder inaktiv schalten.
	Inactive, but visible in admin: Dieser Channel ist inaktiv, wird aber bei den Artikeln im OXID Administrationsbereich angezeigt.

Es stehen zwei verschiedene Verbindungsarten zu Tradebyte zur Verfügung. Entweder eine Verbindung über einen FTP-Server oder über die Tradebyte REST-API. Die Zugangsdaten können Sie unter Erweiterungen → Module → FATCHIP Oxid2Tradebyte Connector → Einstellungen → Tradebyte FTP Zugangsdaten oder Tradebyte REST-API Zugangsdaten hinterlegen.

Neben dem Export der Produkte zu Tradebyte, ist es auch möglich die Bestellungen aus anderen Channels zu importieren. Die Einstellungen für den Import der Bestellungen können Sie unter Erweiterungen → Module → FATCHIP Oxid2Tradebyte Connector → Einstellungen → Order Import vornehmen.

Die Produkte Einstellungen können Sie unter Erweiterungen → Module → FATCHIP Oxid2Tradebyte Connector → Einstellungen → Produkte Einstellungen vornehmen.

Das Logging können Sie unter Erweiterungen → Module → FATCHIP Oxid2Tradebyte Connector → Einstellungen → Logging aktivieren. Durch das Aktivieren der Logging Funktion werden Exportinformationen in einer Log-Datei gespeichert.

Im OXID Administrationsbereich unter FC Tradebyte → Tags können Sie Tags für verschiedene Channels anlegen und für den Export einzelnen Produkten zuordnen. In diesem Beispiel sehen Sie zwei Tags (Farbe und Geschlecht) für den Amazon.de Channel.

Damit die Artikel für Tradebyte aufbereitet und exportiert werden, müssen diese für den Export aktiviert werden. Unter Artikel verwalten → Artikel → Oxid2Tb Reiter können Sie auswählen welcher Channel für diesen Artikel aktiv sein soll und den Artikel für den Export aufbereiten.

Konfiguration	Beschreibung
Channel, alternativer Preis	Hier können Sie einen Channel für diesen Artikel aktivieren. Außerdem habe Sie die Möglichkeit einen alternativen Preis für den Export festzulegen.
alternative Langbeschreibung	Eine alternative Langbeschreibung für den Export an Tradebyte.
alternative Produktbilder für Tradebyte	Artikelbilder werden in der Detailansicht eines Artikels verwendet. Sie können bis zu 7 Artikelbilder pro Artikel hochladen. Nach dem Hochladen wird der Dateiname im jeweiligen Eingabefeld angezeigt. Wenn noch kein Bild hochgeladen wurde, wird — angezeigt. Es können Bilder mit maximal 2 MB oder 1500*1500 Pixel Auflösung hochgeladen werden. Diese Einschränkung gilt, um Probleme mit dem PHP-Speicherlimit zu vermeiden. Danach wird aus diesen Bildern automatisch das Artikelbild, Zoombild, Thumbnail und Icon generiert.
	Hier können Sie dem Artikel bestimmte Tags zuweisen. Dazu wählen Sie einen Tag und eine passende Option aus und bestätigen die Eingabe über den „Add“ Button. Die Tags und deren Optionen wurden zuvor im Schritt 2.7 angelegt.
Channel Tag, Tag Value

Unter Artikel verwalten → Artikel → Varianten → Oxid2Tb Reiter können einzelne Varianten vom Export ausgeschlossen werden. Diese Varianten Artikel werden nicht für Tradebyte aufbereitet und exportiert.

Sie können unter FC Tradebyte → Oxid2Tb → Stamm den Export manuell anstoßen. Wenn Sie Artikel für den Export aktiviert haben, wird eine XML-Datei erstellt und auf dem Tradebyte Server zur Verfügung gestellt.

Neben dem manuellen Erzeugen von Exporten, kann der Export und der Order Import auch über einen Cronjob erstellt werden. Dazu müssen Sie einen minütlichen Cronjob erstellen, der folgende PHP-Dateien aufruft.

/modules/fc/fcTradebyteOne/scripts/fctradebyteone_export_batch.php

(Tradebyte Export)

/modules/fc/TradebyteOne/scripts/fctradebyteone_order_import_batch.php

(Tradebyte Order Import)

/modules/fc/TradebyteOne/scripts/fctradebyteone_status_export_batch.php

(Tradebyte Order Status Export)

/modules/fc/TradebyteOne/scripts/fctradebyteonestockexport_batch.php

(Tradebyte Lagerbestandsexport)

1. Welche OXID eShop Versionen sind mit dem OXID 2 Tradebyte Connector von FATCHIP kompatibel?
2. Wie muss ich den FATCHIP OXID 2 Tradebyte Connector konfigurieren?
3. Welche Bilder (Stamm vs. alternative Bilder aus dem Plugin) werden mit welcher Priorität in die XML geschrieben?
4. Können die Produkte, die an Tradebyte exportiert werden sollen, direkt im OXID eShop definiert werden?
5. Ist an den Bestellungen die in OXID importiert werden ersichtlich, über welcher Verkaufskanäle die Bestellungen mittels Tradebyte verkauft werden?
6. Wie werden Versandbenachrichtigungen und Paketnummern an Tradebyte übermittelt?
7. Wie verarbeitet das Plugin Teilstornierungen von Artikelpositionen auf OXID Seite bzw. wie verhält es sich bei Teillieferungen?
8. Wichtige Information zur Benennung der XML Importdatei
9. Wichtige Information zum Orderimport
10. Ist es möglich sFTP zu nutzen?
11. Das Plugin ist richtig konfiguriert, es werden aber dennoch keine bzw. nicht alle Artikel exportiert.
12. Wie kann ein neuer Channel hinzugefügt werden?
13. Warum werden meine Attribute nicht exportiert?

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

Eine detaillierte Schritt für Schritt Anleitung zu der Konfiguration des FATCHIP OXID 2 Tradebyte Connectors finden Sie hier modulbeschreibung_oxid2tb_kurzpraesentation.pdf.

Hinsichtlich der Bilder hat der OXID2TB Reiter Vorrang. Das bedeutet, dass das oberste Bild im OXID2TB das oberste Bild im „normalen“ Bilderstamm überschreibt. Ist das dritte Bild im „normalen“ Bilderstamm mit einem Bild versehen und das dritte Bild im OXID2TB Reiter nicht, wird das Bild aus dem „normalen“ Bilderstamm übermittelt. Fazit: Sind im normalen Bilderstamm 5 Bilder und im OXID2TB 3 Bilder, wird gemischt. 3 Bilder kommen von OXID2TB, die beiden restlichen vom „normalen Bilderstamm“.

Ja, dies kann bequem über ein zusätzliches Häkchen (pro Tradebyte-Kanal) im Adminbereich erfolgen, da bei dem Plugin ein entsprechender Reiter mitgeliefert wird. Wir empfehlen die Markierung der Artikel per WaWi-Schnittstelle oder Ähnlichem zu setzen.

Ja, der entsprechende Vermerk wird in einem neuen oxorder-Feld abgelegt und kann dann weiterverarbeitet werden.

Cronjobgesteuert über die Tradebyte REST API.

Teilstornos werden an Tradebyte per REST API übergeben. Da es für Teillieferungen kein gängiges OXID Standard Verhalten gibt, lässt sich hier auch kein standardisiertes Verhalten festlegen. Dies kann aber individuell im Plugin erweitert werden, vorausgesetzt der OXID eShop wurde bereits um die entsprechenden Funktionen erweitert.

Die Importdatei darf im Namen das Wort „TEST“ NICHT enthalten.

Der Orderimport ist aktuell (19.03.2014) nur über FTP möglich.

Ein Nutzung von sFTP ist nicht möglich. Tradebyte stellt aber sowohl einen sFTP als auch einen FTP-Zugang zur Verfügung. Bitte wenden Sie sich an den Tradebyte-Support, um diese Daten abzufragen.

Zu Tradebyte werden keine Artikel ohne EAN Nummer übertragen. Prüfen Sie daher bitte ob bei allen Artikel EAN-Nummern gepflegt sind oder aktivieren Sie bei Bedarf im Plugin die Option „Eigene EAN generieren wenn nicht gepflegt“. Danach sollte der Export wie gewünscht funktionieren.

Wenn Sie für den Export einen neuen Channel hinzufügen möchten, müssen zwei Anpassungen vorgenommen werden.

1. In der Datei fcTradebyteOneChannels.xml den neuen Kanal hinzufügen

Beispiel:

<channel>
     <title>Weltbild.de</title>
     <abbreviation>wbde</abbreviation>
</channel>

Pfad:

/modules/fc/fcTradebyteOne/files/fcTradebyteOneChannels.xml

Der Titel Weltbild.de im Tag

<title>Weltbild.de</title>

und das Kanalkürzel wbde im Tag

<abbreviation>wbde</abbreviation>

stehen hier exemplarisch für den Kanal Weltbild und müssen dementsprechend für den gewünschten Kanal angepasst werden.

Das passende Kanalkürzel erhalten Sie von Ihrem Tradebyte Account-Manager oder im Tradebyte Kundencenter unter https://infocenter.tradebyte.com.

2. In der Datei fctradebyteone_lang.php die Übersetzungen für den neuen Kanal hinzufügen

Beispiel:

'GENERAL_ARTICLE_FCTBONEWBDEPRICE'     => 'Weltbild.de Preis',
'GENERAL_ARTICLE_FCTBONEWBDEACTIVE'    => 'Weltbild.de aktiv',

Das Kanalkürzel WBDE in der Konstante (z.B. GENERAL_ARTICLE_FCTBONEWBDEPRICE) steht hier exemplarisch für den Kanal Weltbild.de und muss dementsprechend angepasst werden. Die Konstante für die Übersetzung muss eindeutig sein und ggf. für mehrere Sprachen (de/en) gesetzt werden.

Pfade (de/en):

/modules/fc/fcTradebyteOne/application/views/admin/de/fctradebyteone_lang.php
/modules/fc/fcTradebyteOne/application/views/admin/en/fctradebyteone_lang.php

Für den Export der Attribute muss der jeweilige Wert in dem Feld Oxid2Tb attribute (Attribute → Reiter „Oxid2Tb“) gesetzt sein.

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

Sollte das OXID Plugin OXID 2 Tradebyte 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/OXID-2-Tradebyte-Connector-2-0.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