Feld-Mapping Dokumentation: reybex → Reybexshop
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach Reybexshop übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über eine REST API.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Reybexshop 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 Reybexshop-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 zeigt, welche Felder von reybex nach Reybexshop übertragen werden. Für jedes Reybexshop-Feld wird angegeben:
- Welches reybex-Feld die Quelle ist
- Unter welcher Bedingung es übertragen wird (Export-Gruppe)
- Besondere Hinweise zur Übertragung
Wichtige Konzepte
reybex-Artikelstruktur
- Material: Ein Artikel/Produkt in reybex (entspricht Reybexshop Product)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Reybexshop-Produktstruktur
- Product: Das Hauptprodukt in Reybexshop
- REST API:
POST /updateMaterials(JSON)
1. Produkt-Felder (Product Level)
Die folgenden Felder werden auf Produktebene in Reybexshop übertragen:
1.1 Vollständige Material-Übertragung
Reybexshop verwendet eine vollständige Material-Übertragung, d.h. alle Material-Daten werden als JSON-Objekt übertragen:
| Reybexshop Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
materials[] |
params.materials[] |
Vollständige Material-Liste | Immer |
Hinweise:
- Alle Material-Daten werden als JSON-Array übertragen
- Format: [{sku, name, description, price, stock, ...}]
- Die Verarbeitung erfolgt serverseitig in Reybexshop
2. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Reybexshop-Felder |
|---|---|---|
| ALLE | Alle Artikeldaten | materials[] (vollständige Material-Objekte) |
3. Besondere Verhaltensweisen
3.1 REST API
Reybexshop verwendet REST API für alle Operationen:
- Material-Update: POST /updateMaterials (JSON)
- Authentifizierung: Basic Auth mit API-Key
3.2 Vollständige Material-Übertragung
- Alle Material-Daten werden als vollständige JSON-Objekte übertragen
- Die Verarbeitung und Feld-Mappings erfolgen serverseitig in Reybexshop
- Format:
[{material1}, {material2}, ...]
3.3 Fehlerbehandlung
- Fehler werden aus der Response erkannt
- Format:
{success: true/false, message: "..."}
4. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| Reybexshop Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
materials[] |
params.materials[] |
ALLE | Vollständige Material-Objekte |
5. API-Endpunkte
- Material-Update:
POST /updateMaterials(JSON) - Authentifizierung: Basic Auth mit API-Key
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse