Salta al contingut principal
Mirakl

Importar missatges a Mirakl Connector: què fa el botó pas a pas

El botó Import Messages demana al marketplace els missatges de la instància, els processa i t'ho explica amb un avís d'èxit o d'advertència. Es veu sempre a la pantalla Mirakl Instances, i la tasca programada fa una importació semblant cada 30 minuts si l'actives.

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
5 min

Què és el botó i quan el veus

El botó Import Messages és a la pantalla Mirakl Instances, que s'obre des del menú Mirakl › Configuration › Marketplaces. Es veu sempre, a Odoo 17, 18, 19 i 20: cap condició de la vista l'amaga. Treballa sobre la instància que tens oberta.

Esquema fet amb codi del menú Mirakl › Configuration › Marketplaces i del botó Import Messages, amb els rètols en anglès
Esquema fet amb codi (no és una captura d'Odoo): el menú i el botó, amb els rètols en anglès del text original del mòdul. El botó és a les quatre versions publicades.

El rètol del botó canvia segons l'idioma del teu Odoo: amb Odoo en castellà és Importar mensajes; en alemany, Nachrichten importieren; en francès, Importer les messages; en italià, Importa messaggi; en portuguès, Importar Mensagens.

Esquema fet amb codi a partir dels fitxers de traducció del mòdul, amb el rètol del botó en castellà, alemany, francès, italià i portuguès
Esquema fet amb codi (no és una captura d'Odoo): el rètol del botó Import Messages segons l'idioma d'Odoo.

Si encara no has comprovat que la connexió amb el marketplace funciona, l'article sobre el botó Provar connexió explica què fa aquest altre botó.

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)

Pas a pas

  1. Deixa que ho faci Odoo sol. La tasca programada Mirakl - Sync Messages llança la importació de missatges cada 30 minuts, però ve desactivada en instal·lar. Recorre les instàncies actives que tenen la sincronització de missatges activada, i només un administrador pot executar-la. Aquest és el camí normal; el botó serveix per llançar la importació a mà.
  2. Obre la instància. Entra a Mirakl › Configuration › Marketplaces i obre la fitxa de la instància.
  3. Revisa la finestra de dies. A la pestanya Invoices and Messages, grup Messages, hi ha Initial Message Sync Days. La seva ajuda diu: «Historical window (days) for manual message sync.» El valor per defecte és 30. El botó passa aquest valor a la importació.
  4. Prem Import Messages. El mòdul consulta el marketplace (detall a la secció següent) i, quan acaba, deixa un avís.
  5. Llegeix l'avís. Amb missatges processats veuràs una notificació d'èxit: Import Messages completed: … messages processed. (en lloc dels punts suspensius, la quantitat). Si no se n'ha processat cap, una d'advertència: Import Messages completed: 0 records. The operator may not support this endpoint.
  6. Si surt l'advertència, mira el camp de només lectura. A la mateixa pestanya i grup, Messages Endpoint Unavailable t'indica si el mòdul ha marcat que el marketplace no exposa /messages.

Què fa el botó per dins, en ordre

  • Passa per sobre del camp Messages Endpoint Unavailable. Amb el botó, el mòdul fa la consulta encara que aquest camp estigui marcat. La tasca programada, en canvi, se salta l'endpoint fins que es reintenti a mà, com diu l'ajuda del camp.
  • Llegeix per pàgines. Demana els missatges amb una petició de lectura a l'endpoint /messages (o al que tingui indicat la instància), pàgina a pàgina, amb un topall de pàgines que fixa la mateixa instància.
  • Processa cada missatge. Cada missatge rebut passa pel model de missatges de Mirakl, i el mòdul en suma un per cada registre que en resulta. Aquest compte és el que veus a l'avís.
  • Neteja la marca si la lectura surt bé. Si una petició té èxit i Messages Endpoint Unavailable estava marcat, el mòdul el buida. Per això prémer el botó és la manera de reintentar.
  • Deixa constància i avisa. Publica el mateix text de l'avís com a missatge a la mateixa instància i mostra una notificació amb el títol Mirakl. No és un avís fix en pantalla.

Errors i avisos que pot donar

El botó no mostra els errors de lectura com un missatge d'error: els anota al log de l'API de Mirakl i acaba amb l'avís de «0 registres» si no s'ha processat res. Per això aquesta advertència no prova per si sola que alguna cosa falli: també surt si el marketplace no tenia missatges per retornar.

SituacióQuè passaQuè fer
Es processen missatgesAvís d'èxit amb la quantitatRes: comprova els missatges importats
El marketplace respon 410 o 404El mòdul marca Messages Endpoint Unavailable, anota un avís al log i para; l'avís en pantalla explica el que s'ha processat fins aquell momentSi és 0, l'operador pot no exposar /messages; revisa el camp i torna a prémer només si alguna cosa ha canviat
Un altre error de la peticióS'anota un error al log i es deixa de llegir; es compta el que ja s'ha processatRevisa el log de l'API i torna a prémer
Resposta amb una forma que el connector no reconeixNo es pren per una pàgina buida: s'anota un error i es deixa de llegirGuarda el contingut anotat al log i consulta-ho amb FlexigoTech
FlexigoTech Cloud no deixa passar la crida (sense subscripció o pausa del servei)La importació es talla, no es marca res i no s'arriba a l'avís de completatRevisa la teva subscripció al pla Connector

Botó o tasca programada

Botó Import MessagesTasca Mirakl - Sync Messages
Quan correQuan el premsCada 30 minuts, si l'actives (ve desactivada)
Amb l'endpoint marcat com a no disponibleConsulta igualmentL'omet fins que es reintenti a mà

Què necessites i com t'ajuda FlexigoTech

Mirakl Connector és un mòdul de pagament únic per versió, publicat a Odoo Apps per a 17, 18, 19 i 20 (fitxa, pàgina del mòdul), i necessita la subscripció a FlexigoTech Cloud amb el pla Connector: 49 €/mes o 490 €/any sense IVA, fins a 3 comptes de la plataforma. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció; les dades es queden al teu Odoo.

Si estàs implantant Odoo i vols que el connector quedi a punt amb els teus marketplaces, FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida.

Continua llegint

Mirakl Connector: «Set the Mirakl API key before testing the connection»Quan surt l'error de clau d'API buida a Mirakl Connector per a Odoo, quina condició el provoca i com resoldre'l en prémer Test Connection.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.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts