Feld-Mapping Dokumentation: reybex → Ciceksepeti
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach Ciceksepeti übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die Ciceksepeti REST API.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Ciceksepeti 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 Ciceksepeti-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 Ciceksepeti übertragen werden. Für jedes Ciceksepeti-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 Ciceksepeti Product)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Ciceksepeti-Produktstruktur
- Product: Das Hauptprodukt in Ciceksepeti
- Barcode: EAN/GTIN als eindeutige Produktkennung
- Batch System: Asynchrones Batch-System für Produkt-Updates
1. Produkt-Felder (Product Level)
Die folgenden Felder werden auf Produktebene in Ciceksepeti übertragen:
1.1 Basis-Informationen
| Ciceksepeti Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.productName |
material.name oder variant.name |
Produktname | Immer |
product.mainProductCode |
material.matCode oder material.matCode + "-" + material.gtin |
Hauptproduktcode | Immer |
product.stockCode |
material.sku oder variant.sku |
Bestandscode/SKU | Immer |
product.categoryId |
material.categories[].id |
Kategorie-ID | Immer |
product.barcode |
material.gtin oder variant.gtin |
EAN/GTIN (Barcode) | Immer |
product.isActive |
material.isMarketplaceActive |
Aktiv-Status | Immer |
product.deliveryType |
Immer 2 |
Versandtyp | Immer |
product.deliveryMessageType |
Immer 5 |
Versandnachrichtentyp | Immer |
Hinweise:
- barcode ist erforderlich (GTIN)
- categoryId ist erforderlich
- detailDescription ist erforderlich
1.2 Preise
| Ciceksepeti Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.salesPrice |
material.price.value oder variant.price.value |
Verkaufspreis | Immer |
product.listPrice |
Berechnet aus material.price.rrp und value |
Listenpreis/UVP | Immer |
Preislogik:
- listPrice = rrp wenn vorhanden und > value, sonst value
- Wird über calculateListPrice() berechnet
1.3 Bestand
| Ciceksepeti Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.stockQuantity |
material.stock.value oder variant.stock |
Bestand | Immer |
Hinweise:
- Bei Varianten: variant.stock
- Bei Hauptprodukt: material.stock.value
1.4 Beschreibung
| Ciceksepeti Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.description |
material.detailDescription |
Produktbeschreibung (max 7750 Zeichen) | Immer |
Hinweise:
- description wird auf 7750 Zeichen begrenzt
- detailDescription ist erforderlich
1.5 Bilder
| Ciceksepeti Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.images[] |
material.images[] oder variant.images[] |
Produktbilder | Immer |
Hinweise:
- Format: [url1, url2, ...]
- Bilder werden über getStaticUrl() generiert
1.6 Attribute
| Ciceksepeti Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.Attributes[] |
material.categories.specs und variant.nameValuePairs |
Kategorie-Attribute und Varianten-Attribute | Immer |
Hinweise:
- Attribute werden aus Kategorie-Spezifikationen extrahiert
- Varianten-Attribute werden als attributeId und attributeValueId übertragen
- Format: [{attributeId: X, attributeValueId: Y}] oder [{attributeId: X, customAttributeValue: "Y"}]
2. Varianten-Felder
Die folgenden Felder werden auf Variantenebene in Ciceksepeti übertragen:
2.1 Basis-Informationen
| Ciceksepeti Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
variant.productName |
material.name |
Variantenname | Export-Gruppe: VARIANT |
variant.mainProductCode |
material.matCode |
Hauptproduktcode | Export-Gruppe: VARIANT |
variant.stockCode |
variant.sku |
Varianten-SKU | Export-Gruppe: VARIANT |
variant.barcode |
variant.gtin |
Varianten-EAN/GTIN | Export-Gruppe: VARIANT |
2.2 Preise
| Ciceksepeti Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
variant.salesPrice |
variant.price.value |
Variantenpreis | Export-Gruppe: VARIANT |
variant.listPrice |
Berechnet aus variant.price.rrp und value |
Varianten-UVP | Export-Gruppe: VARIANT |
2.3 Bestand
| Ciceksepeti Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
variant.stockQuantity |
variant.stock |
Variantenbestand | Export-Gruppe: VARIANT |
3. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Ciceksepeti-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | productName, mainProductCode, stockCode, categoryId, barcode, isActive |
| DESCRIPTION | Beschreibung | description |
| PRICE | Preis | salesPrice, listPrice |
| STOCK | Bestand | stockQuantity |
| CATEGORY | Kategorien | categoryId |
| ARTIKEL_ATTRIBUTE | Artikelattribute | Attributes[] |
| IMAGE | Bilder | images[] |
| VARIANT | Varianten | Alle Varianten-Felder |
4. Besondere Verhaltensweisen
4.1 Batch-System
Ciceksepeti verwendet ein asynchrones Batch-System für Produkt-Updates:
- Neue Produkte: POST /Products (Batch)
- Bestehende Produkte: PUT /Products (Batch)
- Batch-Status: GET /Products/batch-status/{batchId}
4.2 Separates Stock/Price-Management
- Bestand und Preise können über separate API übertragen werden
- Verwendet
setStocks()Methode
4.3 Fehlerbehandlung
- System prüft Batch-Responses auf Fehler
- Wenn Barcode bereits existiert: Produkt wird aktualisiert statt erstellt
- Wenn Barcode nicht existiert: Produkt wird erstellt statt aktualisiert
4.4 Varianten-Verwaltung
- Varianten werden als separate Produkte übertragen
barcode(GTIN) verknüpft Varianten mit Hauptprodukt- Varianten-Attribute werden automatisch erstellt, wenn nicht vorhanden
4.5 Kategorie-Attribute
- Attribute werden aus Kategorie-Spezifikationen extrahiert
- Required und Optional Attributes werden unterschieden
- API-Endpoint:
GET /categories/{categoryId}/attributes
5. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| Ciceksepeti Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
productName |
material.name |
ARTIKEL_DATA | - |
mainProductCode |
material.matCode |
ARTIKEL_DATA | - |
stockCode |
material.sku |
ARTIKEL_DATA | - |
categoryId |
material.categories[].id |
CATEGORY | Erforderlich |
barcode |
material.gtin |
ARTIKEL_DATA | Erforderlich |
isActive |
material.isMarketplaceActive |
ARTIKEL_DATA | - |
salesPrice |
material.price.value |
PRICE | - |
listPrice |
Berechnet aus rrp und value |
PRICE | - |
stockQuantity |
material.stock.value |
STOCK | - |
description |
material.detailDescription |
DESCRIPTION | Max 7750 Zeichen, erforderlich |
images[] |
material.images[] |
IMAGE | - |
Attributes[] |
material.categories.specs |
ARTIKEL_ATTRIBUTE | - |
deliveryType |
Immer 2 |
Immer | - |
deliveryMessageType |
Immer 5 |
Immer | - |
Varianten-Ebene
| Ciceksepeti Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
productName |
material.name |
VARIANT | - |
mainProductCode |
material.matCode |
VARIANT | - |
stockCode |
variant.sku |
VARIANT | - |
barcode |
variant.gtin |
VARIANT | Erforderlich |
salesPrice |
variant.price.value |
VARIANT | - |
listPrice |
Berechnet aus variant.price.rrp und value |
VARIANT | - |
stockQuantity |
variant.stock |
VARIANT | - |
images[] |
variant.images[] |
VARIANT | - |
Attributes[] |
variant.nameValuePairs |
VARIANT | - |
6. API-Endpunkte
- Produkt-Erstellung:
POST /Products(Batch) - Produkt-Update:
PUT /Products(Batch) - Batch-Status:
GET /Products/batch-status/{batchId} - Kategorien:
GET /Categories - Kategorie-Attribute:
GET /categories/{categoryId}/attributes
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse