Feld-Mapping Dokumentation: reybex → Databaseshop

Übersicht

Diese Dokumentation beschreibt, welche Felder von reybex nach Databaseshop übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über eine Datenbank-Stored-Procedure (SQL Server oder MySQL).

⚠️ WICHTIGER HINWEIS

Diese Dokumentation unterliegt kontinuierlichen Änderungen.

Die Integration zwischen reybex und Databaseshop 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 Databaseshop-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 Databaseshop übertragen werden. Für jedes Databaseshop-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 Databaseshop Product)
MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel

Databaseshop-Produktstruktur

Product: Das Hauptprodukt in Databaseshop
Stored Procedure: RBX_updateMaterials (SQL Server oder MySQL)

1. Produkt-Felder (Product Level)

Die folgenden Felder werden auf Produktebene in Databaseshop übertragen:

1.1 Basis-Informationen

Databaseshop Feld	reybex Feld	Beschreibung	Bedingung
`product.id`	`material.marketplaceProductId`	Produkt-ID	Immer
`product.sku`	`material.sku`	Artikelnummer	Immer
`product.materialBaseSku`	`material.materialBaseSku`	Basis-Artikelnummer	Immer
`product.gtin`	`material.gtin`	EAN/GTIN	Immer
`product.name`	`material.name`	Produktname	Immer
`product.variantName`	`material.variantName`	Variantenname	Immer
`product.brand`	`material.brand.name`	Markenname	Immer
`product.manufacturerNumber`	`material.manufacturer.number`	Hersteller-Artikelnummer	Immer
`product.basePriceUnitName`	`material.basePriceUnit.name`	Grundpreis-Einheit	Immer
`product.purchaseUnit`	`material.purchaseUnit`	Einkaufseinheit	Immer
`product.tenantId`	`params.authentication.tenantId`	Mandanten-ID	Immer
`product.storeId`	`params.authentication.storeId`	Shop-ID	Immer
`product.storeLanguage`	`params.authentication.storeLanguage`	Shop-Sprache	Immer

1.2 Beschreibung

Databaseshop Feld	reybex Feld	Beschreibung	Bedingung
`product.description`	`material.description`	Kurzbeschreibung	Immer
`product.detailDescription`	`material.detailDescription`	Vollständige Beschreibung	Immer

1.3 Preise

Databaseshop Feld	reybex Feld	Beschreibung	Bedingung
`product.price`	`material.price.value`	Verkaufspreis	Immer
`product.purPrice`	`material.purPrice`	Einkaufspreis	Immer
`product.currency`	`material.price.currency`	Währung	Immer

1.4 Bestand

Databaseshop Feld	reybex Feld	Beschreibung	Bedingung
`product.stock`	`material.stock.value`	Bestand	Immer

1.5 Steuern

Databaseshop Feld	reybex Feld	Beschreibung	Bedingung
`product.vatRate`	`material.vatRate`	MwSt.-Satz	Immer
`product.isVatKeyReduced`	`material.isVatKeyReduced`	Reduzierter MwSt.-Schlüssel	Immer

1.6 Gewicht

Databaseshop Feld	reybex Feld	Beschreibung	Bedingung
`product.netWeight`	`material.netWeight`	Nettogewicht	Immer

1.7 Kategorien

Databaseshop Feld	reybex Feld	Beschreibung	Bedingung
`product.categories`	`material.categories[].id` (als komma-separierte Liste)	Kategorien	Immer

Hinweise:
- Format: "1,2,3" (komma-separierte IDs)

1.8 Übersetzungen

Databaseshop Feld	reybex Feld	Beschreibung	Bedingung
`product.translations[]`	`material.translations[]`	Übersetzungen	Immer

Hinweise:
- Format: [{language: "de", name: "Text", description: "Text", ...}]

1.9 Varianten

Databaseshop Feld	reybex Feld	Beschreibung	Bedingung
`product.variants[]`	`material.variants.items[]`	Varianten	Immer

Varianten-Format:
- [{sku, asin, gtin, name, stock, isMain, order, tax, price, rrp, currency, nameValuePairs}]

1.10 Name-Value-Pairs

Databaseshop Feld	reybex Feld	Beschreibung	Bedingung
`product.nameValuePairs`	`material.nameValuePairs[]`	Name-Wert-Paare	Immer

Hinweise:
- Format: {name1: value1, name2: value2, ...}

