Feld-Mapping Dokumentation: reybex → Epttavm
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach Epttavm übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die Epttavm SOAP API.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Epttavm 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 Epttavm-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 Epttavm übertragen werden. Für jedes Epttavm-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 Epttavm Product)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Epttavm-Produktstruktur
- Product: Das Hauptprodukt in Epttavm
- SOAP API:
StokGuncelleV2(SOAP)
1. Produkt-Felder (Product Level)
Die folgenden Felder werden auf Produktebene in Epttavm übertragen:
1.1 Basis-Informationen
| Epttavm Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
item.UrunKodu |
material.sku |
Produktcode | Immer |
item.UrunAdi |
material.name |
Produktname | Immer |
item.Barkod |
material.matCode |
Barcode | Immer |
item.Gtin |
material.gtin |
GTIN/EAN | Immer |
item.Durum |
material.marketplaceProductId ? 'Mevcut' : 'Yeni' |
Status (Neu/Vorhanden) | Immer |
item.Aktif |
Immer true |
Aktiv | Immer |
item.Mevcut |
isProductAvailable |
Verfügbar | Immer |
item.ShopId |
params.authentication.storeId |
Shop-ID | Immer |
1.2 Beschreibung
| Epttavm Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
item.Aciklama |
material.subTitle oder material.description |
Kurzbeschreibung | Immer |
item.UzunAciklama |
material.detailDescription |
Vollständige Beschreibung | Immer |
item.Tag |
material.keyWord |
Tags/Schlagwörter | Immer |
1.3 Preise
| Epttavm Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
item.KDVsiz |
Berechnet aus material.prices[] oder variants[] |
Nettopreis | Immer |
item.KDVli |
Berechnet aus KDVsiz und vatRate |
Bruttopreis | Immer |
item.Iskonto |
Berechnet aus material.prices[].discount |
Rabatt | Wenn vorhanden |
Preislogik:
- KDVsiz (Netto): Wird aus material.prices[].value oder variants[].price.value (Minimum) berechnet
- KDVli (Brutto): Wird aus KDVsiz und vatRate berechnet
- Wenn syncNetPriceToMarketplace = true: KDVli = KDVsiz * (1 + vatRate / 100)
- Sonst: KDVsiz = KDVli / (1 + vatRate / 100)
- Iskonto (Rabatt): Wird aus material.prices[].discount berechnet (negativ)
1.4 Bestand
| Epttavm Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
item.Miktar |
material.stock.value |
Bestand | Immer |
1.5 Steuern
| Epttavm Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
item.KDVOran |
material.vatRate |
MwSt.-Satz | Immer |
1.6 Gewicht und Abmessungen
| Epttavm Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
item.Agirlik |
material.netWeight |
Gewicht | Immer |
item.Desi |
material.volume oder berechnet aus height * length * width / 3000 |
Volumen | Immer |
item.BoyX |
material.height |
Höhe | Wenn volume nicht vorhanden |
item.BoyY |
material.length |
Länge | Wenn volume nicht vorhanden |
item.BoyZ |
material.width |
Breite | Wenn volume nicht vorhanden |
Volumen-Berechnung:
- Wenn volume vorhanden: Desi = volume
- Sonst: Desi = (height * length * width) / 3000
1.7 Bilder
| Epttavm Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
item.UrunResimleri[].UrunResim[].Url |
material.images[].image.filePath und fileName |
Produktbild-URLs | Immer |
item.UrunResimleri[].UrunResim[].Sira |
Index | Bildreihenfolge | Immer |
Bild-URL-Format:
- http://85.215.171.75/files/files/{filePath}/{fileName} (mit URL-Encoding)
1.8 Kategorien
| Epttavm Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
item.YeniKategoriId |
material.categories[].id |
Kategorie-IDs | Immer |
item.KategoriBilgisiGuncelle |
Immer 0 |
Kategorie-Update-Flag | Immer |
item.TedarikciAltKategoriAdi |
Leer | Unterkategorie-Name | Immer |
item.TedarikciAltKategoriId |
Immer 0 |
Unterkategorie-ID | Immer |
item.TedarikciSanalKategoriId |
Immer 0 |
Virtuelle Kategorie-ID | Immer |
1.9 Varianten
| Epttavm Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
item.VariantListesi[].Variant[].VariantBarkod |
variant.sku |
Varianten-Barcode | Immer |
item.VariantListesi[].Variant[].Miktar |
variant.stock |
Varianten-Bestand | Immer |
item.VariantListesi[].Variant[].Durum |
Immer 'Yeni' |
Varianten-Status | Immer |
item.VariantListesi[].Variant[].AnaUrunKodu |
material.matCode |
Hauptproduktcode | Immer |
item.VariantListesi[].Variant[].Attributes[].VariantAttr[].Tanim |
variant.nameValuePairs[].name |
Attribut-Name | Immer |
item.VariantListesi[].Variant[].Attributes[].VariantAttr[].Deger |
variant.nameValuePairs[].value |
Attribut-Wert | Immer |
item.VariantListesi[].Variant[].Attributes[].VariantAttr[].Fiyat |
Berechnet aus variant.price.value und netPrice |
Preis-Differenz | Wenn vorhanden |
item.VariantListesi[].Variant[].Attributes[].VariantAttr[].FiyatFarkiMi |
Berechnet | Preis-Differenz-Flag | Immer |
Varianten-Preislogik:
- Wenn variant.price.value != netPrice: Fiyat = variantPrice - netPrice und FiyatFarkiMi = true
- Sonst: FiyatFarkiMi = false
2. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Epttavm-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | UrunKodu, UrunAdi, Barkod, Gtin, Durum, Aktif, Mevcut, ShopId, Tag |
| DESCRIPTION | Beschreibung | Aciklama, UzunAciklama |
| PRICE | Preis | KDVsiz, KDVli, Iskonto |
| STOCK | Bestand | Miktar |
| TAX | Steuern | KDVOran |
| MESS | Gewicht/Abmessungen | Agirlik, Desi, BoyX, BoyY, BoyZ |
| IMAGE | Bilder | UrunResimleri[] |
| CATEGORY | Kategorien | YeniKategoriId[] |
| VARIANT | Varianten | VariantListesi[] |
3. Besondere Verhaltensweisen
3.1 SOAP API
Epttavm verwendet SOAP API für alle Operationen:
- Material-Update: StokGuncelleV2 (SOAP)
- Authentifizierung: WS-Security (UsernameToken)
3.2 Preis-Berechnung
- Preise werden als Netto oder Brutto übertragen (abhängig von
syncNetPriceToMarketplace) - Varianten-Preise werden als Differenz zum Hauptpreis übertragen
- Rabatte werden negativ übertragen
3.3 Volumen-Berechnung
- Volumen wird als "Desi" übertragen
- Wenn
volumevorhanden: direkt verwendet - Sonst: berechnet aus
height * length * width / 3000
3.4 Bild-URL-Generierung
- Bilder werden als vollständige URLs übertragen
- Format:
http://85.215.171.75/files/files/{filePath}/{fileName} - Leerzeichen werden URL-encoded (
%20)
3.5 Varianten-Verwaltung
- Varianten werden als
VariantListesiübertragen - Jede Variante hat eigene Attribute, Bestand und Preis-Differenz
- Preis-Differenz wird relativ zum Hauptpreis berechnet
4. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| Epttavm Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
UrunKodu |
material.sku |
ARTIKEL_DATA | - |
UrunAdi |
material.name |
ARTIKEL_DATA | - |
Barkod |
material.matCode |
ARTIKEL_DATA | - |
Gtin |
material.gtin |
ARTIKEL_DATA | - |
Durum |
material.marketplaceProductId ? 'Mevcut' : 'Yeni' |
ARTIKEL_DATA | - |
Aktif |
Immer true |
ARTIKEL_DATA | - |
Mevcut |
isProductAvailable |
ARTIKEL_DATA | - |
ShopId |
params.authentication.storeId |
ARTIKEL_DATA | - |
Aciklama |
material.subTitle oder description |
DESCRIPTION | - |
UzunAciklama |
material.detailDescription |
DESCRIPTION | - |
Tag |
material.keyWord |
ARTIKEL_DATA | - |
KDVsiz |
Berechnet | PRICE | - |
KDVli |
Berechnet | PRICE | - |
Iskonto |
material.prices[].discount |
PRICE | Negativ |
Miktar |
material.stock.value |
STOCK | - |
KDVOran |
material.vatRate |
TAX | - |
Agirlik |
material.netWeight |
MESS | - |
Desi |
material.volume oder berechnet |
MESS | - |
BoyX |
material.height |
MESS | - |
BoyY |
material.length |
MESS | - |
BoyZ |
material.width |
MESS | - |
UrunResimleri[] |
material.images[] |
IMAGE | - |
YeniKategoriId[] |
material.categories[].id |
CATEGORY | - |
VariantListesi[] |
material.variants.items[] |
VARIANT | - |
5. API-Endpunkte
- Material-Update:
StokGuncelleV2(SOAP) - Authentifizierung: WS-Security (UsernameToken)
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse