Feld-Mapping Dokumentation: reybex → N11
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach N11 übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die N11 SOAP API und REST API.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und N11 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 N11-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 N11 übertragen werden. Für jedes N11-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 N11 Product)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
N11-Produktstruktur
- Product: Das Hauptprodukt in N11
- SellerCode: Händler-SKU
- StockCode: Bestandscode/SKU
1. Produkt-Felder (Product Level)
Die folgenden Felder werden auf Produktebene in N11 übertragen:
1.1 Basis-Informationen
| N11 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.stockCode |
material.sku |
Bestandscode/SKU | Immer |
product.preparingDay |
material.shipping.maxProcessDays |
Vorbereitungstage | Immer |
product.shipmentTemplate |
material.shipping.defaultCarrierName |
Versandvorlage | Immer |
product.description |
material.detailDescription |
Produktbeschreibung | Immer |
Hinweise:
- shipmentTemplate kann auch aus authentication.profileShipping extrahiert werden
1.2 Varianten
Bei Varianten werden die Felder pro Variante übertragen:
- stockCode = variant.sku
- preparingDay = material.shipping.maxProcessDays
- shipmentTemplate = material.shipping.defaultCarrierName
2. Bestand und Preise
Bestand und Preise werden über separate API übertragen:
2.1 Bestand
| N11 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
sku.quantity |
material.stock.value oder variant.stock |
Bestand | Immer |
sku.currencyType |
material.price.currency |
Währungstyp ("TL", "USD", "EUR") | Immer |
sku.salePrice |
material.price.value oder variant.price.value |
Verkaufspreis | Immer |
sku.listPrice |
material.price.rrp oder variant.price.rrp oder value |
Listenpreis/UVP | Immer |
Währungs-Mapping:
- TRY → "TL"
- USD → "USD"
- EUR → "EUR"
- Sonst → "TL"
3. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene N11-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | stockCode, preparingDay, shipmentTemplate |
| DESCRIPTION | Beschreibung | description |
| PRICE | Preis | salePrice, listPrice (über separate API) |
| STOCK | Bestand | quantity (über separate API) |
| SHIPPING | Versand | preparingDay, shipmentTemplate |
| VARIANT | Varianten | Alle Varianten-Felder |
4. Besondere Verhaltensweisen
4.1 SOAP und REST API
N11 verwendet sowohl SOAP als auch REST API:
- Produkt-Updates: REST API (POST /product/tasks/product-update)
- Bestand/Preis-Updates: REST API (POST /product/tasks/price-stock-update)
4.2 Separates Stock/Price-Management
- Bestand und Preise werden über separate API übertragen
- Verwendet
updateStockAndPrice()Methode - Endpoint:
POST /product/tasks/price-stock-update - Format:
{payload: {integrator: "Reybex", skus: [{stockCode, quantity, salePrice, listPrice, currencyType}]}}
4.3 Produkt-Update-Task
- Produkt-Updates erfolgen über Task-System
- Endpoint:
POST /product/tasks/product-update - Format:
{payload: {integrator: "Reybex", skus: [{stockCode, preparingDay, shipmentTemplate, description}]}} - Status:
IN_QUEUEbedeutet Erfolg
4.4 Varianten-Verwaltung
- Varianten werden als separate SKUs übertragen
- Jede Variante hat eigenen
stockCode,quantity,salePrice,listPrice
4.5 Preislogik
listPrice=rrpwenn vorhanden, sonstvaluesalePrice=value
5. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| N11 Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
stockCode |
material.sku |
ARTIKEL_DATA | - |
preparingDay |
material.shipping.maxProcessDays |
SHIPPING | - |
shipmentTemplate |
material.shipping.defaultCarrierName |
SHIPPING | - |
description |
material.detailDescription |
DESCRIPTION | - |
quantity |
material.stock.value |
STOCK | Über separate API |
currencyType |
material.price.currency |
PRICE | "TL", "USD", "EUR" |
salePrice |
material.price.value |
PRICE | Über separate API |
listPrice |
material.price.rrp oder value |
PRICE | Über separate API |
Varianten-Ebene
| N11 Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
stockCode |
variant.sku |
VARIANT | - |
preparingDay |
material.shipping.maxProcessDays |
VARIANT | - |
shipmentTemplate |
material.shipping.defaultCarrierName |
VARIANT | - |
quantity |
variant.stock |
VARIANT | Über separate API |
currencyType |
material.price.currency |
VARIANT | "TL", "USD", "EUR" |
salePrice |
variant.price.value |
VARIANT | Über separate API |
listPrice |
variant.price.rrp oder value |
VARIANT | Über separate API |
6. API-Endpunkte
- Produkt-Update:
POST /product/tasks/product-update(REST) - Bestand/Preis-Update:
POST /product/tasks/price-stock-update(REST) - Produkt-Abfrage:
GET /ProductService(SOAP)
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse