Feld-Mapping Dokumentation: reybex → FTP Client
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex über FTP/SFTP übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über FTP/SFTP als CSV oder XML-Dateien.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und FTP Client 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 FTP Client-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 über FTP/SFTP übertragen werden. Für jedes FTP Client-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
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
FTP Client-Produktstruktur
- CSV/XML-Dateien: Produktdaten werden als CSV oder XML-Dateien übertragen
- FTP/SFTP: Übertragung über FTP oder SFTP
- Client-Typen: Verschiedene Client-Typen (z.B. Galaxus)
1. Produkt-Felder (Datei-Level)
Die folgenden Felder werden in CSV/XML-Dateien übertragen:
1.1 Galaxus Client-Typ (CSV)
| Galaxus Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
ProviderKey |
material.sku |
Provider-Schlüssel | Immer |
Gtin |
material.gtin |
GTIN | Wenn ARTIKEL_DATA |
BrandName |
material.brand.name |
Markenname | Wenn ARTIKEL_DATA |
ProductCategory |
material.reybexCategories[].categoryName (join mit ==>>) |
Produktkategorie | Wenn ARTIKEL_DATA |
Weight_kg |
material.netWeight oder 0.0 |
Gewicht (kg) | Wenn ARTIKEL_DATA |
Length_m |
material.length oder 0.0 |
Länge (m) | Wenn ARTIKEL_DATA |
Width_m |
material.width oder 0.0 |
Breite (m) | Wenn ARTIKEL_DATA |
Height_m |
material.height oder 0.0 |
Höhe (m) | Wenn ARTIKEL_DATA |
ReleaseDate_CH |
material.releaseDate |
Veröffentlichungsdatum | Wenn ARTIKEL_DATA |
ProductTitle_DE |
material.name |
Produkttitel | Wenn ARTIKEL_DATA |
LongDescription_DE |
material.detailDescription (HTML entfernt) |
Lange Beschreibung | Wenn ARTIKEL_DATA |
MainImageURL |
material.images[].image.url (Hauptbild) |
Hauptbild-URL | Wenn IMAGE |
ImageURL_1 bis ImageURL_10 |
material.images[].image.url (Nebenbilder) |
Nebenbild-URLs | Wenn IMAGE |
ProductSuperType |
material.sku |
Produkt-Super-Typ | Immer |
SuggestedRetailPriceInclVat |
material.price.rrp |
UVP inkl. MwSt. | Wenn PRICE |
VatRatePercentage |
material.vatRate |
MwSt.-Satz | Wenn PRICE |
SalesPriceExclVat |
material.price.value (netto oder brutto) |
Verkaufspreis exkl. MwSt. | Wenn PRICE |
Currency |
material.price.currency |
Währung | Wenn PRICE |
QuantityOnStock |
material.stock.value |
Bestand | Wenn STOCK |
MinimumOrderQuantity_dd |
material.salesBatchSize oder 1.0 |
Mindestbestellmenge | Immer |
ingredients |
material.attributes[].value (wenn Name = "Zutaten") |
Zutaten | Wenn vorhanden |
1.2 Galaxus Attribute-Datei (CSV)
| Galaxus Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
ProviderKey |
material.sku |
Provider-Schlüssel | Immer |
SpecificationGroup_DE |
Immer "" |
Spezifikationsgruppe | Immer |
SpecificationKey_DE |
material.attributes[].name |
Spezifikationsschlüssel | Wenn ARTIKEL_ATTRIBUTE |
SpecificationValue_DE |
material.attributes[].value |
Spezifikationswert | Wenn ARTIKEL_ATTRIBUTE |
1.3 Generischer FTP Client (CSV/XML)
Die Felder hängen vom konfigurierten Format ab:
- CSV: Felder werden als CSV-Spalten übertragen
- XML: Felder werden als XML-Elemente übertragen
2. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene FTP Client-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | ProviderKey, Gtin, BrandName, ProductCategory, Weight_kg, Length_m, Width_m, Height_m, ReleaseDate_CH, ProductTitle_DE, LongDescription_DE |
| IMAGE | Bilder | MainImageURL, ImageURL_1 bis ImageURL_10 |
| PRICE | Preis | SuggestedRetailPriceInclVat, VatRatePercentage, SalesPriceExclVat, Currency |
| STOCK | Bestand | QuantityOnStock |
| ARTIKEL_ATTRIBUTE | Attribute | SpecificationKey_DE, SpecificationValue_DE |
| VARIANT | Varianten | Varianten-spezifische Felder (abhängig vom Client-Typ) |
3. Besondere Verhaltensweisen
3.1 FTP/SFTP-Übertragung
FTP Client verwendet FTP oder SFTP:
- FTP: Standard FTP-Protokoll
- SFTP: SSH File Transfer Protocol
- Datei-Upload: Dateien werden auf FTP/SFTP-Server hochgeladen
- Datei-Format: CSV oder XML (abhängig vom Client-Typ)
3.2 Client-Typen
Verschiedene Client-Typen werden unterstützt:
- Galaxus: CSV-basiert, spezifische Feld-Struktur
- Generisch: CSV oder XML, konfigurierbar
3.3 Galaxus-spezifische Logik
- CSV-Dateien:
ProductData_Reybex.csv(Hauptdaten),ProductProperties_Reybex.csv(Attribute) - Datei-Update: Bestehende Dateien werden gelesen und aktualisiert
- Neue Artikel: Werden zur Datei hinzugefügt
- Varianten: Werden als separate Zeilen übertragen
3.4 Bestand-Update
- Wenn nur
STOCKExport-Gruppe: NursetStockswird aufgerufen - Bestand wird immer überschrieben (nicht als Delta berechnet)
- Negative Werte werden auch übertragen
3.5 Preis-Logik
SalesPriceExclVat: Netto-Preis wennsyncNetPriceToMarketplace, sonst brutto- Berechnung:
material.price.value * (100 / (100 + material.vatRate))(netto)
3.6 Bild-Logik
- Hauptbild:
isMain == true - Nebenbilder:
isMain == false - Varianten-Bilder werden ausgeschlossen
3.7 Attribute-Logik
- Attribute werden in separate Datei übertragen (
ProductProperties_Reybex.csv) - "Zutaten" wird als spezielles Feld behandelt (nicht in Attribute-Datei)
4. Zusammenfassung: Vollständige Feld-Mappings
Galaxus CSV-Datei
| Galaxus Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
ProviderKey |
material.sku |
ARTIKEL_DATA | - |
Gtin |
material.gtin |
ARTIKEL_DATA | - |
BrandName |
material.brand.name |
ARTIKEL_DATA | - |
ProductCategory |
material.reybexCategories[].categoryName |
ARTIKEL_DATA | - |
Weight_kg |
material.netWeight oder 0.0 |
ARTIKEL_DATA | - |
Length_m |
material.length oder 0.0 |
ARTIKEL_DATA | - |
Width_m |
material.width oder 0.0 |
ARTIKEL_DATA | - |
Height_m |
material.height oder 0.0 |
ARTIKEL_DATA | - |
ReleaseDate_CH |
material.releaseDate |
ARTIKEL_DATA | - |
ProductTitle_DE |
material.name |
ARTIKEL_DATA | - |
LongDescription_DE |
material.detailDescription |
ARTIKEL_DATA | - |
MainImageURL |
material.images[].image.url (Hauptbild) |
IMAGE | - |
ImageURL_1 bis ImageURL_10 |
material.images[].image.url (Nebenbilder) |
IMAGE | - |
ProductSuperType |
material.sku |
- | - |
SuggestedRetailPriceInclVat |
material.price.rrp |
PRICE | - |
VatRatePercentage |
material.vatRate |
PRICE | - |
SalesPriceExclVat |
material.price.value (netto oder brutto) |
PRICE | - |
Currency |
material.price.currency |
PRICE | - |
QuantityOnStock |
material.stock.value |
STOCK | - |
MinimumOrderQuantity_dd |
material.salesBatchSize oder 1.0 |
- | - |
ingredients |
material.attributes[].value (wenn Name = "Zutaten") |
- | - |
Galaxus Attribute-CSV-Datei
| Galaxus Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
ProviderKey |
material.sku |
ARTIKEL_ATTRIBUTE | - |
SpecificationGroup_DE |
Immer "" |
ARTIKEL_ATTRIBUTE | - |
SpecificationKey_DE |
material.attributes[].name |
ARTIKEL_ATTRIBUTE | - |
SpecificationValue_DE |
material.attributes[].value |
ARTIKEL_ATTRIBUTE | - |
5. API-Endpunkte
- FTP/SFTP-Upload: Datei-Upload auf konfigurierten Pfad
- Datei-Format: CSV oder XML (abhängig vom Client-Typ)
- Authentifizierung: FTP/SFTP-Credentials
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse