Feld-Mapping Dokumentation: reybex → Shopier
Übersicht
Diese Dokumentation beschreibt die Integration zwischen reybex und Shopier. Hinweis: Shopier unterstützt derzeit keine Material-Updates über die API. Die Integration ist auf das Abrufen von Bestellungen und Materialien beschränkt.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Shopier 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 Shopier-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 beschreibt die aktuelle Funktionalität der Shopier-Integration.
Wichtige Konzepte
reybex-Artikelstruktur
- Material: Ein Artikel/Produkt in reybex (entspricht Shopier Product)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Shopier-Produktstruktur
- Product: Das Hauptprodukt in Shopier
- REST API:
GET /v1/products(JSON)
1. Aktuelle Funktionalität
1.1 Material-Abruf (listMaterials)
Shopier unterstützt derzeit nur das Abrufen von Materialien:
| Shopier Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
products[].id |
material.marketplaceProductId |
Produkt-ID | Immer |
products[].title |
material.name |
Produktname | Immer |
products[].description |
material.description |
Produktbeschreibung | Immer |
products[].priceData.price |
material.rrp |
Verkaufspreis | Immer |
products[].priceData.discountedPrice |
material.salesPrice |
Reduzierter Preis | Immer |
products[].stockQuantity |
material.stock |
Bestand | Immer |
products[].stockStatus |
material.status |
Status (aktiv/inaktiv) | Immer |
products[].categories[] |
material.categories[] |
Kategorien | Immer |
products[].media[] |
material.images[] |
Bilder | Immer |
1.2 Material-Update (updateMaterials)
Nicht implementiert: Die updateMaterials-Methode gibt derzeit null zurück.
2. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Shopier-Felder |
|---|---|---|
| NICHT VERFÜGBAR | Material-Updates | Nicht implementiert |
3. Besondere Verhaltensweisen
3.1 REST API
Shopier verwendet REST API für alle Operationen:
- Material-Abruf: GET /v1/products?limit=50&page={page}&sort=dateDesc (JSON)
- Bestellungen-Abruf: GET /v1/orders?limit=50&page={page}&sort=dateAsc (JSON)
- Authentifizierung: Bearer Token
3.2 Material-Update
- Material-Updates sind derzeit nicht implementiert
- Die
updateMaterials-Methode gibtnullzurück
3.3 Bestellungen
- Bestellungen können abgerufen werden
- Format:
GET /v1/orders?limit=50&page={page}&sort=dateAsc
4. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene (nur Abruf)
| Shopier Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
id |
marketplaceProductId |
NICHT VERFÜGBAR | Nur Abruf |
title |
name |
NICHT VERFÜGBAR | Nur Abruf |
description |
description |
NICHT VERFÜGBAR | Nur Abruf |
priceData.price |
rrp |
NICHT VERFÜGBAR | Nur Abruf |
priceData.discountedPrice |
salesPrice |
NICHT VERFÜGBAR | Nur Abruf |
stockQuantity |
stock |
NICHT VERFÜGBAR | Nur Abruf |
stockStatus |
status |
NICHT VERFÜGBAR | Nur Abruf |
categories[] |
categories[] |
NICHT VERFÜGBAR | Nur Abruf |
media[] |
images[] |
NICHT VERFÜGBAR | Nur Abruf |
5. API-Endpunkte
- Material-Abruf:
GET /v1/products?limit=50&page={page}&sort=dateDesc(JSON) - Bestellungen-Abruf:
GET /v1/orders?limit=50&page={page}&sort=dateAsc(JSON) - Material-Update: Nicht implementiert
- Authentifizierung: Bearer Token
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse