Feld-Mapping Dokumentation: reybex → Magento 1
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach Magento 1 übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die Magento 1 SOAP API.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Magento 1 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 Magento 1-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 Magento 1 übertragen werden. Für jedes Magento 1-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 Magento 1 Product)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Magento 1-Produktstruktur
- Product: Das Hauptprodukt in Magento 1
- Product Type: "simple" für einfache Produkte
- Attribute Set: Attributsatz (Standard: 4)
1. Produkt-Felder (Product Level)
Die folgenden Felder werden auf Produktebene in Magento 1 übertragen:
1.1 Basis-Informationen
| Magento 1 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
sku |
material.sku oder material.marketplaceProductId |
Artikelnummer | Immer |
name |
material.name |
Produktname | Export-Gruppe: ARTIKEL_DATA |
status |
material.isMarketplaceActive |
Status (1=Aktiv, 2=Inaktiv) | Immer |
visibility |
material.materialMarktplaceVisibility.id |
Sichtbarkeit | Export-Gruppe: ARTIKEL_DATA |
ean |
material.gtin |
EAN/GTIN | Export-Gruppe: ARTIKEL_DATA |
amazon_ean |
material.asin |
Amazon EAN/ASIN | Export-Gruppe: ARTIKEL_DATA |
pzn |
material.pzn |
PZN | Export-Gruppe: ARTIKEL_DATA |
inhaltsstoffetext |
material.content |
Inhaltsstofftext | Export-Gruppe: ARTIKEL_DATA |
weight |
material.grossWeight |
Gewicht | Export-Gruppe: ARTIKEL_DATA |
manufacturer |
material.manufacturer.number |
Hersteller (als ID) | Export-Gruppe: ARTIKEL_DATA |
country_of_manufacture |
material.manufacturerCountry |
Herstellungsland | Export-Gruppe: ARTIKEL_DATA |
tax_class_id |
material.tax_class_id |
Steuerklasse | Export-Gruppe: ARTIKEL_DATA |
website_ids |
params.authentication.storeId |
Website-IDs | Export-Gruppe: ARTIKEL_DATA (wenn storeId vorhanden) |
Hinweise:
- status = "1" wenn isMarketplaceActive = true, sonst "2"
- manufacturer wird als Hersteller-ID übertragen
1.2 Grundpreis-Berechnung
| Magento 1 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
base_price_amount |
material.purchaseUnit |
Grundpreis-Menge | Export-Gruppe: BASE_PRICE_CALCULATION |
base_price_unit |
material.basePriceUnit.unit |
Grundpreis-Einheit | Export-Gruppe: BASE_PRICE_CALCULATION |
base_price_base_amount |
material.referenceUnit |
Referenz-Menge | Export-Gruppe: BASE_PRICE_CALCULATION |
base_price_base_unit |
material.basePriceUnit.unit |
Referenz-Einheit | Export-Gruppe: BASE_PRICE_CALCULATION |
Einheiten-Mapping:
- AD → PCS
- KG → KG
- GR → G
- M → M
- CM → CM
1.3 Beschreibung
| Magento 1 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
short_description |
material.description |
Kurzbeschreibung | Export-Gruppe: DESCRIPTION |
description |
material.detailDescription |
Vollständige Beschreibung | Export-Gruppe: DESCRIPTION |
at_beschreibung |
material.detailDescription |
AT-Beschreibung | Export-Gruppe: DESCRIPTION |
1.4 SEO-Felder
| Magento 1 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
url_key |
material.translations[].urlkey |
URL-Schlüssel | Export-Gruppe: SEO |
meta_title |
material.translations[].metaTitle |
SEO-Titel | Export-Gruppe: SEO |
meta_keyword |
material.translations[].keyWord |
SEO-Schlüsselwörter | Export-Gruppe: SEO |
meta_description |
material.translations[].metaDescription |
SEO-Beschreibung | Export-Gruppe: SEO |
Hinweise:
- SEO-Felder werden aus Übersetzungen extrahiert (basierend auf storeLanguage)
1.5 Preise
| Magento 1 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
price |
material.price.value |
Verkaufspreis | Export-Gruppe: PRICE |
1.6 Bestand
| Magento 1 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
stock_data.qty |
material.stock.value |
Bestand | Export-Gruppe: STOCK |
stock_data.is_in_stock |
material.stock.value > 0 |
Auf Lager (1=Ja, 0=Nein) | Export-Gruppe: STOCK |
stock_data.notify_stock_qty |
material.reorderStockLevel |
Nachbestellgrenze | Export-Gruppe: STOCK (wenn vorhanden) |
stock_data.min_sale_qty |
material.minOrderQuantity |
Mindestbestellmenge | Export-Gruppe: STOCK (wenn vorhanden) |
Hinweise:
- qty wird auf 0 gesetzt, wenn stock.value <= 0
- is_in_stock = 1 wenn stock.value > 0, sonst 0
1.7 Kategorien
| Magento 1 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
category_ids |
material.categories[].id |
Kategorien (als IDs) | Export-Gruppe: CATEGORY |
Hinweise:
- Format: Array von Kategorie-IDs
1.8 Bilder
| Magento 1 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
images[] |
material.images[] |
Produktbilder | Export-Gruppe: IMAGE + refreshPictures = true |
Hinweise:
- Bilder werden nur übertragen, wenn refreshPictures = true gesetzt ist
- Verwendet createImages() Methode über SOAP API
2. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Magento 1-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | name, visibility, ean, amazon_ean, pzn, inhaltsstoffetext, weight, manufacturer, country_of_manufacture, tax_class_id, website_ids |
| BASE_PRICE_CALCULATION | Grundpreis-Berechnung | base_price_amount, base_price_unit, base_price_base_amount, base_price_base_unit |
| DESCRIPTION | Beschreibung | short_description, description, at_beschreibung |
| SEO | SEO-Felder | url_key, meta_title, meta_keyword, meta_description |
| PRICE | Preis | price |
| STOCK | Bestand | stock_data.* |
| CATEGORY | Kategorien | category_ids |
| IMAGE | Bilder | images[] (nur wenn refreshPictures = true) |
3. Besondere Verhaltensweisen
3.1 SOAP API
Magento 1 verwendet SOAP API für alle Operationen:
- Produkt-Erstellung: catalog_product.create
- Produkt-Update: catalog_product.update
- Bild-Upload: catalog_product_attribute_media.create
3.2 Produkt-Typ
- Standard-Produkttyp:
"simple" - Attribute Set:
"4"(Standard)
3.3 Store View
- Alle Felder werden für einen spezifischen Store View übertragen (
storeId) - SEO-Felder werden aus Übersetzungen extrahiert (basierend auf
storeLanguage)
3.4 Fehlerbehandlung
- Wenn Produkt nicht existiert, wird automatisch versucht, es zu erstellen
- Fehler werden in
response.messagesgesammelt
4. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| Magento 1 Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
sku |
material.sku oder marketplaceProductId |
Immer | - |
name |
material.name |
ARTIKEL_DATA | - |
status |
material.isMarketplaceActive |
Immer | "1" oder "2" |
visibility |
material.materialMarktplaceVisibility.id |
ARTIKEL_DATA | - |
ean |
material.gtin |
ARTIKEL_DATA | - |
amazon_ean |
material.asin |
ARTIKEL_DATA | - |
pzn |
material.pzn |
ARTIKEL_DATA | - |
inhaltsstoffetext |
material.content |
ARTIKEL_DATA | - |
weight |
material.grossWeight |
ARTIKEL_DATA | - |
manufacturer |
material.manufacturer.number |
ARTIKEL_DATA | Als ID |
country_of_manufacture |
material.manufacturerCountry |
ARTIKEL_DATA | - |
tax_class_id |
material.tax_class_id |
ARTIKEL_DATA | - |
website_ids |
params.authentication.storeId |
ARTIKEL_DATA | - |
base_price_amount |
material.purchaseUnit |
BASE_PRICE_CALCULATION | - |
base_price_unit |
material.basePriceUnit.unit |
BASE_PRICE_CALCULATION | - |
base_price_base_amount |
material.referenceUnit |
BASE_PRICE_CALCULATION | - |
base_price_base_unit |
material.basePriceUnit.unit |
BASE_PRICE_CALCULATION | - |
short_description |
material.description |
DESCRIPTION | - |
description |
material.detailDescription |
DESCRIPTION | - |
at_beschreibung |
material.detailDescription |
DESCRIPTION | - |
url_key |
material.translations[].urlkey |
SEO | - |
meta_title |
material.translations[].metaTitle |
SEO | - |
meta_keyword |
material.translations[].keyWord |
SEO | - |
meta_description |
material.translations[].metaDescription |
SEO | - |
price |
material.price.value |
PRICE | - |
stock_data.qty |
material.stock.value |
STOCK | - |
stock_data.is_in_stock |
material.stock.value > 0 |
STOCK | 1 oder 0 |
stock_data.notify_stock_qty |
material.reorderStockLevel |
STOCK | - |
stock_data.min_sale_qty |
material.minOrderQuantity |
STOCK | - |
category_ids |
material.categories[].id |
CATEGORY | - |
images[] |
material.images[] |
IMAGE | Nur wenn refreshPictures = true |
5. API-Endpunkte
- SOAP API: Magento 1 SOAP API v2
- Produkt-Erstellung:
catalog_product.create - Produkt-Update:
catalog_product.update - Bild-Upload:
catalog_product_attribute_media.create
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse