Feld-Mapping Dokumentation: reybex → Kaufland
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach Kaufland übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die Kaufland Seller API.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Kaufland 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 Kaufland-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 Kaufland übertragen werden. Für jedes Kaufland-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 Kaufland Product)
- MaterialVariant: Eine Variante eines Artikels in reybex
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Kaufland-Produktstruktur
- Product: Das Hauptprodukt in Kaufland
- Inventory Unit: Bestandseinheit
- Category Attributes: Kategorie-spezifische Attribute
1. Produkt-Felder (Product Level)
Die folgenden Felder werden auf Produktebene in Kaufland übertragen:
1.1 Basis-Informationen
| Kaufland Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.ean |
material.gtin |
EAN/GTIN | Immer |
product.title |
material.name |
Produktname | Export-Gruppe: ARTIKEL_DATA |
product.description |
material.detailDescription |
Produktbeschreibung | Export-Gruppe: DESCRIPTION |
product.category_id |
material.categories[].id |
Kategorie-ID | Export-Gruppe: CATEGORY |
1.2 Preise
| Kaufland Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.price |
material.price.value |
Verkaufspreis | Export-Gruppe: PRICE |
product.rrp |
material.price.rrp |
UVP/Listenpreis | Export-Gruppe: PRICE |
1.3 Bestand
| Kaufland Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
inventory_unit.quantity |
material.stock.value |
Bestand | Export-Gruppe: STOCK |
inventory_unit.unit_id |
material.unitId |
Einheits-ID | Export-Gruppe: STOCK |
Hinweise:
- Bestand wird über separate inventory_unit API übertragen
- unitId wird automatisch erstellt, wenn nicht vorhanden
1.4 Attribute
| Kaufland Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.attributes[] |
material.categories.specs |
Kategorie-Attribute | Export-Gruppe: ARTIKEL_ATTRIBUTE |
Hinweise:
- Attribute werden aus Kategorie-Spezifikationen extrahiert
- Required und Optional Attributes werden unterschieden
2. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Kaufland-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | ean, title |
| DESCRIPTION | Beschreibung | description |
| PRICE | Preis | price, rrp |
| STOCK | Bestand | inventory_unit.quantity, inventory_unit.unit_id |
| CATEGORY | Kategorien | category_id |
| ARTIKEL_ATTRIBUTE | Artikelattribute | attributes[] |
3. Besondere Verhaltensweisen
3.1 HMAC-SHA256 Signatur
Kaufland verwendet HMAC-SHA256 für Request-Signierung:
- Signature wird aus Method, URI, Body und Timestamp erstellt
- Headers: shop-signature, shop-timestamp, shop-client-key
3.2 EAN-Matching
- System sucht nach passender EAN in Kaufland
- Wenn EAN gefunden: Produkt wird aktualisiert
- Wenn EAN nicht gefunden: Neues Produkt wird erstellt
3.3 Inventory Unit Management
- Bestand wird über separate
inventory_unitAPI verwaltet unitIdwird automatisch erstellt, wenn nicht vorhanden- Verwendet
addInventoryUnit()oderupdateInventoryUnit()Methoden
3.4 Separates Stock-Management
- Bestand kann über separate
setStocks()Methode übertragen werden - API-Endpoint: Separate Inventory Unit API
4. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| Kaufland Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
ean |
material.gtin |
ARTIKEL_DATA | - |
title |
material.name |
ARTIKEL_DATA | - |
description |
material.detailDescription |
DESCRIPTION | - |
category_id |
material.categories[].id |
CATEGORY | - |
price |
material.price.value |
PRICE | - |
rrp |
material.price.rrp |
PRICE | - |
attributes[] |
material.categories.specs |
ARTIKEL_ATTRIBUTE | - |
inventory_unit.quantity |
material.stock.value |
STOCK | - |
inventory_unit.unit_id |
material.unitId |
STOCK | - |
5. API-Endpunkte
- Produkt-Erstellung:
POST /products - Produkt-Update:
PUT /products/{ean} - Inventory Unit-Erstellung:
POST /inventory-units - Inventory Unit-Update:
PUT /inventory-units/{ean} - Kategorien:
GET /categories/tree - Kategorie-Attribute:
GET /categories/{id}
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse