Salta al contingut principal
Mirakl

Mirakl Connector: «Set the Mirakl API key before testing the connection»

Surt en prémer Test Connection quan la instància de Mirakl no es connecta per FlexigoTech Cloud i la seva clau d'API és buida o només té espais. Es resol deixant desada la clau que Mirakl et dona al teu compte de venedor (Ajustes > Clave de API) i tornant a provar.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 5 de novembre de 2026

L'essencial

Mòdul
Mirakl
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
4 min

Quan surt i què diu

Quin missatge veus i quan apareix?

Amb Odoo en català veus Set the Mirakl API key before testing the connection. You will find it in your Mirakl seller account (Settings > API key). Apareix en prémer Test Connection a la fitxa de Mirakl Instances, que obres des de Mirakl › Configuration › Marketplaces. El botó es veu sempre a Odoo 17, 18, 19 i 20.

Esquema amb el menú Mirakl, Configuració, Marketplaces, el botó Test Connection, el camp Mirakl connection i el missatge de la clau d'API, amb les etiquetes en anglès
Esquema fet amb codi a partir del codi publicat del mòdul, no és una captura d'Odoo: menú, botó, camp i missatge, amb les etiquetes en anglès del codi.

Què passa amb l'acció quan surt?

S'atura. És un error que talla el que anaves a fer amb el botó: la prova de connexió no continua.

Quina és la condició exacta?

El mòdul comprova dues coses alhora, i el missatge només surt si es compleixen les dues. La primera: que el camp Mirakl connection no tingui el valor FlexigoTech Cloud, és a dir, que sigui Direct (API key stored in Odoo). La segona: que la clau d'API desada en aquesta instància sigui buida. Abans de mirar si és buida, el codi li treu els espais dels extrems, de manera que una clau escrita només amb espais compta com a buida. Aquesta és la condició del codi d'Odoo 20.

Per què no em surt en un marketplace connectat per FlexigoTech Cloud?

Perquè amb aquesta connexió la comprovació no es fa a Odoo. Segons el codi, la clau viu al relé de FlexigoTech Cloud i no aquí, i és aquest relé qui avisa si falta. L'ajuda del camp Mirakl connection diu que els marketplaces nous es connecten a través de FlexigoTech Cloud i que la connexió directa només es manté per als marketplaces que ja existien abans d'aquesta versió, que continuen funcionant tal com es van comprar. El valor per defecte del camp al codi és FlexigoTech Cloud.

Com comprovo quina connexió té el meu marketplace?

Obre la fitxa del marketplace, ves a la pestanya Connection i mira el grup Access: allà hi ha Mirakl connection, en només lectura, de manera que no es canvia des d'aquesta pantalla. Si posa Direct (API key stored in Odoo), aquest marketplace és dels que poden donar aquest missatge. Si posa FlexigoTech Cloud, la condició no es compleix i el missatge no surt en aquesta instància.

Esquema amb el text del missatge tal com el veu l'usuari segons l'idioma del seu Odoo: castellà, alemany, francès, italià i portuguès
Esquema fet amb codi a partir de les traduccions publicades del mòdul, no és una captura d'Odoo: el mateix missatge en castellà, alemany, francès, italià i 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 anglès)

Com resoldre'l

Què faig perquè desaparegui?

Entra al teu compte de venedor de Mirakl i copia la clau que apareix a Ajustes > Clave de API, que és just on t'envia el propi missatge. Deixa-la desada a la instància d'Odoo que estàs provant i prem de nou Test Connection. La condició del codi és que aquesta clau no sigui buida: quan ja no es compleix, el missatge no torna a sortir.

I si crec que ja l'he desat?

Hi ha dues coses a mirar. La primera: que siguis a la fitxa del marketplace que estàs provant, perquè la comprovació es fa sobre la clau d'aquesta instància i no sobre la d'un altre marketplace. La segona: que el que vas desar no siguin només espais, perquè compta com a buit. Amb FlexigoTech Cloud a Mirakl connection, aquest missatge no pot venir de la clau d'aquesta instància.

Que el missatge desaparegui vol dir que la clau funciona?

No. Aquesta comprovació només mira si hi ha alguna cosa escrita a la clau, no si és correcta. És la primera comprovació de la configuració: si la superes, el mòdul comprova després les URL de l'operador de Mirakl. Com és el botó de principi a fi ho explica Què fa el botó Test Connection.

Tinc alguna cosa a fer si el meu marketplace es connecta per FlexigoTech Cloud?

Per a aquest missatge, no: amb aquesta connexió el mòdul no mira la clau a Odoo, i és el relé de FlexigoTech Cloud qui avisa si falta. Per això, si et surt, comprova primer a la pestanya Connection, grup Access, que Mirakl connection posi Direct (API key stored in Odoo).

Versions i ajuda

És igual a Odoo 17, 18, 19 i 20?

El missatge és al codi publicat de les quatre branques, i el botó Test Connection es veu sempre a totes. El mòdul està publicat a Odoo Apps per a aquestes quatre versions (fitxa a Odoo Apps). La condició que has llegit més amunt és la del codi d'Odoo 20.

On es veu cada cosa, d'una ullada?

El menú és Mirakl › Configuration › Marketplaces. El botó Test Connection és a la fitxa de Mirakl Instances. El camp Mirakl connection és a la pestanya Connection, grup Access, en només lectura. Si no veus el tram Mirakl del menú, et falta el permís que aquest tram demana.

Com ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Per als marketplaces que es connecten a través de FlexigoTech Cloud, el servei desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. Si estàs muntant el connector i vols que revisem la configuració amb tu, tens la pàgina del mòdul.

Continua llegint

Mirakl Connector: «This binding has no Mirakl instance configured.»Quan surt a Mirakl Connector l'avís de vincle sense instància de Mirakl configurada, quina condició el provoca i què fer quan apareix.Què fa el botó Test Connection de Mirakl Connector, pas a pasQuè fa el botó Test Connection de Mirakl Connector a Odoo: quan apareix, què comprova, què desa a la fitxa i quins errors pot donar.Què fa el botó Import Orders de Mirakl ConnectorQuè fa el botó Import Orders de Mirakl Connector: quan apareix, què passa en prémer-lo, quins avisos dona i què revisar abans i després.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts