Zum Hauptinhalt springen
Mirakl

Der Fehler zu marketplace.mirakl.net im Mirakl Connector: wann er auftritt und wie Sie ihn beheben

Der Fehler zu marketplace.mirakl.net kann beim Klick auf Verbindung testen erscheinen, wenn Basis-URL oder API-Basis-URL die Beispieladresse marketplace.mirakl.net enthalten; Sie beheben ihn, indem Sie in diese beiden Felder die echten URLs Ihres Mirakl-Betreibers eintragen.

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.

Der Fehler, so wie Sie ihn sehen

Mit Odoo auf Deutsch lautet die Meldung: 'marketplace.mirakl.net' ist nur ein Platzhalter und kein echter Mirakl-Operator-Host. Konfigurieren Sie die tatsächliche Operator-URL aus der Dokumentation oder dem Support des Marktplatzbetreibers. Beispiel für ADEO/Leroy: https://adeo-marketplace.mirakl.net und https://adeo-marketplace.mirakl.net/api ('marketplace.mirakl.net' is only a placeholder and not a real Mirakl operator host. Configure the actual operator URL from the marketplace operator documentation or support. Example for ADEO/Leroy: https://adeo-marketplace.mirakl.net and https://adeo-marketplace.mirakl.net/api). Es ist ein Fehler: Die Aktion wird abgebrochen.

Kurz gesagt: Basis-URL oder API-Basis-URL enthält genau die Beispieladresse (https://marketplace.mirakl.net oder dieselbe mit /api), die das Modul nicht als echten Host eines Mirakl-Betreibers akzeptiert.

Mit Code erstelltes Schema, kein Odoo-Bildschirm: von oben nach unten das Menü der Instanzen, die Schaltfläche zum Testen der Verbindung, die URL-Felder und die Meldung zu marketplace.mirakl.net
Schema auf Grundlage des veröffentlichten Modulcodes (kein Odoo-Screenshot) mit Menü, Schaltfläche, Feldern und Meldung, für Odoo 17, 18, 19 und 20. Die Beschriftungen im Schema sind der Originaltext aus dem Code des Moduls.

Dieselbe Meldung erscheint in der Sprache Ihres Odoo. Das folgende Schema zeigt sie auf Spanisch, Deutsch, Französisch, Italienisch und Portugiesisch.

Mit Code erstelltes Schema, kein Odoo-Bildschirm: dieselbe Meldung zu marketplace.mirakl.net auf Spanisch, Deutsch, Französisch, Italienisch und Portugiesisch
Schema auf Grundlage der veröffentlichten Übersetzungen des Moduls (kein Odoo-Screenshot): die Meldung so, wie der Benutzer sie je nach Sprache seines Odoo sieht.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (Video auf Englisch)

Details, die man im Formular nicht sieht

Er kann beim Klick auf Verbindung testen erscheinen

Die Schaltfläche Verbindung testen (Test Connection) befindet sich in der Ansicht der Instanz und ist in Odoo 17, 18, 19 und 20 immer sichtbar. Beim Klick gelangt das Modul zur Prüfung der Verbindungskonfiguration und löst diesen Fehler aus, wenn die folgende Bedingung erfüllt ist. Die Formulare unter Mirakl Instanzen (Mirakl Instances) öffnen Sie über das Menü Mirakl › Konfiguration › Marktplätze.

Der Wert muss einer Beispieladresse genau entsprechen

Das Modul vergleicht den Wert von Basis-URL (Base Url) und den von API-Basis-URL (API Base URL) mit bestimmten Adressen und löst den Fehler aus, wenn einer der beiden genau übereinstimmt:

  • Basis-URL ist https://marketplace.mirakl.net oder http://marketplace.mirakl.net.
  • API-Basis-URL ist https://marketplace.mirakl.net/api oder http://marketplace.mirakl.net/api.

Sobald eines der beiden Felder eine dieser Adressen enthält, tritt der Fehler auf, auch wenn das andere korrekt ist.

Eine echte URL, die diesen Text enthält, löst den Fehler nicht aus

Das Modul sucht den Text marketplace.mirakl.net nicht innerhalb des Feldes, sondern vergleicht den vollständigen Wert mit der Liste oben. Eine Adresse wie https://adeo-marketplace.mirakl.net endet zwar auf dieselben Wörter, ist aber keiner Beispieladresse gleich und löst diese Meldung daher nicht aus. Eine bereits korrekt eingetragene Betreiber-URL müssen Sie also nicht anfassen.

Schrägstriche am Ende und das Protokoll ändern nichts

Vor dem Vergleich entfernt das Modul die abschließenden Schrägstriche jeder Adresse. Deshalb zählt https://marketplace.mirakl.net/ genauso als Beispieladresse wie die Variante ohne Schrägstrich. Außerdem enthält die Liste der Beispieladressen sowohl die Version mit https als auch die mit http; ein Wechsel des Protokolls umgeht die Prüfung also nicht.

Es gibt keinen gemeinsamen Host für alle Marktplätze

Die Hilfe zu Basis-URL sagt es so: Echter Mirakl-Betreiber-Host. Mirakl stellt keinen universellen Host bereit, der von jedem Marktplatz gemeinsam genutzt wird. Beispiel: https://adeo-marketplace.mirakl.net (für bekannte Betreiber automatisch ausgefüllt; andernfalls aus Ihrem Verkäuferkonto eingeben). Erforderlich, bevor Sie Verbindung testen oder synchronisieren können.

Das heißt: Laut dieser Hilfe wird das Feld bei bekannten Betreibern automatisch ausgefüllt; bei allen anderen tragen Sie die Adresse selbst aus Ihrem Verkäuferkonto ein oder entnehmen sie der Dokumentation oder dem Support des Betreibers, wie es die Meldung selbst angibt. Und da die Hilfe das Feld als erforderlich markiert, bevor Sie die Verbindung testen oder synchronisieren können, sollten Sie es von Anfang an korrekt ausfüllen.

Die API-Adresse hat ihre eigene Hilfe

Die Hilfe zu API-Basis-URL lautet: Echte Mirakl-API-Basis-URL für den ausgewählten Betreiber. Normalerweise ist es Basis-URL + /api. Beispiel: https://adeo-marketplace.mirakl.net/api. Beide Felder befinden sich im selben Formular, im Reiter Verbindung, Gruppe Zugriff.

So beheben Sie ihn

  1. Öffnen Sie Mirakl › Konfiguration › Marktplätze und rufen Sie das Formular der Instanz auf.
  2. Wechseln Sie in den Reiter Verbindung und zur Gruppe Zugriff: Dort finden Sie Basis-URL und API-Basis-URL.
  3. Prüfen Sie, welches der beiden Felder genau einer der Beispieladressen aus der Liste oben entspricht (es kann nur eines oder beide betreffen). Lassen Sie die Felder, die bereits die URL Ihres Betreibers enthalten, unverändert.
  4. Tragen Sie bei Basis-URL, falls dort die Beispieladresse steht, den echten Host Ihres Betreibers ein. Für ADEO/Leroy lautet das Beispiel aus der Meldung selbst https://adeo-marketplace.mirakl.net. Wenn Ihr Betreiber ein anderer ist, verweist die Meldung auf die Dokumentation oder den Support des Marktplatzbetreibers und die Hilfe des Feldes auf Ihr Verkäuferkonto.
  5. Tragen Sie bei API-Basis-URL, falls dort die Beispieladresse steht, die echte API-URL des Betreibers ein. Für ADEO/Leroy lautet das Beispiel https://adeo-marketplace.mirakl.net/api.
  6. Klicken Sie nach der Änderung der Adressen erneut auf Verbindung testen.

Was Sie danach prüfen sollten

Prüfen Sie, dass keine der beiden Adressen mehr https://marketplace.mirakl.net oder https://marketplace.mirakl.net/api ist, mit oder ohne abschließenden Schrägstrich und mit https oder http. Prüfen Sie außerdem, dass API-Basis-URL zum selben Betreiber gehört wie Basis-URL, wie es die zugehörige Hilfe mit dem ADEO/Leroy-Beispiel angibt. Wenn Sie die übrigen Felder der Instanz durchgehen möchten, erklären wir sie in den Feldern der Mirakl-Instanz.

Er tritt in allen veröffentlichten Versionen auf

In Odoo 20.0 führt das Modul die Prüfung so durch, wie oben erklärt. Die Meldung steht im veröffentlichten Code aller vier Zweige, 17.0, 18.0, 19.0 und 20.0, und das Modul ist in Odoo Apps für genau diese Versionen veröffentlicht.

Wenn Sie die Einrichtung lieber abgeben möchten

FlexigoTech implementiert Odoo 17, 18, 19 und 20 und entwickelt individuelle Konnektoren und Integrationen. Wenn Sie die Mirakl-Instanz gemeinsam mit jemandem verbinden möchten, werfen Sie einen Blick auf die Seite des Moduls oder den Eintrag in Odoo Apps.

Weiterlesen

Checkliste zur Mirakl-Connector-Instanz, Feld für FeldCheckliste zum Ausfüllen der Mirakl-Connector-Instanz in Odoo: Verbindung, Abrechnungskonten und Optionen, mit dem Hilfetext jedes Feldes.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.
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen