Feld-Mapping Dokumentation: reybex → CS-Cart
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach CS-Cart übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die CS-Cart REST API.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und CS-Cart 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 CS-Cart-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 CS-Cart übertragen werden. Für jedes CS-Cart-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 CS-Cart Product)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
CS-Cart-Produktstruktur
- Product: Das Hauptprodukt in CS-Cart
- Product Features: Produkteigenschaften (z.B. Marke)
- Product Options: Varianten-Optionen
1. Produkt-Felder (Product Level)
Die folgenden Felder werden auf Produktebene in CS-Cart übertragen:
1.1 Basis-Informationen
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.product |
material.name |
Produktname | Export-Gruppe: ARTIKEL_DATA |
product.product_code |
material.sku |
Artikelnummer | Export-Gruppe: ARTIKEL_DATA |
product.ean |
material.gtin |
EAN/GTIN | Export-Gruppe: ARTIKEL_DATA |
product.lang_code |
material.country.code |
Sprachcode | Export-Gruppe: ARTIKEL_DATA |
product.avail_since |
new Date() |
Verfügbar seit | Export-Gruppe: ARTIKEL_DATA |
product.page_title |
material.name |
Seiten-Titel | Export-Gruppe: ARTIKEL_DATA |
product.weight |
material.netWeight |
Gewicht | Export-Gruppe: ARTIKEL_DATA |
product.box_width |
material.width |
Breite | Export-Gruppe: ARTIKEL_DATA |
product.box_height |
material.height |
Höhe | Export-Gruppe: ARTIKEL_DATA |
product.box_length |
material.length |
Länge | Export-Gruppe: ARTIKEL_DATA |
product.status |
material.isMarketplaceActive |
Status ('A'=Aktiv, 'D'=Inaktiv) | Immer |
product.product_type |
Automatisch | Produkttyp ('P'=Kombination, 'S'=Einfach) | Immer |
product.company_id |
params.authentication.storeId |
Unternehmen-ID | Immer |
1.2 Kategorien
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.category_ids[] |
material.categories[].id |
Kategorien (als IDs) | Export-Gruppe: ARTIKEL_DATA |
product.main_category |
material.categories[0].id |
Hauptkategorie | Export-Gruppe: ARTIKEL_DATA |
1.3 Preise
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.price |
material.price.value |
Verkaufspreis | Export-Gruppe: PRICE |
product.list_price |
material.price.rrp |
UVP/Listenpreis | Export-Gruppe: PRICE |
1.4 Bestand
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.amount |
material.stock.value |
Bestand | Export-Gruppe: STOCK |
1.5 Beschreibung
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.full_description |
material.detailDescription oder material.description |
Vollständige Beschreibung | Export-Gruppe: DESCRIPTION |
product.short_description |
material.description |
Kurzbeschreibung | Export-Gruppe: DESCRIPTION |
1.6 SEO-Felder
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.meta_description |
material.metaDescription oder material.detailDescription |
SEO-Beschreibung | Export-Gruppe: SEO |
product.meta_keywords |
material.keyWord |
SEO-Schlüsselwörter | Export-Gruppe: SEO |
1.7 Bilder
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.main_pair |
material.images[].image.url (Hauptbild) |
Hauptbild | Export-Gruppe: IMAGE |
product.image_pairs[] |
material.images[].image.url (weitere Bilder) |
Weitere Bilder | Export-Gruppe: IMAGE |
Hinweise:
- Format: {detailed: {image_path: "url"}}
- Hauptbild wird aus material.images extrahiert (isMain = true)
1.8 Versand
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.free_shipping |
material.isShippingFree |
Versandkostenfrei | Export-Gruppe: SHIPPING |
product.handlingtime |
material.listingDays |
Bearbeitungszeit | Export-Gruppe: SHIPPING |
Handlingtime-Mapping:
- < 2 Tage → "1"
- < 4 Tage → "2"
- >= 4 Tage → "3"
1.9 Steuern
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.tax_ids[] |
material.vatKeyCode |
Steuerklassen-IDs | Export-Gruppe: ARTIKEL_DATA |
Hinweise:
- Steuerklassen werden anhand vatKeyCode gesucht
- Format: [taxRateId]
1.10 Produkteigenschaften (Features)
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.product_features[] |
material.brand.name |
Marke als Feature | Export-Gruppe: ARTIKEL_DATA |
Hinweise:
- Marke wird als Product Feature übertragen
- Features werden automatisch erstellt, wenn sie nicht existieren
- Format: {featureId: X, variantId: Y}
1.11 Varianten-Optionen
| CS-Cart Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.product_options[] |
material.variants.items[].nameValuePairs |
Varianten-Optionen | Export-Gruppe: VARIANT |
Hinweise:
- Optionen werden über setProductOptions() erstellt
- Format: {option_id: X, option_value_id: Y, ...}
2. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene CS-Cart-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | product, product_code, ean, lang_code, avail_since, page_title, weight, box_width, box_height, box_length, category_ids, main_category, tax_ids, product_features |
| DESCRIPTION | Beschreibung | full_description, short_description |
| PRICE | Preis | price, list_price |
| STOCK | Bestand | amount |
| SEO | SEO-Felder | meta_description, meta_keywords |
| IMAGE | Bilder | main_pair, image_pairs[] |
| SHIPPING | Versand | free_shipping, handlingtime |
| VARIANT | Varianten | product_options[] |
3. Besondere Verhaltensweisen
3.1 REST API
CS-Cart verwendet REST API für alle Operationen:
- Produkt-Erstellung: POST /api/products (JSON)
- Produkt-Update: PUT /api/products/{productId} (JSON)
3.2 Marken-Verwaltung
- Marken werden als Product Features übertragen
- Features werden automatisch erstellt, wenn sie nicht existieren
- Verwendet
getBrandsFromCompany()undsetFeatureBody()Methoden
3.3 Steuerklassen
- Steuerklassen werden anhand
vatKeyCodegesucht - Verwendet
getTaxRates()Methode - Format:
[taxRateId]
3.4 Varianten-Verwaltung
- Varianten werden über
setProductOptions()erstellt - Optionen werden automatisch erstellt, wenn sie nicht existieren
- Verwendet
setVariant()Methode für Varianten-Details
3.5 Produkttyp
product_type = 'P'wenn Varianten vorhanden (Kombination)product_type = 'S'wenn keine Varianten (Einfach)
4. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| CS-Cart Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
product |
material.name |
ARTIKEL_DATA | - |
product_code |
material.sku |
ARTIKEL_DATA | - |
ean |
material.gtin |
ARTIKEL_DATA | - |
lang_code |
material.country.code |
ARTIKEL_DATA | - |
avail_since |
new Date() |
ARTIKEL_DATA | - |
page_title |
material.name |
ARTIKEL_DATA | - |
weight |
material.netWeight |
ARTIKEL_DATA | - |
box_width |
material.width |
ARTIKEL_DATA | - |
box_height |
material.height |
ARTIKEL_DATA | - |
box_length |
material.length |
ARTIKEL_DATA | - |
status |
material.isMarketplaceActive |
Immer | 'A' oder 'D' |
product_type |
Automatisch | Immer | 'P' oder 'S' |
company_id |
params.authentication.storeId |
Immer | - |
category_ids[] |
material.categories[].id |
ARTIKEL_DATA | - |
main_category |
material.categories[0].id |
ARTIKEL_DATA | - |
price |
material.price.value |
PRICE | - |
list_price |
material.price.rrp |
PRICE | - |
amount |
material.stock.value |
STOCK | - |
full_description |
material.detailDescription oder description |
DESCRIPTION | - |
short_description |
material.description |
DESCRIPTION | - |
meta_description |
material.metaDescription oder detailDescription |
SEO | - |
meta_keywords |
material.keyWord |
SEO | - |
main_pair |
material.images[].image.url (Hauptbild) |
IMAGE | - |
image_pairs[] |
material.images[].image.url (weitere) |
IMAGE | - |
free_shipping |
material.isShippingFree |
SHIPPING | - |
handlingtime |
material.listingDays |
SHIPPING | - |
tax_ids[] |
material.vatKeyCode |
ARTIKEL_DATA | - |
product_features[] |
material.brand.name |
ARTIKEL_DATA | - |
product_options[] |
material.variants.items[].nameValuePairs |
VARIANT | - |
5. API-Endpunkte
- Produkt-Erstellung:
POST /api/products - Produkt-Update:
PUT /api/products/{productId} - Features:
GET /api/features,POST /api/features - Steuern:
GET /api/taxes - Optionen: Separate API-Calls
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse