Feld-Mapping Dokumentation: reybex → Ticimax
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach Ticimax übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die Ticimax SOAP API (XML-Format).
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Ticimax 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 Ticimax-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 Ticimax übertragen werden. Für jedes Ticimax-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 Ticimax UrunKarti)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Ticimax-Produktstruktur
- UrunKarti: Das Hauptprodukt in Ticimax
- Varyasyon: Varianten in Ticimax
- Tedarikci: Lieferant/Supplier
1. Produkt-Felder (UrunKarti Level)
Die folgenden Felder werden auf Produktebene in Ticimax übertragen:
1.1 Basis-Informationen
| Ticimax Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
UrunKarti.Aciklama |
material.detailDescription oder material.description |
Produktbeschreibung | Immer |
UrunKarti.Aktif |
material.isMarketplaceActive oder params.isDisableMaterial |
Aktiv-Status ('1'=Aktiv, '0'=Inaktiv) | Immer |
UrunKarti.AnaKategori |
material.categories[].mainCategoryName |
Hauptkategorie-Name | Immer |
UrunKarti.AnaKategoriID |
material.categories[].mainCategoryId |
Hauptkategorie-ID | Immer |
UrunKarti.AramaAnahtarKelime |
material.keyWord |
Such-Schlüsselwörter | Immer |
UrunKarti.ID |
material.marketplaceProductId (geteilt durch '##') |
Produkt-ID | Immer (bei Update) |
UrunKarti.Kategoriler[] |
material.categories[].id |
Kategorien (als IDs) | Immer |
UrunKarti.MarkaID |
material.brand.marketplaceBrandId |
Marken-ID | Immer |
UrunKarti.MarketPlaceAktif |
Immer '1' |
Marktplatz-Aktiv | Immer |
UrunKarti.SatisBirimi |
material.referenceUnit (lowercase) oder 'adet' |
Verkaufseinheit | Immer |
UrunKarti.Sira |
Immer '0' |
Sortierung | Immer |
UrunKarti.TedarikciID |
supplier.id |
Lieferanten-ID | Immer |
UrunKarti.TedarikciKodu |
supplier.code |
Lieferanten-Code | Immer |
UrunKarti.TahminiTeslimSuresi |
material.shipping.maxProcessDays |
Geschätzte Lieferzeit (in Tagen) | Immer |
UrunKarti.UcretsizKargo |
material.isShippingFree |
Versandkostenfrei | Immer |
UrunKarti.UrunAdi |
material.name |
Produktname | Immer |
UrunKarti.UrunSayfaAdresi |
Generiert aus material.name und material.matCode |
Produkt-URL | Immer |
UrunKarti.Vitrin |
Immer true |
Schaufenster | Immer |
UrunKarti.YeniUrun |
Immer true |
Neues Produkt | Immer |
Hinweise:
- UrunSayfaAdresi wird generiert: {name.toLowerCase().replace(" ", "-")}-{matCode}
- ID wird aus marketplaceProductId extrahiert (geteilt durch '##')
1.2 Bilder
| Ticimax Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
UrunKarti.Resimler[] |
material.images[].image[].staticUrl |
Produktbilder | Immer (wenn refreshPictures = true) |
Hinweise:
- Bilder werden nur übertragen, wenn refreshPictures = true gesetzt ist
- Format: [staticUrl1, staticUrl2, ...]
1.3 Varianten (Varyasyonlar)
| Ticimax Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
Varyasyon.Aktif |
material.isMarketplaceActive oder params.isDisableMaterial |
Varianten-Aktiv | Export-Gruppe: VARIANT |
Varyasyon.AlisFiyati |
material.purPrice |
Einkaufspreis | Export-Gruppe: VARIANT |
Varyasyon.ID |
variant.marketplaceVariantId oder material.marketplaceProductId (geteilt) |
Varianten-ID | Export-Gruppe: VARIANT |
Varyasyon.Barkod |
variant.eanCode oder material.gtin |
EAN/GTIN | Export-Gruppe: VARIANT |
Varyasyon.IndirimliFiyati |
variant.price.rrp oder material.price.value (netto) |
UVP/Listenpreis | Export-Gruppe: VARIANT |
Varyasyon.KdvDahil |
material.isGrossPrice |
MwSt. inklusive | Export-Gruppe: VARIANT |
Varyasyon.KdvOrani |
material.vatRate |
MwSt.-Satz | Export-Gruppe: VARIANT |
Varyasyon.Ozellikler[] |
variant.nameValuePairs[] |
Varianten-Eigenschaften | Export-Gruppe: VARIANT |
Varyasyon.ParaBirimi |
material.price.currency |
Währung | Export-Gruppe: VARIANT |
Varyasyon.ParaBirimiID |
currencyId (aus Währung gesucht) |
Währungs-ID | Export-Gruppe: VARIANT |
Varyasyon.Resimler[] |
variant.images[].staticUrl |
Varianten-Bilder | Export-Gruppe: VARIANT |
Varyasyon.SatisFiyati |
variant.price.rrp oder variant.price.value oder material.price.rrp oder material.price.value |
Verkaufspreis | Export-Gruppe: VARIANT |
Varyasyon.StokAdedi |
variant.stock.value oder material.stock.value |
Bestand | Export-Gruppe: VARIANT |
Varyasyon.StokKodu |
variant.sku oder material.matCode |
Bestandscode/SKU | Export-Gruppe: VARIANT |
Hinweise:
- Bei Varianten: Alle Varianten-Felder werden übertragen
- Ohne Varianten: Hauptprodukt wird als Variante übertragen
- IndirimliFiyati = rrp wenn vorhanden, sonst value (netto berechnet)
- SatisFiyati = rrp wenn vorhanden, sonst value
2. Update-Einstellungen (ukAyar)
Die folgenden Einstellungen steuern, welche Felder aktualisiert werden:
| Ticimax Einstellung | Beschreibung | Bedingung |
|---|---|---|
ukAyar.AciklamaGuncelle |
Beschreibung aktualisieren | Export-Gruppe: DESCRIPTION |
ukAyar.AktifGuncelle |
Aktiv-Status aktualisieren | Export-Gruppe: DESCRIPTION |
ukAyar.KategoriGuncelle |
Kategorien aktualisieren | Export-Gruppe: CATEGORY |
ukAyar.MarkaGuncelle |
Marke aktualisieren | Export-Gruppe: ARTIKEL_DATA |
ukAyar.OncekiKategoriEslestirmeleriniTemizle |
Alte Kategorien-Verknüpfungen löschen | Export-Gruppe: CATEGORY |
ukAyar.UrunAdiGuncelle |
Produktname aktualisieren | Export-Gruppe: ARTIKEL_DATA |
ukAyar.UrunAdresiniElleOlustur |
Produkt-URL manuell erstellen | Immer (bei neuer Erstellung) |
ukAyar.UrunResimGuncelle |
Produktbilder aktualisieren | Export-Gruppe: IMAGE + refreshPictures |
ukAyar.OncekiResimleriSil |
Alte Bilder löschen | Immer (wenn refreshPictures = true) |
3. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Ticimax-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | UrunAdi, MarkaID, TedarikciID, TedarikciKodu, SatisBirimi, TahminiTeslimSuresi, UcretsizKargo, UrunSayfaAdresi |
| DESCRIPTION | Beschreibung | Aciklama, Aktif |
| CATEGORY | Kategorien | AnaKategori, AnaKategoriID, Kategoriler[] |
| IMAGE | Bilder | Resimler[] (nur wenn refreshPictures = true) |
| VARIANT | Varianten | Alle Varyasyon-Felder |
| PRICE | Preis | SatisFiyati, IndirimliFiyati, AlisFiyati (in Varianten) |
| STOCK | Bestand | StokAdedi (in Varianten) |
4. Besondere Verhaltensweisen
4.1 SOAP API
Ticimax verwendet SOAP API für alle Operationen:
- Produkt-Upload: SaveUrun (SOAP)
- Bestand-Update: StokAdediGuncelle (SOAP)
4.2 XML-Format
- Alle Produkt-Updates erfolgen über XML-Format
- Verwendet
StreamingMarkupBuilderfür XML-Generierung
4.3 Separates Stock-Management
- Bestand kann über separate
setStocks()Methode übertragen werden - Verwendet
StokAdediGuncelleSOAP-Methode
4.4 Varianten-Verwaltung
- Varianten werden als
Varyasyonübertragen - Ohne Varianten: Hauptprodukt wird als Variante übertragen
- Format:
{Aktif, AlisFiyati, ID, Barkod, IndirimliFiyati, KdvDahil, KdvOrani, Ozellikler[], ParaBirimi, ParaBirimiID, Resimler[], SatisFiyati, StokAdedi, StokKodu}
4.5 Lieferanten-Verwaltung
- Lieferant wird über
getMaterialSupplier()gesucht - Erforderlich:
supplier.idundsupplier.code
4.6 Marken-Verwaltung
- Marke ist erforderlich:
material.brand.nameundmaterial.brand.marketplaceBrandId - Fehlende Marke führt zu Fehler
4.7 Währungs-Verwaltung
- Währungs-ID wird über
getMaterialCurrencyId()gesucht - Verwendet
material.price.currency
4.8 Preislogik
IndirimliFiyati=rrpwenn vorhanden, sonstvalue(netto berechnet)SatisFiyati=rrpwenn vorhanden, sonstvalue- Netto-Berechnung:
value / ((100 + vatRate) / 100)(wennisGrossPrice = false)
5. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| Ticimax Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
Aciklama |
material.detailDescription oder description |
DESCRIPTION | - |
Aktif |
material.isMarketplaceActive oder isDisableMaterial |
Immer | '1' oder '0' |
AnaKategori |
material.categories[].mainCategoryName |
CATEGORY | - |
AnaKategoriID |
material.categories[].mainCategoryId |
CATEGORY | - |
AramaAnahtarKelime |
material.keyWord |
ARTIKEL_DATA | - |
ID |
material.marketplaceProductId (geteilt) |
Immer | Nur bei Update |
Kategoriler[] |
material.categories[].id |
CATEGORY | - |
MarkaID |
material.brand.marketplaceBrandId |
ARTIKEL_DATA | Erforderlich |
MarketPlaceAktif |
Immer '1' |
Immer | - |
SatisBirimi |
material.referenceUnit (lowercase) oder 'adet' |
ARTIKEL_DATA | - |
Sira |
Immer '0' |
Immer | - |
TedarikciID |
supplier.id |
ARTIKEL_DATA | Erforderlich |
TedarikciKodu |
supplier.code |
ARTIKEL_DATA | Erforderlich |
TahminiTeslimSuresi |
material.shipping.maxProcessDays |
ARTIKEL_DATA | - |
UcretsizKargo |
material.isShippingFree |
ARTIKEL_DATA | - |
UrunAdi |
material.name |
ARTIKEL_DATA | - |
UrunSayfaAdresi |
Generiert aus name und matCode |
ARTIKEL_DATA | - |
Vitrin |
Immer true |
Immer | - |
YeniUrun |
Immer true |
Immer | - |
Resimler[] |
material.images[].image[].staticUrl |
IMAGE | Nur wenn refreshPictures = true |
Varianten-Ebene
| Ticimax Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
Aktif |
material.isMarketplaceActive oder isDisableMaterial |
VARIANT | '1' oder '0' |
AlisFiyati |
material.purPrice |
VARIANT | - |
ID |
variant.marketplaceVariantId oder material.marketplaceProductId (geteilt) |
VARIANT | - |
Barkod |
variant.eanCode oder material.gtin |
VARIANT | - |
IndirimliFiyati |
variant.price.rrp oder value (netto) |
VARIANT | - |
KdvDahil |
material.isGrossPrice |
VARIANT | - |
KdvOrani |
material.vatRate |
VARIANT | - |
Ozellikler[] |
variant.nameValuePairs[] |
VARIANT | - |
ParaBirimi |
material.price.currency |
VARIANT | - |
ParaBirimiID |
currencyId (gesucht) |
VARIANT | - |
Resimler[] |
variant.images[].staticUrl |
VARIANT | - |
SatisFiyati |
variant.price.rrp oder value |
VARIANT | - |
StokAdedi |
variant.stock.value oder material.stock.value |
VARIANT | - |
StokKodu |
variant.sku oder material.matCode |
VARIANT | - |
6. API-Endpunkte
- Produkt-Upload:
SaveUrun(SOAP) - Bestand-Update:
StokAdediGuncelle(SOAP)
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse