Marketplace-Synchronisation (OMP02)

Transaktion: OMP02 Marketplace synchronization
UI-Pfad: /marketPlaceSynchronization

Business-Zweck

Marktplatz Synchronisation ist das zentrale Monitoring für alle Datentransfers zwischen reybex und externen Kanälen: Artikel-Export, Bestands-Updates, Bestellimport, Versand-Rückmeldungen und Rechnungs-Uploads. Partner sehen Status, Fehler und können Jobs manuell anstoßen oder wiederholen.

→ Vollständige fachliche Sync-Dokumentation (Richtungen, Provider, Client-Besonderheiten): Synchronisation Reybex ↔ Marktplätze/Shops

Kernbegriffe

Begriff	Bedeutung
MarktplaceMaterialTransfer	Job für Material-Sync (out/in)
MarktplaceOrderTransfer	Job für Order-Import/-Export
processingStatus	0=offen, 1=in Bearbeitung, 2=erfolgreich, 3=Fehler (retry), 4=Fehler (final)
postway	0=incoming (Import), 1=outgoing (Export)
actionName	Ausgeführte Endpoint-Aktion
submissionId	Externe Referenz (Feed-ID, API-Job)

Fachlicher Ablauf

Material-Synchronisation (Export)

Typische Auslöser:

• Artikel manuell an Kanal senden (aus BAS02/OMP07)
• Bestandsänderung (INV-Buchung) → Stock-Sync
• Preisänderung (SAL09) → Price-Sync
• Massenbearbeitung (OMP07) → Bulk-Export

Felder je Transfer: material, marktplace, stock, salesPrice, materialFieldsToExport, sku, asin.

Order-Synchronisation (Import)

Typische Auslöser:

• Automatischer Job (jobInterval in OMP01)
• Manuell: POST /api/marketplace/importOrders
• Einfach-Import: GET /api/marketplace/performSimpleOrderImport

Ergebnis: SalesHead mit marktplaceOrderId, verknüpft mit Kanal.

Order-Export / Status-Rückmeldung (Export)

Nach Fulfillment:

• Versandstatus an Kanal (updateOrderStatusInMarketplace)
• Tracking über SMP/SAL31
• Rechnungs-Upload (uploadInvoices) – z. B. Amazon, Kaufland, Real

Partner-Szenarien

Transfer-Status prüfen

1. OMP02 öffnen – Tabs für Material- und Order-Transfers
2. Filter nach Kanal, Status, Datum
3. Fehlerdetails in marktplaceTransferError / Order-Import-Errors

API:

• GET /api/marketplace/synchronizationData – aggregierte Sync-Übersicht
• GET /api/marketplaceMaterialTransfer – Material-Jobs
• GET /api/marketplaceOrderTransfer – Order-Jobs
• GET /api/marketplaceOrderTransfer/orderImportErrors – Import-Fehler

Manuellen Bestellimport auslösen

POST /api/marketplace/importOrders
{
  "marktplaceId": 1234567890,
  "orderImportStartDate": "01.09.2026",
  "orderImportEndDate": "09.09.2026"
}

Artikel-Export starten

Nach Änderung am Artikel erscheint ein Transfer in OMP02. Alternativ:

• POST /api/marketplace/marketplaceUpdateMaterial
• GET /api/marketplace/sendMaterialTransfer (Job)
• POST /api/marketplace/uploadData

Fehlgeschlagene Transfers bereinigen

• Material: DELETE /api/marketplaceMaterialTransfer/ mit { "ids": [...] }
• Order: DELETE /api/marketplaceOrderTransfer/ mit { "ids": [...] }

Voraussetzungen

• Aktiver Kanal in OMP01 (isActive)
• Gültige Verbindung (checkConnection)
• Für Order-Import: Kunde/Belegart/Lager konfiguriert
• Für Material-Export: MaterialMarktplace-Eintrag oder Neuanlage erlaubt

Häufige Fehler

Symptom	Ursache	Maßnahme
Kein freier Lagerplatz	importWarehouses ohne freie Plätze	Lager/Plätze in Prüftabellen prüfen (OMP01)
SKU nicht gefunden	Artikel fehlt oder falsche SKU	BAS02 anlegen, materialFindingAlgorithm prüfen
OAuth abgelaufen	Token ungültig	Verbindung in OMP01 erneuern
Feed-Fehler Amazon	submissionInfo mit Feed-Report	GET /api/marketplace/feedSubmissionResult

Auswirkungen im ERP

Transfer-Typ	Erfolg	Fehler
Material Export	Listing/Preis/Bestand am Kanal aktualisiert	Retry oder manuelle Korrektur in OMP07
Order Import	Auftrag (SAL16) angelegt	Eintrag in Order-Import-Errors
Order Export	Versandstatus am Kanal	Wiederholung nach Tracking-Fix
Invoice Upload	Rechnung beim Marktplatz	SAL18 prüfen, erneut uploaden

API-Referenz

Verwandte Themen

• Marktplatz-Konfiguration
• Massenbearbeitung (OMP07)
• Aufträge
• Versand (SMP)