Saltar al contenido principal
Mirakl

Mirakl Connector: «Este vínculo no tiene ninguna instancia de Mirakl configurada.»

El mensaje Este vínculo no tiene ninguna instancia de Mirakl configurada. (This binding has no Mirakl instance configured.) sale al pulsar Buscar (Search) en la búsqueda de categorías de Mirakl cuando el campo Instancia (Instance) está vacío; la acción se detiene antes de buscar nada, y repetir la búsqueda con el campo vacío da el mismo resultado.

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

Dónde sale y qué significa

La ventana de búsqueda de categorías de Mirakl se titula Buscar categoría de Mirakl (Search Mirakl Category) cuando el módulo la vuelve a abrir tras una búsqueda. En ella está el botón Buscar, que según el código publicado se ve siempre, en Odoo 17, 18, 19 y 20. Como el botón se ve siempre, puedes pulsarlo con el campo Instancia vacío, y es entonces cuando aparece el mensaje.

Esquema hecho con código del botón Search, el campo Instance y el mensaje This binding has no Mirakl instance configured.
Esquema hecho con código a partir del código publicado del módulo, no es una captura de Odoo: el botón y el campo, y debajo el mensaje, con los rótulos en inglés del código original (Odoo 17, 18, 19 y 20).

Qué significa: la ventana no tiene ninguna instancia de Mirakl asociada. La búsqueda trabaja a partir de esa instancia, tanto cuando mira entre las categorías ya sincronizadas como cuando consulta a Mirakl, y sin ella la acción se detiene. El campo Instancia se ve en la ventana, pero en solo lectura: no se corrige escribiendo ahí.

El mismo texto puede salir también desde el método de exportación del catálogo del vínculo.

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)

La condición exacta, en palabras

En el código de Odoo 20.0, lo primero que hace la búsqueda es comprobar que trabaja con un único registro y, justo después, mirar si Instancia está vacío. Si lo está, lanza el mensaje y la acción se detiene. Por eso, cuando lo ves:

  • No se ha buscado entre las categorías sincronizadas.
  • No se ha consultado a Mirakl.
  • No se ha guardado nada de lo que la búsqueda iba a escribir en la ventana.

La condición es solo esa: instancia vacía. El mensaje está en el código publicado de 17.0, 18.0, 19.0 y 20.0; la comprobación descrita es la del código de Odoo 20.0.

Esquema hecho con código con el mensaje de falta de instancia en castellano, alemán, francés, italiano y portugués
Esquema hecho con código a partir de las traducciones publicadas del módulo, no es una captura de Odoo.

Con Odoo en castellano ves el texto de arriba; en otros idiomas publicados, estos:

IdiomaTexto
CastellanoEste vínculo no tiene ninguna instancia de Mirakl configurada.
AlemánFür diese Verknüpfung ist keine Mirakl-Instanz konfiguriert.
FrancésCette liaison n'a aucune instance Mirakl configurée.
ItalianoQuesto collegamento non ha alcuna istanza Mirakl configurata.
PortuguésEsta ligação não tem nenhuma instância Mirakl configurada.

Caso: una búsqueda de categoría que no arranca

Ejemplo Caso ilustrativo: la empresa y sus datos son inventados para explicar el flujo.

Imagina a Lucía, responsable de catálogo en Hogar Ribera, una empresa inventada que está preparando su catálogo para un marketplace Mirakl. Abre la ventana de búsqueda de categorías desde un vínculo y pulsa Buscar. En lugar de resultados, Odoo muestra Este vínculo no tiene ninguna instancia de Mirakl configurada. y la ventana queda como estaba.

Se fija en la ventana: Instancia está vacío y es de solo lectura, de modo que no hay nada que escribir ahí. Pulsa Buscar una segunda vez, por si fue algo puntual, y el mensaje es el mismo, porque la condición sigue cumpliéndose.

Lucía entiende entonces qué le está diciendo el mensaje: la búsqueda no ha llegado a empezar, y lo que falta no se arregla desde esa ventana. Cierra la ventana, anota en qué vínculo estaba y pide que revisen la configuración de ese vínculo con quien administra su Odoo o con FlexigoTech.

Qué aprender del caso: el mensaje es una comprobación previa, no el resultado de una búsqueda que no ha encontrado nada, y no se resuelve repitiendo la pulsación.

Qué hacer cuando aparece

  1. Cierra la ventana de búsqueda. De esa pulsación no se ha guardado nada.
  2. Vuelve a abrirla y mira el campo Instancia: si está vacío, esa es la causa.
  3. No intentes rellenarlo en la ventana: el campo es de solo lectura. Mientras siga vacío, Buscar dará el mismo mensaje.
  4. Pide que revisen la configuración del vínculo desde el que abriste la búsqueda, con quien administra tu Odoo o con FlexigoTech.
  5. Cuando Instancia ya no esté vacío, abre la búsqueda de nuevo y pulsa Buscar. Si aparece otro mensaje, es otra causa distinta.

Qué hace la búsqueda cuando sí hay instancia

Pasada la comprobación, el módulo busca primero entre las categorías de Mirakl que ya están sincronizadas con esa instancia. Si encuentra coincidencias, rellena la lista de resultados de la ventana y la vuelve a abrir. Si no encuentra ninguna, consulta a Mirakl a través de la instancia y la ventana se abre de nuevo con los resultados o con un texto que cuenta lo ocurrido.

Esa consulta a Mirakl pasa por FlexigoTech Cloud. Si el servicio no deja pasar la petición (sin suscripción o con una pausa del servicio), la búsqueda se interrumpe y no se marca nada. Es una situación distinta de la de este mensaje.

Versiones y coste

Mirakl Connector está publicado en Odoo Apps para Odoo 17, 18, 19 y 20 (ficha). Es un módulo de pago único por versión y necesita la suscripción a FlexigoTech Cloud, plan Conector: 49 € al mes o 490 € al año, sin IVA (el plan Pro es de 98 € al mes o 980 € al año). Con la suscripción, el módulo para las versiones nuevas de Odoo va incluido si lo compraste en flexigotech.com; en el Odoo App Store, cada versión se compra allí. Sin suscripción, o con el servicio suspendido, se para lo que da la suscripción, y los datos se quedan en tu Odoo. Más detalles en la página del módulo.

Cómo puede ayudarte FlexigoTech

Si estás implantando Odoo y quieres revisar la configuración de Mirakl desde el principio, FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida. Cuéntanos qué te falla y lo miramos contigo.

Sigue leyendo

Mirakl Connector: «Configura la clave de API de Mirakl antes de probar la conexión»Cuándo sale el error de clave de API vacía en Mirakl Connector para Odoo, qué condición lo provoca y cómo resolverlo al pulsar Probar conexión.Qué hace el botón Probar conexión de Mirakl Connector, paso a pasoQué hace el botón Probar conexión de Mirakl Connector en Odoo: cuándo aparece, qué comprueba, qué guarda en la ficha y qué errores puede dar.Qué hace el botón Importar pedidos de Mirakl ConnectorQué hace el botón Importar pedidos de Mirakl Connector: cuándo aparece, qué pasa al pulsarlo, qué avisos da y qué revisar antes y después.
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes