Feld-Mapping Dokumentation: reybex → Hood

Übersicht

Diese Dokumentation beschreibt, welche Felder von reybex nach Hood übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die Hood XML API.

⚠️ WICHTIGER HINWEIS

Diese Dokumentation unterliegt kontinuierlichen Änderungen.

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

Hood-Produktstruktur

Auction: Das Produktangebot in Hood
XML API: Hood verwendet XML-basierte API

1. Produkt-Felder (Auction Level)

Die folgenden Felder werden auf Auction-Ebene in Hood übertragen:

1.1 Basis-Informationen

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.itemNumber`	`material.sku`	Artikelnummer	Immer
`auction.referenceID`	`material.sku`	Referenz-ID	Immer
`auction.auctionName`	`material.name`	Produktname	Wenn `ARTIKEL_DATA`
`auction.auctionNameSubTitle`	`material.subTitle`	Untertitel	Wenn vorhanden
`auction.ifIsSoldOut`	`material.isOnlySellableWithPositiveStock ? "hide" : "endless"`	Ausverkauft-Verhalten	Immer
`auction.isApproved`	`material.isMarketplaceActive ? 1 : 0`	Genehmigt	Immer
`auction.useSubtitleForAuction`	`material.subTitle ? 1 : 0`	Untertitel verwenden	Immer
`auction.auctionID`	`material.marketplaceProductId`	Auction-ID	Bei Update

1.2 Artikeldaten

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.ean`	`material.gtin`	EAN	Wenn `ARTIKEL_DATA` und vorhanden
`auction.salesTax`	`material.vatRate` oder `0`	MwSt.-Satz	Wenn `ARTIKEL_DATA`
`auction.weight`	`material.grossWeight` oder `0`	Gewicht	Wenn `ARTIKEL_DATA`
`auction.manufacturer`	`material.brand.name`	Hersteller	Wenn `ARTIKEL_DATA` und vorhanden
`auction.energyEfficiencyClass`	`material.energyEfficiency.name`	Energieeffizienzklasse	Wenn vorhanden
`auction.fsk`	`material.fsk`	FSK	Wenn vorhanden
`auction.usk`	`material.usk`	USK	Wenn vorhanden

1.3 Basispreis-Berechnung

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.packagingUnit`	`material.packUnit`	Verpackungseinheit	Wenn `BASE_PRICE_CALCULATION` und vorhanden
`auction.PackagingSize`	`material.volume`	Verpackungsgröße	Wenn `BASE_PRICE_CALCULATION` und vorhanden
`auction.unit`	`material.basePriceUnit.unit` oder `""`	Einheit	Wenn `BASE_PRICE_CALCULATION`

1.4 Bestand

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.quantity`	`material.stock.value`	Bestand	Wenn `STOCK`
`auction.deliveryDaysOnStockFrom`	`material.reorderStockLevel`	Liefertage ab Bestand	Wenn `STOCK` und vorhanden

1.5 Preise

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.priceBuyNow`	`material.price.value`	Kaufpreis	Wenn `PRICE`
`auction.listPrice`	`material.price.rrp`	Listenpreis	Wenn `PRICE` und vorhanden
`auction.purchasePrice`	`material.purchasePrice`	Einkaufspreis	Wenn `PRICE` und vorhanden

1.6 Kategorien

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.categoryID`	`material.categories[0].id` (nicht custom)	Kategorie-ID	Wenn `CATEGORY` und vorhanden
`auction.prodCatID`	`material.categories[0].id` (custom)	Shop-Kategorie-ID	Wenn `CATEGORY` und vorhanden

1.7 Beschreibung

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.description`	`material.detailDescription` oder `material.description`	Beschreibung	Wenn `DESCRIPTION`
`auction.shortDesc`	`material.description`	Kurzbeschreibung	Wenn `DESCRIPTION` und vorhanden

1.8 Bilder

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.images.image[]` oder `auction.images.imageURL[]`	`material.images.image[]`	Produktbilder	Wenn `IMAGE`

1.9 Varianten

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.productOptions.productOption[]`	`material.variants.items[]`	Produktoptionen	Wenn `VARIANT`

1.10 Zahlungsmethoden

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.payOptions.option[]`	`material.paymentMethods[]`	Zahlungsmethoden	Wenn `PAYMENT`

1.11 Versandmethoden

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.shipmethods.shipmethod[].name`	`getShippingCode(...) + "nat/eu/at/ch/int"`	Versandmethoden	Wenn `SHIPPING`
`auction.shipmethods.shipmethod[].value`	`material.shipping.inlandShippingCost` oder `foreignCountryShippingCost`	Versandkosten	Wenn `SHIPPING`

1.12 Attribute

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.productProperties.nameValueList[]`	`material.attributes[]`	Produkteigenschaften	Wenn `ARTIKEL_ATTRIBUTE`

1.13 Neue Artikel

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.auctionMode`	Immer `"shopProduct"`	Auction-Modus	Bei neuen Artikeln
`auction.condition`	Immer `"new"`	Zustand	Bei neuen Artikeln
`auction.startDate`	Aktuelles Datum (dd.MM.yyyy)	Startdatum	Bei neuen Artikeln
`auction.startTime`	Immer `"00:00"`	Startzeit	Bei neuen Artikeln
`auction.durationInDays`	`material.listingDays` oder `90`	Dauer in Tagen	Bei neuen Artikeln
`auction.autoRenew`	Immer `1`	Auto-Erneuerung	Bei neuen Artikeln

1.14 Hersteller-Kontakt

Hood Feld	reybex Feld	Beschreibung	Bedingung
`auction.productContactInformation.manufacturer.name`	`material.manufacturer.name`	Herstellername	Wenn vorhanden
`auction.productContactInformation.manufacturer.street`	`material.manufacturer.street`	Straße	Wenn vorhanden
`auction.productContactInformation.manufacturer.zip`	`material.manufacturer.zipCode`	PLZ	Wenn vorhanden
`auction.productContactInformation.manufacturer.city`	`material.manufacturer.city`	Stadt	Wenn vorhanden
`auction.productContactInformation.manufacturer.country2DigitCode`	`material.manufacturer.country`	Ländercode	Wenn vorhanden
`auction.productContactInformation.manufacturer.phone`	`material.manufacturer.phone`	Telefon	Wenn vorhanden
`auction.productContactInformation.manufacturer.email`	`material.manufacturer.email`	E-Mail	Wenn vorhanden

2. Export-Felder-Gruppen

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

Export-Gruppe	Beschreibung	Übertragene Hood-Felder
ARTIKEL_DATA	Artikeldaten	`auctionName`, `ean`, `salesTax`, `weight`, `manufacturer`
BASE_PRICE_CALCULATION	Basispreis-Berechnung	`packagingUnit`, `PackagingSize`, `unit`
STOCK	Bestand	`quantity`, `deliveryDaysOnStockFrom`
PRICE	Preis	`priceBuyNow`, `listPrice`, `purchasePrice`
CATEGORY	Kategorie	`categoryID`, `prodCatID`
DESCRIPTION	Beschreibung	`description`, `shortDesc`
IMAGE	Bilder	`images.image[]` oder `images.imageURL[]`
VARIANT	Varianten	`productOptions.productOption[]`
PAYMENT	Zahlungsmethoden	`payOptions.option[]`
SHIPPING	Versandmethoden	`shipmethods.shipmethod[]`
ARTIKEL_ATTRIBUTE	Attribute	`productProperties.nameValueList[]`

3. Besondere Verhaltensweisen

3.1 XML-basierte API

Hood verwendet XML-basierte API:
- Auction-Erstellung: auctionInsert (XML)
- Auction-Update: auctionUpdate (XML)
- Authentifizierung: MD5-Hash des Passworts

3.2 Create vs. Update

Wenn marketplaceProductId vorhanden: Update (auctionUpdate)
Wenn marketplaceProductId nicht vorhanden: Create (auctionInsert)
Nach Create: auctionID wird aus Response extrahiert

3.3 Versandmethoden-Mapping

Versandmethoden werden mit Codes versehen:
DHL → DHLPacket_
GLS → GLS_
DPD → DPD_
FedEx → FedEx_
TNT → TNT_
UPS → DHLPacket_
iloxx → iloxx_
Suffixe: nat (Inland), eu (Europa), at (Österreich), ch (Schweiz), int (International)

3.4 Kategorien-Logik

Nicht-custom Kategorien → categoryID
Custom Kategorien → prodCatID

3.5 Bestand-Update

Bestand wird immer überschrieben (nicht als Delta berechnet)
Negative Werte werden auch übertragen

4. Zusammenfassung: Vollständige Feld-Mappings

Produkt-Ebene

Hood Feld	reybex Feld	Export-Gruppe	Hinweise
`itemNumber`	`material.sku`	-	-
`referenceID`	`material.sku`	-	-
`auctionName`	`material.name`	ARTIKEL_DATA	-
`auctionNameSubTitle`	`material.subTitle`	-	-
`ifIsSoldOut`	`material.isOnlySellableWithPositiveStock ? "hide" : "endless"`	-	-
`isApproved`	`material.isMarketplaceActive ? 1 : 0`	-	-
`useSubtitleForAuction`	`material.subTitle ? 1 : 0`	-	-
`auctionID`	`material.marketplaceProductId`	-	Bei Update
`ean`	`material.gtin`	ARTIKEL_DATA	-
`salesTax`	`material.vatRate` oder `0`	ARTIKEL_DATA	-
`weight`	`material.grossWeight` oder `0`	ARTIKEL_DATA	-
`manufacturer`	`material.brand.name`	ARTIKEL_DATA	-
`energyEfficiencyClass`	`material.energyEfficiency.name`	-	-
`fsk`	`material.fsk`	-	-
`usk`	`material.usk`	-	-
`packagingUnit`	`material.packUnit`	BASE_PRICE_CALCULATION	-
`PackagingSize`	`material.volume`	BASE_PRICE_CALCULATION	-
`unit`	`material.basePriceUnit.unit` oder `""`	BASE_PRICE_CALCULATION	-
`quantity`	`material.stock.value`	STOCK	-
`deliveryDaysOnStockFrom`	`material.reorderStockLevel`	STOCK	-
`priceBuyNow`	`material.price.value`	PRICE	-
`listPrice`	`material.price.rrp`	PRICE	-
`purchasePrice`	`material.purchasePrice`	PRICE	-
`categoryID`	`material.categories[0].id` (nicht custom)	CATEGORY	-
`prodCatID`	`material.categories[0].id` (custom)	CATEGORY	-
`description`	`material.detailDescription` oder `description`	DESCRIPTION	-
`shortDesc`	`material.description`	DESCRIPTION	-
`images.image[]` oder `images.imageURL[]`	`material.images.image[]`	IMAGE	-
`productOptions.productOption[]`	`material.variants.items[]`	VARIANT	-
`payOptions.option[]`	`material.paymentMethods[]`	PAYMENT	-
`shipmethods.shipmethod[]`	`material.shipping.*`	SHIPPING	-
`productProperties.nameValueList[]`	`material.attributes[]`	ARTIKEL_ATTRIBUTE	-
`auctionMode`	Immer `"shopProduct"`	-	Bei neuen Artikeln
`condition`	Immer `"new"`	-	Bei neuen Artikeln
`startDate`	Aktuelles Datum	-	Bei neuen Artikeln
`startTime`	Immer `"00:00"`	-	Bei neuen Artikeln
`durationInDays`	`material.listingDays` oder `90`	-	Bei neuen Artikeln
`autoRenew`	Immer `1`	-	Bei neuen Artikeln
`productContactInformation.manufacturer.*`	`material.manufacturer.*`	-	-

5. API-Endpunkte

Auction-Erstellung: auctionInsert (XML)
Auction-Update: auctionUpdate (XML)
Authentifizierung: MD5-Hash des Passworts

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

← Zurück zur Übersicht