2. Export-Felder-Gruppen

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

Export-Gruppe	Beschreibung	Übertragene Databaseshop-Felder
ARTIKEL_DATA	Artikeldaten	`id`, `sku`, `materialBaseSku`, `gtin`, `name`, `variantName`, `brand`, `manufacturerNumber`, `basePriceUnitName`, `purchaseUnit`, `tenantId`, `storeId`, `storeLanguage`
DESCRIPTION	Beschreibung	`description`, `detailDescription`
PRICE	Preis	`price`, `purPrice`, `currency`
STOCK	Bestand	`stock`
TAX	Steuern	`vatRate`, `isVatKeyReduced`
MESS	Gewicht	`netWeight`
CATEGORY	Kategorien	`categories`
VARIANT	Varianten	`variants[]`
ARTIKEL_ATTRIBUTE	Artikelattribute	`nameValuePairs`

3. Besondere Verhaltensweisen

3.1 Stored Procedure

Databaseshop verwendet eine Stored Procedure für alle Operationen:
- SQL Server: EXEC RBX_updateMaterials '{materialJson}', '{materialFieldsToExport}'
- MySQL: CALL RBX_updateMaterials('{materialJson}', '{materialFieldsToExport}')

3.2 JSON-Format

Alle Material-Daten werden als JSON übertragen
Format: JsonOutput.toJson(material)
Stored Procedure verarbeitet das JSON

3.3 Export-Felder-Gruppen

Export-Felder-Gruppen werden als String-Parameter übergeben
Format: "ARTIKEL_DATA,DESCRIPTION,PRICE,STOCK,..."

3.4 Fehlerbehandlung

Fehler werden aus requestResponse.success und requestResponse.affectedRows erkannt
Wenn success = false oder affectedRows = 0: Fehler wird gemeldet

3.5 Varianten-Verarbeitung

Varianten werden über getVariants() Methode formatiert
Format: [{sku, asin, gtin, name, stock, isMain, order, tax, price, rrp, currency, nameValuePairs}]

4. Zusammenfassung: Vollständige Feld-Mappings

Produkt-Ebene

Databaseshop Feld	reybex Feld	Export-Gruppe	Hinweise
`id`	`material.marketplaceProductId`	ARTIKEL_DATA	-
`sku`	`material.sku`	ARTIKEL_DATA	-
`materialBaseSku`	`material.materialBaseSku`	ARTIKEL_DATA	-
`gtin`	`material.gtin`	ARTIKEL_DATA	-
`name`	`material.name`	ARTIKEL_DATA	-
`variantName`	`material.variantName`	ARTIKEL_DATA	-
`description`	`material.description`	DESCRIPTION	-
`detailDescription`	`material.detailDescription`	DESCRIPTION	-
`stock`	`material.stock.value`	STOCK	-
`price`	`material.price.value`	PRICE	-
`purPrice`	`material.purPrice`	PRICE	-
`isVatKeyReduced`	`material.isVatKeyReduced`	TAX	-
`currency`	`material.price.currency`	PRICE	-
`netWeight`	`material.netWeight`	MESS	-
`vatRate`	`material.vatRate`	TAX	-
`manufacturerNumber`	`material.manufacturer.number`	ARTIKEL_DATA	-
`brand`	`material.brand.name`	ARTIKEL_DATA	-
`basePriceUnitName`	`material.basePriceUnit.name`	ARTIKEL_DATA	-
`purchaseUnit`	`material.purchaseUnit`	ARTIKEL_DATA	-
`categories`	`material.categories[].id` (komma-separiert)	CATEGORY	-
`translations[]`	`material.translations[]`	DESCRIPTION	-
`variants[]`	`material.variants.items[]`	VARIANT	-
`nameValuePairs`	`material.nameValuePairs[]`	ARTIKEL_ATTRIBUTE	-
`tenantId`	`params.authentication.tenantId`	ARTIKEL_DATA	-
`storeId`	`params.authentication.storeId`	ARTIKEL_DATA	-
`storeLanguage`	`params.authentication.storeLanguage`	ARTIKEL_DATA	-

5. API-Endpunkte

Stored Procedure (SQL Server): EXEC RBX_updateMaterials '{materialJson}', '{materialFieldsToExport}'
Stored Procedure (MySQL): CALL RBX_updateMaterials('{materialJson}', '{materialFieldsToExport}')

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

← Zurück zur Übersicht