Feld-Mapping Dokumentation: reybex → Tradebyte

Übersicht

Diese Dokumentation beschreibt die Integration zwischen reybex und Tradebyte. Hinweis: Tradebyte unterstützt derzeit keine Material-Updates über die API. Die Integration ist auf das Abrufen und Aktualisieren von Bestellungen beschränkt.

⚠️ WICHTIGER HINWEIS

Diese Dokumentation unterliegt kontinuierlichen Änderungen.

Die Integration zwischen reybex und Tradebyte befindet sich in ständiger Entwicklung. Daher kann es vorkommen, dass:

• Neue Felder hinzugefügt werden - Um zusätzliche Funktionen zu unterstützen oder neue Tradebyte-Features zu nutzen
• Felder temporär entfernt werden - Wenn unerwartete Probleme auftreten, die negative Auswirkungen auf die Artikel haben

Empfehlung:
Bitte überprüfen Sie regelmäßig die aktuelle Dokumentation und testen Sie Änderungen in einer Testumgebung, bevor Sie sie in der Produktion einsetzen.

Verwendung dieser Dokumentation

Diese Dokumentation beschreibt die aktuelle Funktionalität der Tradebyte-Integration.

Wichtige Konzepte

reybex-Artikelstruktur

• Material: Ein Artikel/Produkt in reybex
• MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
• MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel

Tradebyte-Produktstruktur

• Product: Das Produkt in Tradebyte
• XML API: Tradebyte verwendet XML-basierte API

1. Aktuelle Funktionalität

1.1 Material-Update (updateMaterials)

Nicht implementiert: Die updateMaterials-Methode gibt derzeit null zurück.

1.2 Bestellungen (updateOrders)

Tradebyte unterstützt das Aktualisieren von Bestellungen über XML:

Tradebyte Feld	reybex Feld	Beschreibung	Bedingung
MESSAGE.MESSAGE_TYPE	Immer "SHIP"	Nachrichtentyp	Immer
MESSAGE.TB_ORDER_ID	order.id	Tradebyte Bestell-ID	Immer
MESSAGE.TB_ORDER_ITEM_ID	item.id	Tradebyte Bestellposition-ID	Immer
MESSAGE.SKU	item.sku	Artikelnummer	Immer
MESSAGE.CHANNEL_SIGN	Aus Bestellung	Kanal-Signatur	Immer
MESSAGE.CHANNEL_ORDER_ID	Aus Bestellung	Kanal-Bestell-ID	Immer
MESSAGE.CHANNEL_ORDER_ITEM_ID	Aus Bestellung	Kanal-Bestellposition-ID	Immer
MESSAGE.QUANTITY	item.deliveredQuantity	Gelieferte Menge	Immer
MESSAGE.IDCODE	order.licensePlate	Tracking-Nummer	Immer

2. Export-Felder-Gruppen

Die Übertragung wird durch Export-Felder-Gruppen gesteuert:

Export-Gruppe	Beschreibung	Übertragene Tradebyte-Felder
NICHT VERFÜGBAR	Material-Updates	Nicht implementiert

3. Besondere Verhaltensweisen

3.1 XML-basierte API

Tradebyte verwendet XML-basierte API:
- Bestellungen-Update: POST /{storeId}/messages/ (XML)
- Bestellungen-Abruf: GET /{storeId}/orders/ (XML)
- Authentifizierung: Basic Auth

3.2 Material-Update

• Material-Updates sind derzeit nicht implementiert
• Die updateMaterials-Methode gibt null zurück

3.3 Bestellungen-Update

• Bestellungen werden als XML-Nachrichten übertragen
• Format: MESSAGES_LIST mit MESSAGE-Elementen
• Jede Bestellposition wird einzeln übertragen

3.4 Bestellungen-Abruf

• Bestellungen können abgerufen werden
• Format: GET /{storeId}/orders/?export_all_orderlines=true (XML)
• Unterstützt Filterung nach Channels und Zahlungsstatus

4. Zusammenfassung: Vollständige Feld-Mappings

Produkt-Ebene

Tradebyte Feld	reybex Feld	Export-Gruppe	Hinweise
-	-	NICHT VERFÜGBAR	Material-Updates nicht implementiert

Bestellungen-Ebene

Tradebyte Feld	reybex Feld	Export-Gruppe	Hinweise
MESSAGE_TYPE	Immer "SHIP"	-	-
TB_ORDER_ID	order.id	-	-
TB_ORDER_ITEM_ID	item.id	-	-
SKU	item.sku	-	-
CHANNEL_SIGN	Aus Bestellung	-	-
CHANNEL_ORDER_ID	Aus Bestellung	-	-
CHANNEL_ORDER_ITEM_ID	Aus Bestellung	-	-
QUANTITY	item.deliveredQuantity	-	-
IDCODE	order.licensePlate	-	-

5. API-Endpunkte

• Bestellungen-Update: POST /{storeId}/messages/ (XML)
• Bestellungen-Abruf: GET /{storeId}/orders/ (XML)
• Material-Update: Nicht implementiert
• Authentifizierung: Basic Auth

---

Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse