Feld-Mapping Dokumentation: reybex → eBay
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach eBay übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die eBay Trading API (XML-basiert).
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und eBay 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 eBay-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 eBay übertragen werden. Für jedes eBay-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 eBay Item)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
eBay-Produktstruktur
- Item: Das Hauptprodukt in eBay
- Variation: Produktvarianten in eBay
- XML API: Trading API (XML-basiert)
1. Produkt-Felder (Item Level)
Die folgenden Felder werden auf Produktebene in eBay übertragen:
1.1 Basis-Informationen
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.ItemID |
material.marketplaceProductId |
eBay Item-ID |
Wenn vorhanden |
Item.SKU |
material.sku |
Artikelnummer |
Wenn marketplaceProductId nicht vorhanden |
Item.InventoryTrackingMethod |
ItemID oder SKU |
Tracking-Methode |
Immer |
Item.PayPalEmailAddress |
params.authentication.payPalEmailAddress |
PayPal-E-Mail |
Immer |
Item.Title |
material.name (max. 80 Zeichen) |
Produkttitel |
Immer |
Item.Description |
material.detailDescription |
Produktbeschreibung |
Immer |
Titel-Logik:
- Wenn purchaseUnit > 0 und referenceUnit > 0 und Grundpreis im Namen: Titel enthält Grundpreis-Info
- Sonst: Titel auf 80 Zeichen begrenzt
1.2 Standort
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.Country |
material.location.countryCode |
Land |
Wenn countryCode und city vorhanden |
Item.Location |
material.location.city |
Stadt |
Wenn countryCode und city vorhanden |
Item.PostalCode |
material.location.zipCode |
Postleitzahl |
Wenn countryCode nicht vorhanden |
1.3 Kategorien
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.PrimaryCategory.CategoryID |
material.categories[0].id |
Hauptkategorie |
Wenn vorhanden |
Item.SecondaryCategory.CategoryID |
material.categories[1].id |
Zweitkategorie |
Wenn vorhanden |
1.4 Preise
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.StartPrice |
material.price.value |
Startpreis |
Wenn keine Varianten |
Item.CurrencyID |
material.price.currency |
Währung |
Immer |
1.5 Bestand
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.Quantity |
material.stock.value (min. 0) |
Bestand |
Wenn keine Varianten |
1.6 Steuern
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.VATDetails.VATPercent |
material.vatRate |
MwSt.-Satz |
Wenn vorhanden |
1.7 Zustand
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.ConditionID |
material.conditionId oder automatisch |
Zustand-ID |
Immer |
Zustand-Logik:
- Wenn conditionId vorhanden: direkt verwendet
- Sonst: Automatisch aus Kategorie ermittelt (Standard: "Neu")
1.8 Versand
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.DispatchTimeMax |
params.shipping.maxProcessDays oder 1 |
Max. Bearbeitungszeit (Tage) |
Immer |
Item.ShippingDetails.ShippingType |
Immer Flat |
Versandtyp |
Immer |
Item.ShippingDetails.GlobalShipping |
material.shipping.isGlobal |
Globaler Versand |
Immer |
Item.ShippingDetails.ShippingServiceOptions[] |
material.shipping.carriers[] (scope=0) |
Inland-Versand |
Immer |
Item.ShippingDetails.InternationalShippingServiceOption[] |
material.shipping.carriers[] (scope=1) |
Ausland-Versand |
Wenn isGlobal=true |
Versandkosten-Mapping:
- ShippingService: carrier.name
- ShippingServiceCost: carrier.price.value
- ShippingServiceAdditionalCost: carrier.additional.price.value
- ShippingInsuranceCost: carrier.insurance.price.value
1.9 Zahlungsarten
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.PaymentMethods[] |
material.paymentMethods[] |
Zahlungsarten |
Wenn vorhanden |
Item.PaymentMethods |
Immer COD |
Standard-Zahlungsart |
Wenn keine Zahlungsarten |
1.10 Bilder
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.PictureDetails.PictureURL[] |
material.images[].image.url |
Produktbild-URLs |
Wenn refreshPictures=true |
Bild-Logik:
- Hauptbild zuerst, dann Galerie-Bilder
- Wenn kein Hauptbild: erstes Bild als Hauptbild
1.11 Produktdetails
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.ProductListingDetails.EAN |
material.gtin |
EAN/GTIN |
Wenn vorhanden und keine Varianten |
1.12 Verpackungsdetails
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.ShippingPackageDetails.PackageDepth |
material.height |
Höhe |
Wenn vorhanden |
Item.ShippingPackageDetails.PackageLength |
material.length |
Länge |
Wenn vorhanden |
Item.ShippingPackageDetails.PackageWidth |
material.width |
Breite |
Wenn vorhanden |
1.13 Herstellerdetails
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.Regulatory.Manufacturer.* |
material.manufacturer.* |
Hersteller-Informationen |
Wenn vorhanden |
1.14 Artikelmerkmale (ItemSpecifics)
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.ItemSpecifics.NameValueList[].Name |
Marke oder MPN oder Grundpreis oder categories[].specs[].name |
Attribut-Name |
Wenn vorhanden |
Item.ItemSpecifics.NameValueList[].Value |
material.brand.name oder material.manufacturer.number oder berechnet oder specs[].value |
Attribut-Wert |
Wenn vorhanden |
Artikelmerkmale-Logik:
- Marke: material.brand.name (wenn nicht in Specs)
- MPN: material.manufacturer.number (wenn nicht in Specs)
- Grundpreis: Berechnet aus purchaseUnit, referenceUnit, price
- Specs: Aus categories[].specs[] (ohne Varianten-Attribute)
1.15 Business Policies
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.SellerProfiles.SellerPaymentProfile.PaymentProfileID |
material.shipping.policyProfile.paymentPolicyId |
Zahlungsprofil-ID |
Wenn isPolicyUsed=true |
Item.SellerProfiles.SellerReturnProfile.ReturnProfileID |
material.shipping.policyProfile.returnPolicyId |
Rückgabeprofil-ID |
Wenn isPolicyUsed=true |
Item.SellerProfiles.SellerShippingProfile.ShippingProfileID |
material.shipping.policyProfile.shippingPolicyId |
Versandprofil-ID |
Wenn isPolicyUsed=true |
1.16 Listing-Dauer
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.ListingDuration |
material.listingDays oder GTC |
Listing-Dauer |
Immer |
Listing-Dauer-Logik:
- Wenn listingDays in ["1", "3", "5", "7", "10", "14", "21", "30", "60", "90", "120"]: entsprechend
- Sonst: GTC (Good Till Canceled)
2. Varianten-Felder (Variations Level)
Die folgenden Felder werden auf Variantenebene in eBay übertragen:
2.1 Varianten-Definition
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.Variations.VariationSpecificsSet.NameValueList[].Name |
material.variants.items[0].nameValuePairs[].name |
Varianten-Attribut-Name |
Immer |
Item.Variations.VariationSpecificsSet.NameValueList[].Value[] |
Eindeutige Werte pro Attribut |
Varianten-Attribut-Werte |
Immer |
2.2 Einzelne Varianten
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.Variations.Variation[].SKU |
variant.sku |
Varianten-SKU |
Immer (erforderlich) |
Item.Variations.Variation[].Quantity |
variant.stock (min. 0) |
Varianten-Bestand |
Immer |
Item.Variations.Variation[].StartPrice |
variant.price.value |
Varianten-Preis |
Immer |
Item.Variations.Variation[].VariationProductListingDetails.EAN |
variant.gtin oder "Nicht zutreffend" |
Varianten-EAN |
Immer |
Item.Variations.Variation[].VariationSpecifics.NameValueList[].Name |
variant.nameValuePairs[].name |
Varianten-Attribut-Name |
Immer |
Item.Variations.Variation[].VariationSpecifics.NameValueList[].Value |
variant.nameValuePairs[].value |
Varianten-Attribut-Wert |
Immer |
2.3 Varianten-Bilder
| eBay Feld |
reybex Feld |
Beschreibung |
Bedingung |
Item.Variations.Pictures.VariationSpecificName |
material.variants.identifyingAttribute oder erstes Attribut |
Identifizierendes Attribut |
Wenn refreshPictures=true |
Item.Variations.Pictures.VariationSpecificPictureSet[].VariationSpecificValue |
Attribut-Wert |
Attribut-Wert |
Wenn refreshPictures=true |
Item.Variations.Pictures.VariationSpecificPictureSet[].PictureURL[] |
variant.images[].url |
Varianten-Bilder |
Wenn refreshPictures=true |
3. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe |
Beschreibung |
Übertragene eBay-Felder |
| ARTIKEL_DATA |
Artikeldaten |
ItemID, SKU, Title, Description, Country, Location, PostalCode, PayPalEmailAddress |
| DESCRIPTION |
Beschreibung |
Title, Description |
| PRICE |
Preis |
StartPrice, CurrencyID |
| STOCK |
Bestand |
Quantity |
| TAX |
Steuern |
VATDetails.VATPercent |
| SHIPPING |
Versand |
DispatchTimeMax, ShippingDetails.* |
| IMAGE |
Bilder |
PictureDetails.PictureURL[] |
| CATEGORY |
Kategorien |
PrimaryCategory, SecondaryCategory |
| VARIANT |
Varianten |
Variations.* |
| ARTIKEL_ATTRIBUTE |
Artikelattribute |
ItemSpecifics.* |
4. Besondere Verhaltensweisen
4.1 XML-basierte API
eBay verwendet XML-basierte Trading API:
- Material-Update: ReviseFixedPriceItem (XML)
- Material-Erstellung: AddFixedPriceItem (XML)
- Authentifizierung: eBay Token (IAF Token)
4.2 Revise vs. Add
- Wenn
marketplaceProductId vorhanden: ReviseFixedPriceItem
- Wenn
marketplaceProductId nicht vorhanden: AddFixedPriceItem
- Wenn Revise fehlschlägt (Fehler 21916270): Automatischer Wechsel zu Add
4.3 Varianten-Anforderungen
- Alle Varianten müssen eine SKU haben - Wenn eine Variante keine SKU hat, wird das gesamte Material übersprungen
- Varianten-SKUs sind erforderlich für Bestands-Updates
4.4 Grundpreis-Berechnung
- Grundpreis wird berechnet:
(price.value / purchaseUnit) * referenceUnit
- Format:
"(X.XX EUR / Y Z)"
- Wird in Titel eingefügt, wenn möglich
4.5 Business Policies
- Wenn
isPolicyUsed=true: Business Policies werden verwendet
- Wenn
isPolicyUsed=false: Versanddetails werden direkt übertragen
- Policies werden automatisch geladen, wenn nicht vorhanden
4.6 Zustand (Condition)
- Wenn
conditionId vorhanden: direkt verwendet
- Sonst: Automatisch aus Kategorie ermittelt (GetCategoryFeatures)
- Standard: "Neu" (New)
4.7 Varianten-Bilder
- Bilder werden pro Varianten-Attribut-Wert zugeordnet
- Identifizierendes Attribut:
identifyingAttribute oder erstes Attribut
- Format:
Pictures.VariationSpecificPictureSet[]
4.8 Fehlerbehandlung
- Fehler werden aus XML-Response extrahiert
- Fehler-Code 21916270: Item existiert nicht → Wechsel zu Add
- Andere Fehler: Werden gemeldet
5. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| eBay Feld |
reybex Feld |
Export-Gruppe |
Hinweise |
ItemID |
material.marketplaceProductId |
ARTIKEL_DATA |
- |
SKU |
material.sku |
ARTIKEL_DATA |
- |
Title |
material.name (max. 80) |
DESCRIPTION |
- |
Description |
material.detailDescription |
DESCRIPTION |
- |
Country |
material.location.countryCode |
ARTIKEL_DATA |
- |
Location |
material.location.city |
ARTIKEL_DATA |
- |
PostalCode |
material.location.zipCode |
ARTIKEL_DATA |
- |
PayPalEmailAddress |
params.authentication.payPalEmailAddress |
ARTIKEL_DATA |
- |
PrimaryCategory.CategoryID |
material.categories[0].id |
CATEGORY |
- |
SecondaryCategory.CategoryID |
material.categories[1].id |
CATEGORY |
- |
StartPrice |
material.price.value |
PRICE |
Nur ohne Varianten |
CurrencyID |
material.price.currency |
PRICE |
- |
Quantity |
material.stock.value (min. 0) |
STOCK |
Nur ohne Varianten |
VATDetails.VATPercent |
material.vatRate |
TAX |
- |
ConditionID |
material.conditionId oder automatisch |
ARTIKEL_DATA |
- |
DispatchTimeMax |
params.shipping.maxProcessDays oder 1 |
SHIPPING |
- |
ShippingDetails.* |
material.shipping.* |
SHIPPING |
- |
PaymentMethods[] |
material.paymentMethods[] oder COD |
ARTIKEL_DATA |
- |
PictureDetails.PictureURL[] |
material.images[].image.url |
IMAGE |
- |
ProductListingDetails.EAN |
material.gtin |
ARTIKEL_DATA |
Nur ohne Varianten |
ShippingPackageDetails.* |
material.height/length/width |
SHIPPING |
- |
Regulatory.Manufacturer.* |
material.manufacturer.* |
ARTIKEL_DATA |
- |
ItemSpecifics.* |
material.brand.name, manufacturer.number, categories[].specs[] |
ARTIKEL_ATTRIBUTE |
- |
SellerProfiles.* |
material.shipping.policyProfile.* |
SHIPPING |
- |
ListingDuration |
material.listingDays oder GTC |
ARTIKEL_DATA |
- |
Varianten-Ebene
| eBay Feld |
reybex Feld |
Export-Gruppe |
Hinweise |
Variations.VariationSpecificsSet.* |
material.variants.items[].nameValuePairs[] |
VARIANT |
- |
Variations.Variation[].SKU |
variant.sku |
VARIANT |
Erforderlich |
Variations.Variation[].Quantity |
variant.stock (min. 0) |
VARIANT |
- |
Variations.Variation[].StartPrice |
variant.price.value |
VARIANT |
- |
Variations.Variation[].VariationProductListingDetails.EAN |
variant.gtin oder "Nicht zutreffend" |
VARIANT |
- |
Variations.Variation[].VariationSpecifics.* |
variant.nameValuePairs[] |
VARIANT |
- |
Variations.Pictures.* |
variant.images[] |
VARIANT |
- |
6. API-Endpunkte
- Material-Update:
ReviseFixedPriceItem (XML)
- Material-Erstellung:
AddFixedPriceItem (XML)
- Bestands-Update:
ReviseInventoryStatus (XML)
- Authentifizierung: eBay Token (IAF Token)
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse