Feld-Mapping Dokumentation: reybex → PrestaShop 8
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach PrestaShop 8 übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die PrestaShop 8 REST API (XML-Format).
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und PrestaShop 8 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 PrestaShop 8-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 PrestaShop 8 übertragen werden. Für jedes PrestaShop 8-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 PrestaShop 8 Product)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
PrestaShop 8-Produktstruktur
- Product: Das Hauptprodukt in PrestaShop 8
- Product Features: Produkteigenschaften in PrestaShop 8
- Associations: Verknüpfungen (Kategorien, Hersteller, etc.)
1. Produkt-Felder (Product Level)
Die folgenden Felder werden auf Produktebene in PrestaShop 8 übertragen:
1.1 Basis-Informationen
| PrestaShop 8 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.reference |
material.sku |
Artikelnummer | Immer |
product.weight |
material.grossWeight |
Gewicht | Immer |
product.width |
material.width |
Breite | Immer |
product.depth |
material.depth |
Tiefe | Immer |
product.height |
material.height |
Höhe | Immer |
product.active |
material.isMarketplaceActive |
Aktiv-Status (1=Aktiv, 0=Inaktiv) | Immer |
product.ean13 |
material.gtin |
EAN/GTIN | Immer (wenn vorhanden) |
product.id_category_default |
material.prestashopAssociations.categories[0].id |
Standard-Kategorie | Immer |
product.id_manufacturer |
material.prestashopManufacturerId |
Hersteller-ID | Immer |
product.id_tax_rules_group |
material.prestashopTaxRulesGroupId |
Steuergruppen-ID | Immer |
1.2 Preise
| PrestaShop 8 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.price |
material.price.rrp oder material.price.value |
Verkaufspreis (netto) | Immer |
product.wholesale_price |
material.purPrice |
Einkaufspreis | Immer |
product.unit_price_ratio |
material.purchaseUnit |
Grundpreis-Verhältnis | Immer |
product.unity |
material.packUnit |
Einheit | Immer |
Preislogik:
- price = rrp (netto berechnet) wenn vorhanden, sonst value
- Netto-Berechnung: (rrp * 100) / (vatRate + 100)
1.3 Bestand
| PrestaShop 8 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.low_stock_threshold |
material.reorderStockLevel |
Nachbestellgrenze | Immer |
product.low_stock_alert |
Immer 0 |
Nachbestellwarnung | Immer |
1.4 Beschreibung (mehrsprachig)
| PrestaShop 8 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.name[] |
material.name oder material.translations[].name |
Produktname (pro Sprache) | Immer |
product.description[] |
material.detailDescription oder material.translations[].detailDescription |
Vollständige Beschreibung (pro Sprache) | Immer |
product.description_short[] |
material.description oder material.translations[].description |
Kurzbeschreibung (pro Sprache) | Immer |
Hinweise:
- Alle Beschreibungsfelder sind mehrsprachig
- Format: [{id: languageId, value: "Text"}]
- Übersetzungen werden basierend auf languageCode verwendet
1.5 SEO-Felder (mehrsprachig)
| PrestaShop 8 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.meta_title[] |
material.metaTitle oder material.translations[].metaTitle |
SEO-Titel (pro Sprache) | Immer |
product.meta_description[] |
material.metaDescription oder material.translations[].metaDescription |
SEO-Beschreibung (pro Sprache) | Immer |
product.meta_keywords[] |
material.keyWord oder material.translations[].keyWord |
SEO-Schlüsselwörter (pro Sprache) | Immer |
product.link_rewrite[] |
Generiert aus material.name |
URL-Schlüssel (pro Sprache) | Immer |
Hinweise:
- meta_description wird auf 250 Zeichen begrenzt
- link_rewrite wird aus name normalisiert generiert
- Alle SEO-Felder sind mehrsprachig
1.6 Einstellungen
| PrestaShop 8 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.show_price |
Immer 1 |
Preis anzeigen | Immer |
product.state |
Immer 1 |
Status | Immer |
product.available_for_order |
Immer 1 |
Bestellbar | Immer |
product.redirect_type |
Immer 404 |
Weiterleitungstyp | Immer |
product.id_default_image |
Automatisch | Standard-Bild-ID | Immer (nach Bild-Upload) |
1.7 Verknüpfungen (Associations)
| PrestaShop 8 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.associations.categories[] |
material.prestashopAssociations.categories[] |
Kategorien | Immer |
product.associations.manufacturers[] |
material.prestashopAssociations.manufacturers[] |
Hersteller | Immer |
product.associations.features[] |
Generiert aus material.propertyValues[] |
Produkteigenschaften | Immer |
Hinweise:
- Features werden automatisch erstellt, wenn sie nicht existieren
- Feature-Werte werden automatisch erstellt, wenn sie nicht existieren
1.8 Produkteigenschaften (Features)
| PrestaShop 8 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.associations.features[].id |
material.propertyValues[].option.name |
Feature-ID | Immer |
product.associations.features[].id_feature_value |
material.propertyValues[].value |
Feature-Wert-ID | Immer |
Hinweise:
- Features werden über getProductFeatures() generiert
- Features und Feature-Werte werden automatisch erstellt, wenn sie nicht existieren
- Format: [{id: featureId, id_feature_value: valueId}]
1.9 Bilder
| PrestaShop 8 Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
product.images[] |
material.images[] |
Produktbilder | Immer (wenn refreshPictures = true) |
Hinweise:
- Bilder werden nur übertragen, wenn refreshPictures = true gesetzt ist
- Alte Bilder werden vor dem Upload gelöscht (deleteImages())
- Verwendet uploadProductImage() Methode mit fileName und filePath
- Format: [{id: imageId}]
- Hauptbild wird als id_default_image gesetzt
2. Varianten-Felder
PrestaShop 8 unterstützt Varianten über Combinations. Die Varianten-Felder werden über postVariant() übertragen.
3. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene PrestaShop 8-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | reference, weight, width, depth, height, active, ean13, id_category_default, id_manufacturer, id_tax_rules_group |
| DESCRIPTION | Beschreibung | name[], description[], description_short[] |
| SEO | SEO-Felder | meta_title[], meta_description[], meta_keywords[], link_rewrite[] |
| PRICE | Preis | price, wholesale_price, unit_price_ratio, unity |
| STOCK | Bestand | low_stock_threshold, low_stock_alert |
| CATEGORY | Kategorien | associations.categories[] |
| ARTIKEL_ATTRIBUTE | Artikelattribute | associations.features[] |
| IMAGE | Bilder | images[] (nur wenn refreshPictures = true) |
4. Besondere Verhaltensweisen
4.1 XML-Format
PrestaShop 8 verwendet XML-Format für alle API-Requests:
- Produkt-Erstellung: POST /api/products/ (XML Body)
- Produkt-Update: PUT /api/products/ (XML Body)
- Bild-Upload: Separate API-Calls pro Bild
4.2 Mehrsprachigkeit
Alle textbasierten Felder sind mehrsprachig:
- name[], description[], description_short[]
- meta_title[], meta_description[], meta_keywords[], link_rewrite[]
- Format: [{id: languageId, value: "Text"}]
4.3 Feature-Verwaltung
- Features werden automatisch erstellt, wenn sie nicht existieren
- Feature-Werte werden automatisch erstellt, wenn sie nicht existieren
- Features werden pro Sprache erstellt
4.4 Bild-Upload
- Alte Bilder werden vor dem Upload gelöscht
- Bilder werden einzeln hochgeladen
- Unterstützt
fileNameundfilePathfür bessere Bild-Verwaltung - Hauptbild wird als
id_default_imagegesetzt
4.5 Standard-Felder
Bei Update werden folgende Felder beibehalten:
- id_category_default (wenn nicht geändert)
- available_now
- available_later
- date_add
5. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| PrestaShop 8 Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
reference |
material.sku |
Immer | - |
weight |
material.grossWeight |
Immer | - |
width |
material.width |
Immer | - |
depth |
material.depth |
Immer | - |
height |
material.height |
Immer | - |
active |
material.isMarketplaceActive |
Immer | 1 oder 0 |
ean13 |
material.gtin |
Immer | - |
id_category_default |
material.prestashopAssociations.categories[0].id |
Immer | - |
id_manufacturer |
material.prestashopManufacturerId |
Immer | - |
id_tax_rules_group |
material.prestashopTaxRulesGroupId |
Immer | - |
price |
material.price.rrp oder value (netto) |
PRICE | - |
wholesale_price |
material.purPrice |
PRICE | - |
unit_price_ratio |
material.purchaseUnit |
PRICE | - |
unity |
material.packUnit |
PRICE | - |
low_stock_threshold |
material.reorderStockLevel |
STOCK | - |
low_stock_alert |
Immer 0 |
STOCK | - |
name[] |
material.name oder translations[].name |
DESCRIPTION | Mehrsprachig |
description[] |
material.detailDescription oder translations[].detailDescription |
DESCRIPTION | Mehrsprachig |
description_short[] |
material.description oder translations[].description |
DESCRIPTION | Mehrsprachig |
meta_title[] |
material.metaTitle oder translations[].metaTitle |
SEO | Mehrsprachig |
meta_description[] |
material.metaDescription oder translations[].metaDescription |
SEO | Mehrsprachig (max 250 Zeichen) |
meta_keywords[] |
material.keyWord oder translations[].keyWord |
SEO | Mehrsprachig |
link_rewrite[] |
Generiert aus material.name |
SEO | Mehrsprachig |
show_price |
Immer 1 |
Immer | - |
state |
Immer 1 |
Immer | - |
available_for_order |
Immer 1 |
Immer | - |
redirect_type |
Immer 404 |
Immer | - |
id_default_image |
Automatisch | IMAGE | Nach Bild-Upload |
associations.categories[] |
material.prestashopAssociations.categories[] |
CATEGORY | - |
associations.manufacturers[] |
material.prestashopAssociations.manufacturers[] |
ARTIKEL_DATA | - |
associations.features[] |
material.propertyValues[] |
ARTIKEL_ATTRIBUTE | - |
images[] |
material.images[] |
IMAGE | Nur wenn refreshPictures = true |
6. API-Endpunkte
- Produkt-Erstellung:
POST /api/products/(XML) - Produkt-Update:
PUT /api/products/(XML) - Bild-Upload:
POST /api/images/products/{productId}(separate Calls) - Feature-Erstellung:
POST /api/product_features(XML) - Feature-Wert-Erstellung:
POST /api/product_feature_values(XML)
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse