Medusa für Odoo
Marktplatz-Connector · Odoo 19 lieferbar, Odoo 20 auf Anfrage · Community und Enterprise
Selbst gehosteter Medusa-Shop mit Odoo verbunden: Bestellungen, Bestand, Preise, Retouren und Erstattungen.
Kern ist PflichtOhne den Sales Channel Connector – Kern läuft Medusa Connector nicht. Der Kern ist die Grundlage für jedes Kanal-Modul und kostet einmal je Odoo-Instanz; weitere Module brauchen ihn dann nicht noch einmal.
- Schnittstelle
- Medusa v2 Admin API
- Takt
- Alle 15 Minuten, einstellbar
- Odoo
- 19, Community und Enterprise
- Lizenz
- Kauf einmalig, OPL-1
Was das Modul macht
- Bestellungen automatisch als Odoo-Verkaufsauftrag
- Bestand senden
- Preise senden
- Tracking melden
- Marktplatz-Bestand lesen
- Erstattung auslösen
- Retouren und Erstattungen über die Admin-API
Aus dem Marktplatz-Kern, immer dabei
Das bringt der Sales Channel Connector – Kern mit. Sie kaufen ihn einmal, jedes Modul nutzt ihn.
- Eine Eingangsliste für alle Kanäle, jede Bestellung wird automatisch ein Odoo-Verkaufsauftrag
- Produkt-Zuordnung mit Vorschlägen über EAN und SKU, Platzhalter statt Blockade
- Steuern aus Ihren Odoo-Regeln, Ausgleich auf den tatsächlich gezahlten Betrag
- Rechnung je Kanal: aus, Entwurf, gebucht oder gebucht und bezahlt, mit Doppelsende-Schutz
- Bestand nach jeder Änderung an alle Kanäle, mit Puffer je Kanal und Niedrigbestand-Alarm
- Storno- und Retourenablauf nach Ihren Regeln, Sync-Protokoll mit Fehlerdetails, Wiederholung mit steigendem Abstand
- Dashboard je Kanal: Umsatz heute und im Monat, offene Aufträge, versendet, Fehler
- Zugangsdaten verschlüsselt, Rollen Benutzer und Manager, Multi-Company
- Jeder Sendeschalter ist ab Werk aus
So arbeitet das Modul im Einzelnen
Geprüft am Modul selbst, Stand Oktober 2026. Was hier nicht steht, kann das Modul nicht.
- Bestellungen neueste zuerst bis zum Ende der Liste. Der Auftrag entsteht bei „open“, die Rechnung erst bei erfasster Zahlung.
- Retouren: „received“ und „partially_received“ lösen Rücklieferung und Gutschrift aus, „requested“ ist sichtbar; jede Retoure wird je Status einmal verarbeitet.
- Zuordnung über Varianten-ID, dann SKU. Bestand als Lagerlevel des Inventarartikels am Kanal-Standort, Preis als Variantenpreis in Kanalwährung.
- Sendungsnummer: Fulfillment mit allen Positionen anlegen, dann Shipment mit Sendungsnummer.
- Erstattung gegen die zuletzt erfasste Zahlung, Grund aus Ihrer Medusa-Liste, Teilbeträge mehrfach.
- Der Marktplatzbestand lässt sich zurücklesen.
So läuft eine Medusa-Bestellung durch Odoo
Jeder Schritt als Beleg, mit erfundenen Beispielwerten. So sieht der Weg aus, den jede Bestellung nimmt.
- 01BestellungMedusa · 09:41Bestellnummer…-44712 × Artikel89,80 €Statusbezahlt
Der Käufer bestellt und bezahlt auf Medusa. Sie tun nichts.
- 02AbrufOdoo · bis 09:56KanalMedusaProdukteüber EAN zugeordnetKundeangelegt oder erkannt
Das Modul holt neue Bestellungen im eingestellten Takt, ab Werk alle 15 Minuten. Doppelte Abrufe erzeugen keine doppelten Aufträge.
- 03VerkaufsauftragOdoo · 09:56AuftragS00412Steuernaus Ihren RegelnRechnungje Einstellung
Der Auftrag entsteht mit Kunde, Positionen, Steuern und Versandkosten, auf den Cent wie vom Käufer bezahlt. Die Lieferung ist angelegt.
- 04VersandLager · 11:05LieferungWH/OUT/00412Etikettaus der Versand-SuiteSendungsnummerJJD 0000 1…
Sie packen und versenden wie immer. Das Etikett kommt aus Odoo, wenn Sie die Versand-Suite nutzen.
- 05RückmeldungMedusa · 11:06SendungsnummergemeldetRechnungin OdooBestandaktualisiert
Was Sie eingeschaltet haben, geht automatisch zurück an Medusa. Der Käufer sieht die Sendungsnummer.
So sieht es aus
Drei Bildschirme, die Sie nach der Einrichtung täglich sehen: die Liste, die Einstellungen und das Protokoll. Schematisch gezeichnet, damit Sie wissen, was Sie bekommen.
- 09:41:02Abruf Medusa: 3 neue Bestellungen, 0 Änderungen
- 09:41:03…-4471 → Verkaufsauftrag S00412, Kunde erkannt, 2 Positionen über EAN
- 09:41:03…-4466 → wartet: Produkt 4006381… nicht zugeordnet, Vorschlag über EAN liegt vor
- 09:42:10Bestand an Medusa: 12 Artikel aktualisiert (Puffer 2)
- 11:06:31Sendungsnummer JJD 0000 1… an Medusa gemeldet, Bestellung …-4471
Was passiert, wenn …
Die Fälle, die im Alltag vorkommen, und was das Modul dann tut. Geprüft am Code, nicht am Prospekt.
- Der Käufer storniert auf dem Marktplatz.
- Bestellstatus „storniert“ stoppt den Auftrag in Odoo. Lieferung und Entwurfsrechnung werden abgebrochen, reservierter Bestand ist wieder frei, eine Gutschrift entsteht nach Ihrer Regel. Eine Notiz am Beleg sagt, warum.
- Eine Retoure kommt.
- Ein Retourenobjekt „received“ oder „partially_received“ löst Rücklieferung und Gutschrift nach Ihrer Regel aus; am Beleg stehen Retouren-ID, Status und Erstattungsbetrag.
- Sie müssen erstatten.
- Knopf „Auf Marktplatz erstatten“ mit den Gründen Ihrer Instanz, Teilbeträge mehrfach.
- Der Marktplatz ist gerade nicht erreichbar.
- Wiederholung bei Überlastung und Serverfehlern; Fulfillment, Shipment und Erstattung nie blind. Statusabgleich und Retourenabruf brechen den Import nie ab.
- Eine Bestellung kommt doppelt an.
- Jede Marktplatz-Bestellnummer wird je Kanal nur einmal zum Auftrag. Ein zweiter Abruf erkennt sie und legt nichts Neues an.
- Ein Produkt ist in Odoo nicht zugeordnet.
- Zuordnung über Varianten-ID, dann SKU. Sonst landet die Position auf dem Platzhalterprodukt des Kanals, mit Vorschlag.
- Der Bestand geht auf null.
- Der neue Bestand geht beim nächsten Lauf an Medusa, abzüglich des Puffers, den Sie je Kanal setzen. 0 wird gesetzt. Der Niedrigbestand-Alarm meldet sich vorher.
Zugang und Voraussetzungen
Was Sie brauchen, bevor es losgeht, und was ausdrücklich nicht.
- Schnittstelle
- Medusa v2 Admin API: Bestellungen, Retouren, Produktvarianten, Inventar und Lagerlevel, Fulfillments, Zahlungen und Erstattungen, Vertriebskanäle; Anmeldung mit Admin-API-Schlüssel
- Konto beim Anbieter
- Eigene Medusa-v2-Instanz mit Admin-Zugang
- Was eingetragen wird
- Basis-URL der Instanz, Admin-API-Schlüssel (Secret Key), Lagerstandort-ID und Währung
- In Odoo
- Verkauf, Lager, Rechnungen (Standard-Apps von Odoo)
- Takt
- Alle 15 Minuten, einstellbar; Import ohne Datumsfenster mit Dedup je Bestellung, Statusabgleich 14 Tage
- Sofortmeldung
- Keine Sofortmeldung vom Anbieter, Bestellungen werden nach Zeitplan geholt. Nach außen: signierte Webhooks für Bestellung, Sendungsnummer und Rechnung, zum Beispiel für n8n.
- Im Formular
- Basis-URL und Admin-API-Schlüssel
- Währung: EUR, USD, GBP, CHF, SEK, DKK, NOK, PLN, CZK, CAD, AUD, JPY
- Lagerstandort-ID für Bestand und Fulfillment
- Sendungsnummer an Medusa senden
- Knopf „Auf Marktplatz erstatten“ mit den Gründen Ihrer Instanz
- Retouren-Regeln: schalten den Retourenabruf frei
- Nicht nötig
- Keine Cloud-Registrierung
- Keine Token-Erneuerung
- Kein Odoo Enterprise
Gut zu wissen
Grenzen, die wir lieber vorher sagen.
- Kein Rechnungs-Upload
- Medusa v2 ist stark konfigurierbar; Bestand, Preis, Fulfillment-Pfad und Anmeldeart stimmen wir bei der Einrichtung auf Ihre Instanz ab
Passt dazu
- Medusa Product Launcher
Produkte aus Odoo heraus auf Medusa anlegen und aktualisieren – mit den Pflichtfeldern von Medusa, geprüft vor dem Senden.
149 €+ Kern 249 € - Medusa Settlements
Auszahlungen und Gebühren von Medusa in Odoo spiegeln und den Bestellungen zuordnen.
149 €+ Kern 249 € - Shipping Channels – Basis
Labels mit einem Klick am Auftrag oder an der Lieferung – für ganz Odoo, auch ohne Marktplätze.
249 €Kern, Grundlage
Fragen dazu
Brauche ich Odoo Enterprise?
Nein. Alle Module laufen auf Odoo 19, Community und Enterprise; Odoo 20 folgt auf Anfrage. Einzige Ausnahme: Die Amazon-Enterprise-Brücke ergänzt Odoos eigenen Amazon-Connector und setzt deshalb Enterprise voraus. Für Amazon ohne Enterprise nutzen Sie das Modul Amazon SP-API.
Werden Bestellungen automatisch zu Verkaufsaufträgen?
Ja. Sie stellen je Kanal ein, ab welchem Marktplatz-Status ein Auftrag entsteht, zum Beispiel erst nach Zahlungseingang. Steuern und Steuerposition kommen aus Ihren Odoo-Steuerregeln; der Auftrag wird auf den tatsächlich gezahlten Bruttobetrag abgestimmt.
Wie funktioniert der Bestandsabgleich?
Bei jeder Bestandsänderung in Odoo wird der neue Wert sofort an den Kanal gesendet. Je Produkt und Kanal entscheiden Sie: Odoo-Bestand folgen oder fester Kanalbestand. Ein Sicherheitspuffer je Kanal verhindert Überverkauf. Sie können außerdem den Bestand vom Marktplatz lesen und mit Ihrem vergleichen.
Was passiert bei Stornos und Retouren?
Stornos vom Marktplatz kommen automatisch an und laufen über denselben Ablauf wie ein Storno in Odoo. Für Retouren legen Sie je Kanal Regeln fest: Rücklieferung als Entwurf oder validiert, Gutschrift ja oder nein, Frist. Bei Kaufland und OTTO entscheiden Sie Retouren direkt aus Odoo. Erstattungen aus Odoo heraus sind bei Kaufland, Shopify, WooCommerce, Medusa, Temu und Stripe möglich; Amazon erstattet dem Käufer selbst.
Was passiert, wenn der Marktplatz nicht erreichbar ist?
Nichts geht verloren. Fehlgeschlagene Übertragungen landen in einer Wiederhol-Warteschlange mit steigendem Abstand. Jeder Versuch steht im Sync-Protokoll mit der Antwort des Marktplatzes, und am Beleg erscheint eine Notiz.
Wie funktionieren Updates nach dem ersten Jahr?
Mit dem Update-Plan: 25 % des Kaufpreises im Jahr. Darin sind alle neuen Versionen des Moduls, Anpassungen, wenn ein Marktplatz seine Schnittstelle ändert, und Fehlerbehebungen. Ohne Update-Plan läuft das Modul weiter, bekommt aber keine neuen Versionen. Der Plan ist jährlich kündbar.
Medusa Connector: Passt das zu Ihrem Odoo?
Sagen Sie uns Ihre Odoo-Version und wie Sie heute arbeiten. Wir prüfen, ob das Modul passt, und schicken ein Angebot mit Installation, wenn Sie wollen.