Feld-Mapping Dokumentation: reybex → Hepsiburada
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach Hepsiburada übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die Hepsiburada Listing API (XML-Format).
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Hepsiburada 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 Hepsiburada-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 Hepsiburada übertragen werden. Für jedes Hepsiburada-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 Hepsiburada Listing)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Hepsiburada-Produktstruktur
- Listing: Das Hauptprodukt in Hepsiburada
- MerchantSku: Händler-SKU
- HepsiburadaSku: Hepsiburada-interne SKU
1. Produkt-Felder (Listing Level)
Die folgenden Felder werden auf Produktebene in Hepsiburada übertragen:
1.1 Basis-Informationen
| Hepsiburada Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
listing.MerchantSku |
material.sku oder variant.sku |
Händler-SKU | Immer |
listing.HepsiburadaSku |
material.marketplaceProductId oder variant.marketplaceVariantId |
Hepsiburada-SKU | Immer (bei Update) |
listing.ProductName |
material.name oder variant.name |
Produktname | Export-Gruppe: ARTIKEL_DATA |
listing.Price |
material.price.value oder variant.price.value |
Verkaufspreis | Immer |
listing.AvailableStock |
material.stock.value oder variant.stock |
Verfügbarer Bestand | Immer |
listing.DispatchTime |
material.shipping.maxProcessDays |
Versandzeit (in Tagen) | Immer |
listing.MaximumPurchasableQuantity |
material.maxOrderQuantity oder 1000 |
Maximale Bestellmenge | Immer |
Hinweise:
- Price wird mit Komma als Dezimaltrennzeichen formatiert (z.B. "12,50")
- AvailableStock wird auf Integer konvertiert
- MaximumPurchasableQuantity verwendet Standardwert 1000, wenn nicht angegeben
1.2 Varianten
Bei Varianten werden die Felder pro Variante übertragen:
- MerchantSku = variant.sku
- HepsiburadaSku = variant.marketplaceVariantId
- ProductName = variant.name
- Price = variant.price.value
- AvailableStock = variant.stock
2. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Hepsiburada-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | ProductName |
| PRICE | Preis | Price |
| STOCK | Bestand | AvailableStock |
| SHIPPING | Versand | DispatchTime |
3. Besondere Verhaltensweisen
3.1 XML-Format
Hepsiburada verwendet XML-Format für alle API-Requests:
- Produkt-Upload: POST /listings/merchantid/{apiKey}/inventory-uploads (XML Body)
- Format: <listings><listing>...</listing></listings>
3.2 Basic Authentication
Hepsiburada verwendet Basic Authentication:
- Format: Basic {base64(apiKey:secretKey)}
- Header: Authorization: Basic {encoded}
3.3 Pagination
- Materialien werden mit Pagination abgerufen
- Verwendet
getAllMaterialsWithPagination()Methode
3.4 Status-Abfrage
- Upload-Status kann über separate API abgefragt werden
- Endpoint:
GET /listings/merchantid/{apiKey}/inventory-uploads/id/{hepsiburadaId}
3.5 Deaktivierung
- Bei Deaktivierung wird
AvailableStockauf 0 gesetzt - Verwendet
action == STR_ACTION_DISABLE_MATERIALS
4. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| Hepsiburada Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
MerchantSku |
material.sku |
Immer | - |
HepsiburadaSku |
material.marketplaceProductId |
Immer | Nur bei Update |
ProductName |
material.name |
ARTIKEL_DATA | - |
Price |
material.price.value |
PRICE | Komma als Dezimaltrennzeichen |
AvailableStock |
material.stock.value |
STOCK | Als Integer |
DispatchTime |
material.shipping.maxProcessDays |
SHIPPING | - |
MaximumPurchasableQuantity |
material.maxOrderQuantity oder 1000 |
Immer | - |
Varianten-Ebene
| Hepsiburada Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
MerchantSku |
variant.sku |
VARIANT | - |
HepsiburadaSku |
variant.marketplaceVariantId |
VARIANT | Nur bei Update |
ProductName |
variant.name |
VARIANT | - |
Price |
variant.price.value |
VARIANT | Komma als Dezimaltrennzeichen |
AvailableStock |
variant.stock |
VARIANT | Als Integer |
DispatchTime |
material.shipping.maxProcessDays |
VARIANT | - |
MaximumPurchasableQuantity |
material.maxOrderQuantity oder 1000 |
VARIANT | - |
5. API-Endpunkte
- Produkt-Upload:
POST /listings/merchantid/{apiKey}/inventory-uploads(XML) - Status-Abfrage:
GET /listings/merchantid/{apiKey}/inventory-uploads/id/{hepsiburadaId} - Materialien-Liste:
GET /listings/merchantid/{apiKey}(JSON) - Bestand-Report:
GET /listings/merchantid/{apiKey}
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse