Mirakl

Zweck

Der Mirakl Connector bietet eine umfassende Schnittstelle zur Integration mit der Mirakl Marketplace Platform API. Er hilft Verkäufern bei der Automatisierung von Abläufen, insbesondere bei der Verwaltung von Angeboten, der Abwicklung von Bestellungen und der Synchronisierung von Produkt- und Versandinformationen.

Mit dem Connector können:

• Angebote auf dem Marktplatz abgerufen und aktualisiert werden.

• Bestellungen nach verschiedenen Kriterien (Status, Datum) abgefragt, eingehende Bestellungen angenommen, Bestellpositionen storniert und Sendungen bearbeitet werden.

• Produkt- und Sendungsinformationen synchronisiert werden.

• Systemdaten wie Begründungscodes für andere Operationen abgerufen werden.

Praktische Anwendungshinweise

• Authentifizierung: Einfache Authentifizierung via API-Schlüssel, der automatisch im Authorization-Header jeder Anfrage gesendet wird.

• Filterung und Paginierung: Listenanfragen unterstützen Filterung nach Datumsbereichen, Statuscodes u. Ä. sowie Paginierung über offset und max.

• Massenaktualisierungen: Aktionen wie „Angebote aktualisieren“ erwarten eine JSON-Struktur mit dem Schlüssel offers, der eine Liste der zu aktualisierenden Angebote enthält.

Authentifizierung

• URL: Basis-URL der Mirakl-Umgebung.

• API Key: Front-End-API-Schlüssel vom Marktplatzbetreiber.

Erwartungen an Ein- und Ausgabe

Eingabe

• Pfad-Parameter: Für entitätsspezifische Aktionen wie „Bestellung annehmen“ ist eine order_id erforderlich.

• Query-Parameter: Filter- und Paginierungsparameter wie order_state_codes oder start_date können genutzt werden.

• JSON-Body: Für Erstellung oder Aktualisierung ist ein JSON-data-Objekt erforderlich, z. B. zur Angabe der anzunehmenden Bestellpositionen.

Ausgabe

• response: JSON-kodierter Body der API-Antwort.

• header: Antwort-Header bei aktivierter Option „Header ausgeben“.

• createResponseDataStructure: Aktion zur Erzeugung einer Datenstruktur aus der response für die Weiterverarbeitung in Workflows.