Feld-Mapping Dokumentation: reybex → Farmazon
Übersicht
Diese Dokumentation beschreibt, welche Felder von reybex nach Farmazon übertragen werden und wie sie gemappt werden. Die Übertragung erfolgt über die Farmazon REST API.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Farmazon 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 Farmazon-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 Farmazon übertragen werden. Für jedes Farmazon-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 Farmazon Listing)
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Farmazon-Produktstruktur
- Listing: Das Produktangebot in Farmazon
- Product: Das Produkt in Farmazon
- REST API:
POST /api/v2/listings/createlistingsoderPUT /api/v2/listings/updatelistings(JSON)
1. Produkt-Felder (Listing Level)
Die folgenden Felder werden auf Listing-Ebene in Farmazon übertragen:
1.1 Basis-Informationen
| Farmazon Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
listing[].id |
material.marketplaceProductId |
Listing-ID | Wenn vorhanden (Update) |
listing[].product.name |
material.name |
Produktname | Immer |
listing[].product.barcode |
material.gtin oder material.marketplaceSku |
Barcode | Immer |
listing[].product.psf |
material.price.rrp oder material.price.value |
UVP/Listenpreis | Immer |
listing[].product.vat |
material.vatRate |
MwSt.-Satz | Immer |
1.2 Beschreibung
| Farmazon Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
listing[].description |
material.detailDescription oder material.description |
Produktbeschreibung | Immer |
1.3 Preise
| Farmazon Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
listing[].price |
material.price.value |
Verkaufspreis | Immer |
1.4 Bestand
| Farmazon Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
listing[].stock |
material.stock.value |
Bestand | Immer |
1.5 Status
| Farmazon Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
listing[].state |
material.isMarketplaceActive ? 1 : 2 |
Status (1=aktiv, 2=inaktiv) | Immer |
1.6 Zusätzliche Felder
| Farmazon Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
listing[].expiration |
material.expiryDate (formatiert) |
Ablaufdatum | Wenn vorhanden |
listing[].isFeatured |
material.isHighlighted |
Hervorgehoben | Immer |
2. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Farmazon-Felder |
|---|---|---|
| ARTIKEL_DATA | Artikeldaten | id, product.name, product.barcode, product.psf, product.vat, state, isFeatured |
| DESCRIPTION | Beschreibung | description |
| PRICE | Preis | price, product.psf |
| STOCK | Bestand | stock |
3. Besondere Verhaltensweisen
3.1 REST API
Farmazon verwendet REST API für alle Operationen:
- Listing-Erstellung: POST /api/v2/listings/createlistings (JSON)
- Listing-Update: PUT /api/v2/listings/updatelistings (JSON)
- Authentifizierung: Bearer Token
3.2 Create vs. Update
- Wenn
marketplaceProductIdvorhanden: Update (PUT) - Wenn
marketplaceProductIdnicht vorhanden: Create (POST) - Nach Create:
marketplaceProductIdwird aus Response extrahiert
3.3 Fehlerbehandlung
- Fehler werden aus
errorsoderstatusMessageextrahiert - Status-Code 1577: "Ürün onay bekliyor olabilir" (Produkt wartet auf Genehmigung)
MULTI_STATUSmitsuccess=true: Erfolgreich
3.4 Barcode-Logik
- Verwendet
gtinfalls vorhanden - Sonst:
marketplaceSku
3.5 Preis-Logik
psf(UVP): Verwendetrrpfalls vorhanden, sonstprice.value
4. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| Farmazon Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
id |
material.marketplaceProductId |
ARTIKEL_DATA | Nur bei Update |
product.name |
material.name |
ARTIKEL_DATA | - |
product.barcode |
material.gtin oder marketplaceSku |
ARTIKEL_DATA | - |
product.psf |
material.price.rrp oder price.value |
PRICE | - |
product.vat |
material.vatRate |
ARTIKEL_DATA | - |
description |
material.detailDescription oder description |
DESCRIPTION | - |
price |
material.price.value |
PRICE | - |
stock |
material.stock.value |
STOCK | - |
state |
material.isMarketplaceActive ? 1 : 2 |
ARTIKEL_DATA | - |
expiration |
material.expiryDate (formatiert) |
ARTIKEL_DATA | - |
isFeatured |
material.isHighlighted |
ARTIKEL_DATA | - |
5. API-Endpunkte
- Listing-Erstellung:
POST /api/v2/listings/createlistings(JSON) - Listing-Update:
PUT /api/v2/listings/updatelistings(JSON) - Authentifizierung: Bearer Token
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse