Zum Hauptinhalt springen
Mirakl

Checkliste zur Mirakl-Connector-Instanz, Feld für Feld

Das Instanzformular von Mirakl vereint die Verbindung, die Abrechnungskonten und einige Optionen; hier steht Feld für Feld, was jedes laut seiner Hilfe bedeutet und was sich empfiehlt.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 5. November 2026

Das Wichtigste

Modul
Mirakl
Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 20.0 · in den Quellen am Ende
Lesezeit
5 Min.

Die Formulare öffnen Sie über das Menü Mirakl › Konfiguration › Marktplätze in der Liste Mirakl Instanzen.

Schema mit dem Menü Mirakl, Konfiguration, Marktplätze und den Feldern des Instanzformulars
Schema, aus dem veröffentlichten Code des Moduls per Code erstellt (kein Odoo-Screenshot): das Menü und die Felder des Formulars.

Bevor Sie das Formular anfassen

  • Berechtigung. Um den Schlüssel zu sehen, müssen Sie Mirakl Manager sein: Die Hilfe zu API-Schlüssel sagt, dass nur Mirakl Managers ihn sehen oder ändern können, und den Mirakl-API-Schlüssel (FlexigoTech Cloud) sehen nur Benutzer mit dieser Berechtigung.
  • Verkäuferkonto des Marktplatzes. Öffnen Sie es in einem anderen Tab: Von dort stammen der Host des Betreibers und der API-Schlüssel, laut der Hilfe dieser Felder.
  • Abonnement. Das Modul benötigt das Abonnement für FlexigoTech Cloud (Plan Connector). Der Preis steht am Ende.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (Video auf Englisch)

Profil des Marktplatzes

  • Anbietercode (Provider Code). Er steht im Formular und auch in der Liste der Mirakl Instanzen. Es ist das Marktplatz-/Anbieterprofil, das die Instanz verwendet; laut Hilfe erscheinen beim Installieren der Anbieter-Add-ons betreiberspezifische Profile, etwa Leroy Merlin. Der Standardwert ist Generisches Mirakl (Generic Mirakl).

Tab Verbindung, Gruppe Zugriff

Diese Felder liegen im Tab Verbindung (Connection), Gruppe Zugriff (Access).

  • Mirakl-Verbindung (Mirakl connection). Das Feld ist schreibgeschützt und hat standardmäßig den Wert FlexigoTech Cloud. Die Hilfe sagt, dass neue Marktplätze über FlexigoTech Cloud angebunden werden und dass Direkt (API-Schlüssel in Odoo gespeichert) nur für Marktplätze beibehalten wird, die schon vor dieser Version existierten und weiterlaufen, so wie sie gekauft wurden. Hier ist nichts einzutragen: Prüfen Sie nur, welchen Weg Ihre Instanz hat.
  • Mirakl-API-Schlüssel (FlexigoTech Cloud) (Mirakl API key (FlexigoTech Cloud)). Es liegt in der Gruppe FlexigoTech Cloud. Mit den Standardwerten ist es sichtbar und wird ausgeblendet, wenn die Verbindung nicht die von FlexigoTech Cloud ist. Die Hilfe sagt, dass der Schlüssel einmal verschlüsselt an FlexigoTech Cloud gesendet und nie in Odoo gespeichert wird.
  • Basis-URL (Base Url). Das ist der tatsächliche Host des Betreibers. Die Hilfe weist darauf hin, dass Mirakl keinen universellen Host bereitstellt, den alle Marktplätze teilen. Bei bekannten Betreibern wird sie automatisch ausgefüllt; andernfalls tragen Sie sie aus Ihrem Verkäuferkonto ein. Beispiel aus der Hilfe: https://adeo-marketplace.mirakl.net. Sie ist Pflicht, bevor Sie die Verbindung testen oder synchronisieren können.
  • API-Basis-URL (API Base URL). Das ist die tatsächliche Basis-URL der API für den gewählten Betreiber. Die Hilfe sagt, dass sie normalerweise die Basis-URL plus /api ist, mit diesem Beispiel: https://adeo-marketplace.mirakl.net/api.
  • API-Schlüssel (Api Key). Mit den Standardwerten ist es nicht sichtbar: Es wird ausgeblendet, wenn die Verbindung FlexigoTech Cloud ist, und erscheint daher bei Instanzen mit der Verbindung Directa. Es ist der API-Schlüssel des Verkäufers (Settings > API key in Ihrem Verkäuferkonto) und wird benötigt, bevor Sie Verbindung testen verwenden oder synchronisieren können.
  • Shop. Es ist im Formular und in dieser Gruppe sichtbar. Es ist eine optionale Kennung für Multi-Shop-Umgebungen. Laut Hilfe füllt Verbindung testen es automatisch aus, wenn Mirakl den Shop des Verkäufers bereitstellt.

Tab Finanzen

Hier liegt die Buchhaltung der Abrechnungen. Im Tab Finanzen (Finances) gibt es zwei Gruppen.

Gruppe Abrechnungsbuchhaltung

  • Abrechnungsjournal (Settlement Journal). Eines von mehreren Journalen zum Buchen der Abrechnungsbuchungen von Mirakl. Lassen Sie es leer, wird bei der ersten Verwendung ein eigenes Journal angelegt, Mirakl Abrechnungen. Wählen Sie ein eigenes, wenn dieses nicht angelegt werden soll.
  • Marktplatz-Verrechnungskonto (Marketplace Clearing Account). Ein Bilanz-Zwischenkonto, das darstellt, was der Marktplatz Ihnen für die Bestellungen schuldet: Die Verkäufe belasten es, und es wird gutgeschrieben, wenn die Abrechnung die Zahlung ausführt.
  • Aufwandskonto Provision (Commission Expense Account). Das Aufwandskonto für die Provision und die Gebühren des Marktplatzes.
  • Auszahlungs-/Bankzwischenkonto (Payout / Bank Suspense Account). Es wird mit der Netto-Auszahlung belastet, die Ihnen überwiesen wird, und danach mit dem tatsächlichen Bankeingang abgeglichen: manuell in der Community, mit Bankensynchronisierung in Enterprise, laut seiner Hilfe.

Gruppe Optionen

  • Kostenstelle (Analytic Account). Optional. Damit speisen die Abrechnungen dieses Marktplatzes eine GuV pro Kanal in den analytischen Berichten von Odoo. Tragen Sie sie ein, wenn Sie diese Auswertung pro Kanal möchten.
  • Abrechnungen automatisch buchen (Auto-post settlements). Erstellt automatisch die Buchung, wenn eine Abrechnung importiert wird. Standardmäßig ist die Option deaktiviert: Aktivieren Sie sie nur, wenn Sie diese Buchung beim Import wollen.

Tab KI (optional)

  • KI-Insights aktivieren (Enable AI insights). Es liegt im Tab KI (optional) (AI (optional)) und ist standardmäßig deaktiviert. Mit Odoo auf Deutsch lautet die Hilfe Optional. Der Connector funktioniert vollständig ohne KI. Wenn Sie dies nicht aktivieren / keinen Schlüssel setzen, wird niemals ein KI-Aufruf gemacht und nichts ändert sich. Wenn Sie es nicht brauchen, lassen Sie es, wie es ist.
Schema mit dem Hilfetext des Feldes für KI-Insights in fünf Sprachen
Schema, aus den veröffentlichten Übersetzungen des Moduls per Code erstellt (kein Odoo-Screenshot): die Hilfe zu KI-Insights aktivieren auf Spanisch, Deutsch, Französisch, Italienisch und Portugiesisch.

Prüfung, bevor Sie die Instanz abnehmen

  • Prüfen Sie, dass Basis-URL und API-Basis-URL auf denselben Betreiber zeigen; normalerweise ist die zweite die erste plus /api, wie in den Beispielen der Hilfe.
  • Wenn Ihre Instanz die Verbindung Directa verwendet, bestätigen Sie, dass Basis-URL und API-Schlüssel ausgefüllt sind, bevor Sie versuchen, die Verbindung zu testen oder zu synchronisieren.
  • Schauen Sie nach dem Testen der Verbindung auf Shop: Laut seiner Hilfe wird es automatisch ausgefüllt, wenn Mirakl den Shop des Verkäufers bereitstellt.
  • Gehen Sie die Konten der Gruppe Abrechnungsbuchhaltung mit Ihrem Buchhalter durch.

Preis und Hilfe bei der Einrichtung

Das Modul ist eine Einmalzahlung pro Odoo-Version und in Odoo Apps für 17, 18, 19 und 20 veröffentlicht (siehe die Odoo-Apps-Seite oder die Seite des Moduls). Es benötigt das Abonnement für FlexigoTech Cloud, Plan Connector: 49 € pro Monat oder 490 € pro Jahr, zzgl. MwSt., bis zu 3 Plattformkonten. Die Verbindung läuft über FlexigoTech Cloud, das die Zugangsdaten verschlüsselt speichert, die Synchronisierung überwacht und bei einem Fehler per E-Mail benachrichtigt. Mit dem Abonnement ist das Modul für neue Odoo-Versionen inklusive, wenn Sie es auf flexigotech.com gekauft haben; im Odoo App Store wird jede Odoo-Version dort gekauft.

FlexigoTech führt Odoo 17, 18, 19 und 20 ein und entwickelt maßgeschneiderte Konnektoren und Integrationen. Wenn Sie möchten, dass wir das Formular Ihrer Instanz gemeinsam mit Ihnen prüfen, schreiben Sie uns.

Weiterlesen

Felder der Mirakl-Instanz im Mirakl Connector: Bedeutung und empfohlene WerteFelder der Mirakl Instanzen im Mirakl Connector für Odoo im Vergleich: was die Hilfe sagt, welche Standardwerte gelten und was Sie eintragen sollten.Die Felder der Mirakl-Instanz in Odoo: Bedeutung und empfohlene EinstellungLeitfaden zu den Feldern der Mirakl-Instanz im Mirakl Connector für Odoo: Versand, Rabatt, Provision, Sprache, Rechnungen und Synchronisierung laut Feldhilfe.
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen