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.

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.

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.

Con Odoo en castellano ves el texto de arriba; en otros idiomas publicados, estos:
| Idioma | Texto |
|---|---|
| Castellano | Este vínculo no tiene ninguna instancia de Mirakl configurada. |
| Alemán | Für diese Verknüpfung ist keine Mirakl-Instanz konfiguriert. |
| Francés | Cette liaison n'a aucune instance Mirakl configurée. |
| Italiano | Questo collegamento non ha alcuna istanza Mirakl configurata. |
| Portugués | Esta 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
- Cierra la ventana de búsqueda. De esa pulsación no se ha guardado nada.
- Vuelve a abrirla y mira el campo
Instancia: si está vacío, esa es la causa. - No intentes rellenarlo en la ventana: el campo es de solo lectura. Mientras siga vacío,
Buscardará el mismo mensaje. - Pide que revisen la configuración del vínculo desde el que abriste la búsqueda, con quien administra tu Odoo o con FlexigoTech.
- Cuando
Instanciaya no esté vacío, abre la búsqueda de nuevo y pulsaBuscar. 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
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas
Fuentes
- Código del módulo: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_category_search_wizard.py
- Código del módulo: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_catalog_binding_mixin.py
- Código del módulo: flexigobe_mirakl_connector 20.0 (aa05e537): views/mirakl_category_search_wizard_views.xml
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/en/services.html
- flexigotech.com/precios.html
