Marktplatz-Konfiguration (OMP01 / OMP06)

Transaktionen: OMP01 Marktplatz Konfiguration, OMP06 Marktplatz Wizard
UI-Pfad: /marketplaces

Business-Zweck

In der Marktplatz-Konfiguration legen Partner Verkaufskanäle (Shops und Marktplätze) an und steuern, wie reybex mit ihnen kommuniziert: Credentials, Belegarten, Lager, Import-Intervalle, Preislogik und Sperrregeln. OMP06 ist der geführte Wizard für Erst-Einrichtung; OMP01 die vollständige Pflege bestehender Kanäle.

Kernbegriffe

Begriff	Bedeutung
Marktplace	Mandantenspezifischer Kanal (z. B. „Amazon DE“, „Shopify Store“)
SupportedMarktplace	Provider-Vorlage (Amazon SP-API, eBay, Shopify, …)
MarketplaceConfig	Provider-spezifische Credentials und Endpoints
importWarehouses	Lager für Bestandsabzug beim Order-Import
salesDocType	Belegart für importierte Aufträge (SAL16)
jobInterval	Automatischer Order-Import (0=manuell, 1=15min, …)
isGetOnly	Nur lesen – kein Schreiben an Kanal

OMP01 – Vollständige Konfiguration

Fachlicher Ablauf

1. Provider wählen (supportedMarketplace) – z. B. Amazon, eBay, Shopify, Shopware
2. Verbindung prüfen – checkConnection (API-Key, OAuth, FTP)
3. Vertriebsregeln setzen – Belegart, Kunde, Zahlungsbedingung, Nummernkreis
4. Lager zuordnen – importWarehouses für Reservierung/Bestandsabzug
5. Import-Regeln – pastDays, Status-Filter, fehlende Artikel anlegen?
6. Export-Regeln – welche Felder synchronisiert werden (Preis, Bestand, Bilder, …)
7. Kanal aktivieren – isActive = true

Wichtige Konfigurationsfelder

Feld	Bedeutung	Partner-Hinweis
name	Anzeigename des Kanals	Eindeutig pro Mandant
salesDocType	Auftrags-Belegart	Muss Order-Typ sein (SAL16)
importWarehouses	Lager für Import	Fehlende/freie Lagerplätze → Import-Fehler
createMissingMaterials	Unbekannte SKU anlegen	Vorsicht bei Tippfeuern
blockDeliveryPriceCheck	Sperre bei EK > VK	Qualitätssicherung
jobInterval	Order-Import-Intervall	0 = nur manuell/API
priceSynchronization	Brutto/Netto beim Export	0=brutto, 1=netto
doNotUploadNewMaterial	Keine Neuanlage am Kanal	Nur Updates bestehender Listings
marketplaceConfig	Provider-Credentials	Je Provider unterschiedlich

Provider-spezifische Aspekte

Provider	Authentifizierung	Besonderheiten
Amazon SP-API	OAuth über GET /api/marketplace/amazonAuthUrl/{id}	FBA-Lager, ASIN-Mapping
eBay	Session/Token über getTokenForEbay, Fulfillment API	Seller Profiles, Templates (OMP03)
Shopify	App-OAuth über Marketplace External API	Locations (getLocationsForShopify)
Shopware 6	API-Key + Store-URL	Store-Informationen abrufbar
FTP/CSV	FTP-Pfade in marketplaceConfig	Order-/Stock-Dateien

OMP06 – Marktplatz Wizard

Der Marktplatz Wizard (OMP06) nutzt dieselbe UI-Route /marketplaces, startet aber einen geführten Flow für neue Mandanten:

1. Provider-Auswahl aus unterstützten Kanälen
2. Schrittweise Credential-Eingabe (OAuth-Redirect wo nötig)
3. Minimalkonfiguration: Belegart, Standardlager, Import-Intervall
4. Verbindungstest
5. Optional: Weiterleitung zur Marktplatz Roadmap (OMP09)

Roadmap als Einstieg

Neue Mandanten erhalten OMP09 oft als Standard-Starttransaktion. Der Wizard (OMP06) und die Roadmap ergänzen sich.

Partner-Szenarien

Amazon anbinden

1. Marktplatz anlegen (OMP01 oder Wizard OMP06)
2. GET /api/marketplace/amazonAuthUrl/{marktplaceId} – OAuth-URL öffnen
3. Nach Callback: POST /api/marketplace/auth (automatisch durch Redirect)
4. FBA-Belegart/Lager in marketplaceConfig setzen
5. POST /api/marketplace/checkConnection – Verbindung validieren

Shopify-App installieren

Externe Registrierung über Marketplace External API:

1. GET /api/marketplaceExternal/register – Shop registrieren
2. POST /api/marketplaceExternal/confirm – App-Bestätigung
3. Konfiguration in reybex abschließen (POST /api/marketplaceExternal/configuration)

Mehrere Lager für Bestandsexport

Lager-Zuordnung und Sperren je Kanal: Marktplatz-Lager API und OMP01-Feld importWarehouses.

Voraussetzungen

• Belegart für Aufträge (SAL16) konfiguriert
• Lager und Lagerplätze in Prüftabellen gepflegt (INV)
• Artikelstamm (BAS02) mit SKU/matCode
• API-/OAuth-Berechtigungen beim Provider
• Rechte OMP01 bzw. OMP06

Auswirkungen im ERP

Aktion	Auswirkung
Kanal aktivieren	Jobs für Order-Import und Material-Export starten
Lager ändern	Bestandsabzug und Reservierung bei Import
isGetOnly	Nur Import, kein Export an Kanal
Kanal löschen	Keine weiteren Sync-Jobs; bestehende Transfers bleiben in OMP02

API-Referenz

• Marketplace API – CRUD, Auth, Connection
• Material Marketplace API – Artikel je Kanal
• Marketplace Warehouse API – Lager-Sperren
• Marketplace External API – Shopify/Externe Apps

Verwandte Themen

• Synchronisation (OMP02)
• Aufträge (SAL16)
• Bestandsliste (INV03)