Saltar al contenido principal
Mirakl

Mirakl Connector: «Configura la clave de API de Mirakl antes de probar la conexión»

Sale al pulsar Probar conexión cuando la instancia de Mirakl no se conecta por FlexigoTech Cloud y su clave de API está vacía o con solo espacios. Se resuelve dejando guardada la clave que Mirakl te da en tu cuenta de vendedor (Ajustes > Clave de API) y volviendo a probar.

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

Cuándo sale y qué dice

¿Qué mensaje ves y cuándo aparece?

Con Odoo en castellano ves Configura la clave de API de Mirakl antes de probar la conexión. La encontrarás en tu cuenta de vendedor de Mirakl (Ajustes > Clave de API). (Set the Mirakl API key before testing the connection. You will find it in your Mirakl seller account (Settings > API key).) Aparece al pulsar Probar conexión (Test Connection) en la ficha de Instancias de Mirakl (Mirakl Instances), que abres desde Mirakl › Configuración › Marketplaces (Mirakl › Configuration › Marketplaces). El botón se ve siempre en Odoo 17, 18, 19 y 20.

Esquema con el menú Mirakl, Configuración, Marketplaces, el botón Probar conexión, el campo Conexión con Mirakl y el mensaje de la clave de API, con los rótulos en inglés
Esquema hecho con código a partir del código publicado del módulo, no es una captura de Odoo: menú, botón, campo y mensaje, con los rótulos en inglés del código.

¿Qué pasa con la acción cuando sale?

Se detiene. Es un error que corta lo que ibas a hacer con el botón: la prueba de conexión no sigue adelante.

¿Cuál es la condición exacta?

El módulo comprueba dos cosas a la vez, y el mensaje solo sale si se cumplen las dos. La primera: que el campo Conexión con Mirakl (Mirakl connection) no tenga el valor FlexigoTech Cloud, es decir, que sea Directa (clave API guardada en Odoo) (Direct (API key stored in Odoo)). La segunda: que la clave de API guardada en esa instancia esté vacía. Antes de mirar si está vacía, el código le quita los espacios de los extremos, así que una clave escrita solo con espacios cuenta como vacía. Esta es la condición del código de Odoo 20.

¿Por qué no me sale en un marketplace conectado por FlexigoTech Cloud?

Porque con esa conexión la comprobación no se hace en Odoo. Según el código, la clave vive en el relé de FlexigoTech Cloud y no aquí, y es ese relé quien avisa si falta. La ayuda del campo Conexión con Mirakl dice que los marketplaces nuevos se conectan a través de FlexigoTech Cloud y que la conexión directa solo se mantiene para los marketplaces que ya existían antes de esta versión, que siguen funcionando tal como se compraron. El valor por defecto del campo en el código es FlexigoTech Cloud.

¿Cómo compruebo qué conexión tiene mi marketplace?

Abre la ficha del marketplace, ve a la pestaña Conexión (Connection) y mira el grupo Acceso (Access): ahí está Conexión con Mirakl, en solo lectura, de modo que no se cambia desde esa pantalla. Si pone Directa (clave API guardada en Odoo), ese marketplace es de los que pueden dar este mensaje. Si pone FlexigoTech Cloud, la condición no se cumple y el mensaje no sale en esa instancia.

Esquema con el texto del mensaje tal como lo ve el usuario según el idioma de su Odoo: 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: el mismo mensaje en castellano, alemán, francés, italiano y portugués.
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)

Cómo resolverlo

¿Qué hago para que desaparezca?

Entra en tu cuenta de vendedor de Mirakl y copia la clave que aparece en Ajustes > Clave de API, que es justo donde te manda el propio mensaje. Déjala guardada en la instancia de Odoo que estás probando y pulsa de nuevo Probar conexión. La condición del código es que esa clave no esté vacía: cuando ya no se cumple, el mensaje no vuelve a salir.

¿Y si creo que ya la he guardado?

Hay dos cosas que mirar. La primera: que estés en la ficha del marketplace que estás probando, porque la comprobación se hace sobre la clave de esa instancia y no sobre la de otro marketplace. La segunda: que lo que guardaste no sean solo espacios, porque cuenta como vacío. Con FlexigoTech Cloud en Conexión con Mirakl, este mensaje no puede venir de la clave de esa instancia.

¿Que el mensaje desaparezca significa que la clave funciona?

No. Esta comprobación solo mira si hay algo escrito en la clave, no si es correcta. Es la primera comprobación de la configuración: si la pasas, el módulo comprueba después las URL del operador de Mirakl. Cómo es el botón de principio a fin lo cuenta Qué hace el botón Probar conexión.

¿Tengo algo que hacer si mi marketplace se conecta por FlexigoTech Cloud?

Para este mensaje, no: con esa conexión el módulo no mira la clave en Odoo, y es el relé de FlexigoTech Cloud quien avisa si falta. Por eso, si te sale, comprueba primero en la pestaña Conexión, grupo Acceso, que Conexión con Mirakl ponga Directa (clave API guardada en Odoo).

Versiones y ayuda

¿Es igual en Odoo 17, 18, 19 y 20?

El mensaje está en el código publicado de las cuatro ramas, y el botón Probar conexión se ve siempre en todas. El módulo está publicado en Odoo Apps para esas cuatro versiones (ficha en Odoo Apps). La condición que has leído arriba es la del código de Odoo 20.

¿Dónde se ve cada cosa, de un vistazo?

El menú es Mirakl › Configuración › Marketplaces. El botón Probar conexión está en la ficha de Instancias de Mirakl. El campo Conexión con Mirakl está en la pestaña Conexión, grupo Acceso, en solo lectura. Si no ves el tramo Mirakl del menú, te falta el permiso que ese tramo pide.

Cómo ayuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida. Para los marketplaces que se conectan a través de FlexigoTech Cloud, el servicio guarda cifradas las credenciales, vigila la sincronización y avisa por correo si falla. Si estás montando el conector y quieres que revisemos la configuración contigo, tienes la página del módulo.

Sigue leyendo

Mirakl Connector: «Este vínculo no tiene ninguna instancia de Mirakl configurada.»Cuándo sale en Mirakl Connector el aviso de vínculo sin instancia de Mirakl configurada, qué condición lo provoca y qué hacer cuando aparece.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