Saltar al contenido principal
Mirakl

El error de marketplace.mirakl.net en Mirakl Connector: cuándo sale y cómo se corrige

El error sobre marketplace.mirakl.net puede salir al pulsar Probar conexión cuando URL base o URL base de la API tienen como valor la dirección de ejemplo de marketplace.mirakl.net; se corrige escribiendo en esos dos campos las URL reales de tu operador de Mirakl.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 5 de noviembre de 2026

Lo esencial

Módulo
Mirakl
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0 · en las fuentes enlazadas al final
Lectura
5 min

El error, tal como lo ves

Con Odoo en castellano, el mensaje dice: 'marketplace.mirakl.net' es solo un valor de ejemplo y no un host real de operador de Mirakl. Configura la URL real del operador a partir de la documentación o el soporte del operador del marketplace. Ejemplo para ADEO/Leroy: https://adeo-marketplace.mirakl.net y 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 un error: la acción se detiene.

En pocas palabras: URL base o URL base de la API tiene exactamente la dirección de ejemplo (https://marketplace.mirakl.net, o la misma con /api), que el módulo no acepta como host real de un operador de Mirakl.

Esquema hecho con código, no una pantalla de Odoo: de arriba abajo, el menú de las instancias, el botón de probar la conexión, los campos de URL y el mensaje sobre marketplace.mirakl.net
Esquema a partir del código publicado del módulo (no es una captura de Odoo) con el menú, el botón, los campos y el mensaje, para Odoo 17, 18, 19 y 20. Los rótulos del esquema son el texto original del código del módulo.

El mismo mensaje se ve en el idioma de tu Odoo. El esquema siguiente lo muestra en castellano, alemán, francés, italiano y portugués.

Esquema hecho con código, no una pantalla de Odoo: el mismo mensaje sobre marketplace.mirakl.net en castellano, alemán, francés, italiano y portugués
Esquema a partir de las traducciones publicadas del módulo (no es una captura de Odoo): el mensaje tal como lo ve el usuario según el idioma de su Odoo.
Same stock on every Mirakl marketplace, sent from Odoo
Vídeo: Same stock on every Mirakl marketplace, sent from Odoo (vídeo en inglés)

Detalles que no se ven en la ficha

Puede salir al pulsar Probar conexión

El botón Probar conexión (Test Connection) está en la vista de la instancia y se ve siempre, en Odoo 17, 18, 19 y 20. Al pulsarlo, el módulo llega a la comprobación de la configuración de la conexión y, si se cumple la condición que sigue, lanza este error. Las fichas de Instancias de Mirakl (Mirakl Instances) se abren desde el menú Mirakl › Configuración › Marketplaces.

El valor tiene que ser igual a una dirección de ejemplo

El módulo compara el valor de URL base (Base Url) y el de URL base de la API (API Base URL) con unas direcciones concretas, y lanza el error si cualquiera de las dos coincide exactamente:

  • URL base es https://marketplace.mirakl.net o http://marketplace.mirakl.net.
  • URL base de la API es https://marketplace.mirakl.net/api o http://marketplace.mirakl.net/api.

Con que una de las dos sea una de esas direcciones, el error sale, aunque la otra sea correcta.

Una URL real que lleva ese texto dentro no da el error

El módulo no busca el texto marketplace.mirakl.net dentro del campo: compara el valor completo con la lista de arriba. Una dirección como https://adeo-marketplace.mirakl.net termina en esas mismas palabras, pero no es igual a ninguna dirección de ejemplo, así que no activa este mensaje. Por eso no hay que tocar una URL de operador que ya esté bien puesta.

Las barras finales y el protocolo no cambian nada

Antes de comparar, el módulo quita las barras finales de cada dirección. Por eso https://marketplace.mirakl.net/ cuenta como la de ejemplo igual que la que no lleva barra. Además, la lista de direcciones de ejemplo incluye tanto la versión con https como la versión con http, así que cambiar el protocolo no esquiva la comprobación.

No existe un host común para todos los marketplaces

La ayuda de URL base lo dice así: Host real del operador de Mirakl. Mirakl no proporciona un host universal compartido por todos los marketplaces. Ejemplo: https://adeo-marketplace.mirakl.net (rellenado automáticamente para operadores conocidos; introdúcelo desde tu cuenta de vendedor en caso contrario). Obligatorio antes de poder probar la conexión o sincronizar.

Es decir: según esa ayuda, en los operadores conocidos el campo se rellena solo; en los demás, la dirección la introduces tú desde tu cuenta de vendedor, o la sacas de la documentación o del soporte del operador, como indica el propio mensaje. Y como la ayuda lo marca como obligatorio antes de probar la conexión o sincronizar, conviene dejarlo bien puesto desde el principio.

La dirección de la API tiene su propia ayuda

La ayuda de URL base de la API dice: URL base real de la API de Mirakl para el operador seleccionado. Normalmente es la URL base + /api. Ejemplo: https://adeo-marketplace.mirakl.net/api. Los dos campos están en la misma ficha, en la pestaña Conexión, grupo Acceso.

Cómo resolverlo

  1. Abre Mirakl › Configuración › Marketplaces y entra en la ficha de la instancia.
  2. Ve a la pestaña Conexión y al grupo Acceso: ahí están URL base y URL base de la API.
  3. Mira cuál de los dos es exactamente una de las direcciones de ejemplo de la lista anterior (puede ser uno solo o los dos). Deja como están los que ya tengan la URL de tu operador.
  4. En URL base, si es la de ejemplo, escribe el host real de tu operador. Para ADEO/Leroy, el ejemplo del propio mensaje es https://adeo-marketplace.mirakl.net. Si tu operador es otro, el mensaje remite a la documentación o al soporte del operador del marketplace, y la ayuda del campo, a tu cuenta de vendedor.
  5. En URL base de la API, si es la de ejemplo, escribe la URL real de la API del operador. Para ADEO/Leroy, el ejemplo es https://adeo-marketplace.mirakl.net/api.
  6. Con las direcciones cambiadas, pulsa de nuevo Probar conexión.

Qué comprobar después

Revisa que ninguna de las dos direcciones sea ya https://marketplace.mirakl.net ni https://marketplace.mirakl.net/api, con o sin barra final y con https o http. Revisa también que URL base de la API corresponda al mismo operador que URL base, tal como indica su ayuda al poner el ejemplo de ADEO/Leroy. Si quieres repasar el resto de campos de la instancia, los explicamos en los campos de Instancia de Mirakl.

Está en todas las versiones publicadas

En Odoo 20.0, el módulo hace la comprobación tal como se explica arriba. El mensaje está en el código publicado de las cuatro ramas, 17.0, 18.0, 19.0 y 20.0, y el módulo está publicado en Odoo Apps para esas mismas versiones.

Si prefieres que te lo configuren

FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida. Si quieres que alguien deje contigo la instancia de Mirakl conectada, mira la página del módulo o la ficha en Odoo Apps.

Sigue leyendo

Checklist de la instancia de Mirakl Connector, campo a campoChecklist para rellenar la instancia de Mirakl Connector en Odoo: conexión, cuentas de liquidación y opciones, con lo que dice la ayuda de cada campo.Campos de Instancia de Mirakl en Mirakl Connector: qué significan y qué ponerGuía comparada de los campos de la ficha Instancias de Mirakl en Mirakl Connector para Odoo: qué dice cada ayuda, su valor por defecto y qué poner.
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes