74 Marktplätze, ein einheitlicher Connector-Stack
Eine vollständige Mirakl-Betriebsschicht für Odoo plus eigene Anbindungen für Kaufland, OTTO, Shop-Apotheke, DocMorris, BILD Marktplatz, Decathlon und 70+ weitere DACH/EU-Plattformen — Bestellimport, Listing-Synchronisation, Sendungsverfolgung, Erstattungen, Helpdesk-Anbindung, Bestellannahme (OR21), Vorfallsverwaltung, Kundenbelastung (PA01), Auszahlungs-Abgleich und Live-Webhooks unter einem einzigen Workflow.
Funktionen im Überblick
Was unsere Connector-Suite aus jeder Marktplatz-Anbindung herausholt — von der ersten Artikelnummer bis zur Auszahlungs-Abrechnung.
Bestellimport & Verkaufsabwicklung
- Bestellimport nach Erstelldatum, Änderungsdatum oder spezifischer Marktplatz-Bestellnummer
- Anlage von Kunden-, Rechnungs- und Lieferadressen direkt aus Mirakl-Datenpaketen
- Marktplatz-Status, Provision, Vertriebskanal und Lieferdaten auf der Odoo-Verkaufsauftrag
- Import von Gutschriften und Hilfsfunktionen gegen doppelte Versandpositionen
Katalog & Listings
- Listing- und Angebots-Import mit SKU-Filter, „Nur Bestand" und „Nur neue Artikel"-Modus
- Optional: Aktualisierung bestehender Odoo-Produkte und -Preise beim Listing-Import
- Synchronisation von Attributen, Kategorien und Wertelisten für Mirakl-Katalog-Konformität
- Produkt-Zusammenführungs-Workflow und Mapping-Unterstützung für importierte Marktplatz-Artikel
Versand & Sendungsverfolgung
- Bestandsexport von Odoo nach Mirakl in Minuten- bis Stundentakten
- Tracking-Export mit zentraler Mirakl-Versanddienstleister-Konfiguration und Tracking-URLs
- Versand-Watchdog für abgeschlossene Pickings, die noch eine Marktplatz-Bestätigung benötigen
- Optionaler Rechnungs-PDF-Upload bei Versandbestätigung an Mirakl
Erstattungen & Helpdesk
- Erstattungs-Datenpaket aus Odoo-Gutschriften inklusive Versandkosten-Erstattung
- Externe Erstattungs-IDs, Zeitstempel, Status und Fehlerbehandlung in Odoo gespeichert
- Mirakl-Posteingang in Odoo-Helpdesk gespiegelt — mit Anhängen und Antwortmöglichkeit
- Bestellstornierung und Liefersichtbarkeit aus dem Helpdesk-Ticket heraus
Bestellannahme (OR21)
Mirakl: AnnehmenundMirakl: AblehnenButtons direkt im Verkaufsauftrags-Header- Sichtbar automatisch während Status
WAITING_ACCEPTANCE - Sendet positionsweise Entscheidungen an
PUT /api/orders/{id}/accept - Lokale Spiegelung in
mirakl_acceptance_statemit Zeitstempel
Vorfallsverwaltung
Vorfall öffnenundVorfall schließenauf bereits versandten Mirakl-Bestellungen- Ruft
POSTundDELETE /api/orders/{id}/incidentauf - Schützt den Verkäufer vor automatischen Erstattungs-Timeouts während ein Reklamationsfall offen ist
- Status (offen/geschlossen) und Zeitstempel werden auf dem Verkaufsauftrag gespeichert
Kundenbelastung (PA01) & Auszahlungen
Mirakl-Zahlungsmodus-Schalter auf der Marktplatz-KonfigurationPA01: Kundenbelastung-Button auf Kundenrechnungen mit Mirakl-Verkaufsauftrag- Optionaler Cron
Mirakl: Kundenbelastungs-Bestätigungfür bezahlte Rechnungen Auszahlungen abrufenholt Mirakl-Zahlungs-Historie und Self-Billing-PDFs alsir.attachment
Live-Webhooks
- Pro Instanz ein eigener Endpunkt
/mirakl/webhook/ - HMAC-SHA256-Signaturprüfung mit instanz-spezifischem Geheimnis
- Verarbeitet
ORDER_CREATED,ORDER_STATE_CHANGED,ORDER_REFUSED,MESSAGE_RECEIVED,REFUND_CREATED - Automatisch berechnete Webhook-URL im Konfigurations-Formular für direktes Kopieren
Bestandsabgleich & Angebots-Diff
- Konfigurierbarer Schwellenwert für Bestandsabweichungen, manuelle Prüfung per Button
- Liest
GET /api/offersrückwärts in Seiten zu je 100 Einträgen - Meldet Bestandsabweichungen, verwaiste Angebote (nur Mirakl) und fehlende Angebote (nur Odoo)
- Optionaler Cron
Mirakl: Bestands- & Angebots-Abgleichalle 6 Stunden
Welche Marktplätze wir nativ anbinden
Eigene Odoo-Plugins für die wichtigsten DACH- und EU-Plattformen plus alle Mirakl-basierten Marktplätze (rot markiert).
● Rot = Mirakl-basierte Plattform · ● Schwarz = native API (Kaufland, OTTO, Autodoc)
API-Endpunkte im Detail
Welche Mirakl-Verkäufer-API-Endpunkte unsere Connectoren ansprechen — kategorisiert nach Funktionsbereich. Endpunkte mit (neu) wurden in Plugin-Version 19.0.1.0.3 ergänzt.
Stammdaten & Katalog
GET /api/accountGET /api/channels,/api/hierarchies,/api/reasonsGET /api/shipping/carriers,/api/shipping/zones,/api/shipping/logistic_classesGET /api/offers/states,/api/products/attributesPOST /api/products/imports,/api/offers/imports,/api/offers/stock/imports
Bestellungen & Versand
GET /api/orders,/api/orders/documentsPUT /api/orders/{id}/cancel,/api/orders/{id}/trackingPOST /api/orders/refundPUT /api/orders/{id}/accept(neu)POST/DELETE /api/orders/{id}/incident(neu)
Zahlungen & Self-Billing
GET /api/sellerpayment/transactions_logsPOST /api/payment/debit(neu)GET /api/payment/payments_history(neu)GET /api/payment/payment_documents/{id}/download(neu)
Helpdesk-Posteingang
GET /api/inbox/threadsGET /api/inbox/threads/{id}POST /api/inbox/threads/{id}/messageGET /api/inbox/threads/{id}/download
Typischer Onboarding-Ablauf
Von der Marktplatz-Auswahl bis zum Live-Listing — so läuft eine Cognisance-Anbindung.
- Marktplatz-Konfiguration anlegen und Stammdaten, Attribute und Wertelisten importieren.
- Listings und erste Marktplatz-Bestellungen nach Odoo importieren.
- Neue Mirakl-Bestellungen direkt im Verkaufsauftrags-Header (OR21) annehmen oder ablehnen, falls der Marktplatz eine ausdrückliche Annahme verlangt.
- Bestellungen in Odoo abwickeln, Bestand und Sendungsverfolgung zurück an Mirakl exportieren.
- Mirakl-Vorfälle aus Odoo öffnen, falls eine Kunden-Reklamation nicht über Standard-Erstattung oder Versand-Korrektur lösbar ist.
- Rechnungen hochladen und Erstattungen synchronisieren. Bei Mirakl-Zahlungsabwicklung: Kundenbelastung (PA01) aus der Rechnung oder per Cron bestätigen.
- Auszahlungs-Historie und Self-Billing-PDFs nach Odoo ziehen für die Buchhaltungs-Abstimmung.
- Bestandsabgleich regelmäßig laufen lassen, um Abweichungen zwischen Odoo und Mirakl zu erkennen, bevor sie Kunden betreffen.
Voraussetzungen
Odoo-Stack
- Modul
base_marketplace - Modul
helpdesk - Konfigurierte Verkaufs-, Bestands-, Rechnungs- und Versand-Workflows
Marktplatz-Setup
- Mirakl API-Endpunkt und API-Schlüssel
- Shop- und Versanddienstleister-Konfiguration
- Kategorien- und Attribut-Zuordnungen
- Optional
cognisance_brandmap+cognisance_brandmap_miraklfür Marken-Zuordnungen - Funktionierendes Rechnungs-PDF-Reporting für Upload-Abläufe