Feld-Mapping Dokumentation: reybex → Trendyol
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach Trendyol übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die Trendyol Seller API.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Trendyol 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 Trendyol-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 Trendyol übertragen werden. Für jedes Trendyol-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 Trendyol Product)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Trendyol-Produktstruktur
- Product: Das Hauptprodukt in Trendyol
- Barcode: EAN/GTIN als eindeutige Produktkennung
- Product Main ID: Hauptprodukt-ID (MatCode)
- Stock Code: Varianten-SKU
1. Produkt-Felder (Product Level)
Die folgenden Felder werden auf Produktebene in Trendyol übertragen:
1.1 Basis-Informationen
| Trendyol Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.barcode |
material.gtin oder variant.gtin |
EAN/GTIN (Barcode) | Immer |
product.title |
material.customName oder material.name |
Produktname | Immer |
product.productMainId |
material.matCode |
Hauptprodukt-ID | Immer |
product.stockCode |
material.sku oder variant.sku |
Bestandscode/SKU | Immer |
product.brandId |
material.brand.marketplaceBrandId |
Marken-ID | Immer |
product.categoryId |
material.categories[].id |
Kategorie-ID | Immer |
product.description |
material.detailDescription |
Produktbeschreibung (max 29999 Zeichen) | Immer |
product.vatRate |
material.vatRate |
MwSt.-Satz | Immer |
product.currencyType |
material.price.currency |
Währung | Immer |
product.dimensionalWeight |
material.volume |
Volumengewicht | Immer |
Hinweise:
- barcode ist erforderlich (GTIN)
- description wird auf 29999 Zeichen begrenzt
- Kategorie ist erforderlich
- Marke ist erforderlich
1.2 Preise
| Trendyol Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.salePrice |
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
| Trendyol Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.quantity |
material.stock.value oder variant.stock |
Bestand | Immer |
Hinweise:
- Bei Varianten: variant.stock
- Bei Hauptprodukt: material.stock.value
1.4 Bilder
| Trendyol Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.images[] |
material.images[] oder variant.images[] |
Produktbilder | Immer |
Hinweise:
- Format: [{url: "imageUrl"}]
- Bilder werden über getStaticUrl() generiert
1.5 Attribute
| Trendyol Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.attributes[] |
material.categories.specs und trendyolCategoryAttributes |
Kategorie-Attribute | Immer |
Hinweise:
- Attribute werden aus Kategorie-Spezifikationen extrahiert
- Required und Optional Attributes werden unterschieden
1.6 Versand
| Trendyol Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.cargoCompanyId |
material.shipping.defaultSupportedCarrierName |
Versandunternehmen-ID | Immer |
Versand-Mapping:
- "Kolay Gelsin" → 38
- "Mng" / "DHL eCommerce" → 10
- "Ptt Kargo" → 19
- "Sürat Kargo" → 9
- "Trendyol Express" → 17
- "Yurtici Kargo" → 4
- "Aras" → 7
2. Varianten-Felder
Die folgenden Felder werden auf Variantenebene in Trendyol übertragen:
2.1 Basis-Informationen
| Trendyol Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
variant.barcode |
variant.gtin |
Varianten-EAN/GTIN | Export-Gruppe: VARIANT |
variant.title |
material.customName oder material.name |
Variantenname | Export-Gruppe: VARIANT |
variant.productMainId |
material.matCode |
Hauptprodukt-ID | Export-Gruppe: VARIANT |
variant.stockCode |
variant.sku |
Varianten-SKU | Export-Gruppe: VARIANT |
2.2 Preise
| Trendyol Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
variant.salePrice |
variant.price.value |
Variantenpreis | Export-Gruppe: VARIANT |
variant.listPrice |
Berechnet aus variant.price.rrp und value |
Varianten-UVP | Export-Gruppe: VARIANT |
2.3 Bestand
| Trendyol Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
variant.quantity |
variant.stock |
Variantenbestand | Export-Gruppe: VARIANT |
3. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Trendyol-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | barcode, title, productMainId, stockCode, brandId, categoryId, vatRate, currencyType, dimensionalWeight |
| DESCRIPTION | Beschreibung | description |
| PRICE | Preis | salePrice, listPrice |
| STOCK | Bestand | quantity |
| CATEGORY | Kategorien | categoryId |
| ARTIKEL_ATTRIBUTE | Artikelattribute | attributes[] |
| IMAGE | Bilder | images[] |
| VARIANT | Varianten | Alle Varianten-Felder |
4. Besondere Verhaltensweisen
4.1 Batch-Operationen
Trendyol verwendet Batch-Operationen für Produkt-Updates:
- Neue Produkte: itemsForCreate Array
- Bestehende Produkte: itemsForUpdate Array
- API-Endpoint: /product/sellers/{sellerId}/products
4.2 Separates Stock-Management
- Bestand kann über separate
setStocks()Methode übertragen werden - API-Endpoint:
/inventory/sellers/{sellerId}/products/price-and-inventory
4.3 Marken-Verwaltung
- Marken werden automatisch gesucht, wenn
marketplaceBrandIdnicht vorhanden - API-Endpoint:
/product/brands/by-name?name={brandName}
4.4 Kategorie-Attribute
- Attribute werden aus Kategorie-Spezifikationen extrahiert
- Required und Optional Attributes werden unterschieden
- API-Endpoint:
/product/product-categories/{categoryId}/attributes
4.5 Varianten-Verwaltung
- Varianten werden als separate Produkte übertragen
productMainIdverknüpft Varianten mit Hauptprodukt
5. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| Trendyol Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
barcode |
material.gtin |
ARTIKEL_DATA | Erforderlich |
title |
material.customName oder name |
ARTIKEL_DATA | - |
productMainId |
material.matCode |
ARTIKEL_DATA | - |
stockCode |
material.sku |
ARTIKEL_DATA | - |
brandId |
material.brand.marketplaceBrandId |
ARTIKEL_DATA | Erforderlich |
categoryId |
material.categories[].id |
CATEGORY | Erforderlich |
description |
material.detailDescription |
DESCRIPTION | Max 29999 Zeichen |
salePrice |
material.price.value |
PRICE | - |
listPrice |
Berechnet aus rrp und value |
PRICE | - |
quantity |
material.stock.value |
STOCK | - |
vatRate |
material.vatRate |
ARTIKEL_DATA | - |
currencyType |
material.price.currency |
ARTIKEL_DATA | - |
dimensionalWeight |
material.volume |
ARTIKEL_DATA | - |
cargoCompanyId |
material.shipping.defaultSupportedCarrierName |
ARTIKEL_DATA | - |
attributes[] |
material.categories.specs |
ARTIKEL_ATTRIBUTE | - |
images[] |
material.images[] |
IMAGE | - |
Varianten-Ebene
| Trendyol Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
barcode |
variant.gtin |
VARIANT | Erforderlich |
title |
material.customName oder name |
VARIANT | - |
productMainId |
material.matCode |
VARIANT | - |
stockCode |
variant.sku |
VARIANT | - |
salePrice |
variant.price.value |
VARIANT | - |
listPrice |
Berechnet aus variant.price.rrp und value |
VARIANT | - |
quantity |
variant.stock |
VARIANT | - |
images[] |
variant.images[] |
VARIANT | - |
6. API-Endpunkte
- Produkt-Upload:
POST /product/sellers/{sellerId}/products - Bestand-Update:
POST /inventory/sellers/{sellerId}/products/price-and-inventory - Marken-Suche:
GET /product/brands/by-name?name={brandName} - Kategorie-Attribute:
GET /product/product-categories/{categoryId}/attributes - Batch-Status:
GET /product/sellers/{sellerId}/products/batch-requests/{batchRequestId}
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse