Salta al contingut principal
Mirakl

Botó «Fetch Mirakl Carriers»: què fa i quins errors dona

El botó Fetch Mirakl Carriers demana a Mirakl la llista de transportistes de la teva instància, la processa i deixa el resultat al chatter. Es veu sempre a la pantalla Mirakl Instances. Si la resposta porta almenys un transportista, mostra un avís en pantalla i publica la llista completa al chatter; si no hi ha transportistes o cap endpoint respon, publica el motiu al chatter i mostra un avís d'advertència; si la petició falla amb un altre error, s'atura amb un missatge d'error.

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

Abans de prémer: on és i què mirar

Les fitxes d'instància s'obren des del menú Mirakl › Configuration › Marketplaces. El botó Fetch Mirakl Carriers és a la pantalla Mirakl Instances i no depèn de cap condició de la vista: es veu sempre, a Odoo 17, 18, 19 i 20.

  • Obre la fitxa de la instància des de Mirakl › Configuration › Marketplaces. El botó treballa sobre una sola instància, la que tens oberta.
  • Comprova que el teu Odoo és de la versió 17, 18, 19 o 20: el mòdul està publicat a Odoo Apps per a aquestes quatre i el botó hi és en totes.
  • Revisa el camp Endpoint Shipping Carriers, a la fitxa, pestanya Carriers, grup Carrier Sync. La seva ajuda diu: «Mirakl SH21 endpoint used to retrieve available shipping carriers when supported by the operator.» El valor per defecte que porta el codi és /shipping/carriers.
  • Confirma que la subscripció a FlexigoTech Cloud està activa. La connexió passa per aquest servei i, sense subscripció o amb el servei suspès, s'atura el que dona la subscripció; les dades es queden al teu Odoo.
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)

Què fa el botó en prémer-lo, per ordre

  • Consulta Mirakl: llança una petició de lectura (GET) a un endpoint de transportistes. Si hi ha diversos endpoints candidats, els prova un darrere l'altre.
  • Si un endpoint respon amb un error 404, passa al següent candidat.
  • Si l'error és d'un altre tipus, l'acció s'atura amb Could not fetch carriers from Mirakl: …, on els punts suspensius són l'error rebut. Com que l'acció s'atura, no es desa el que havia de canviar i no es mostra cap avís.
  • Si FlexigoTech Cloud no deixa passar la petició (sense subscripció o amb el servei en pausa), l'acció s'atura i no es marca res.
  • Si cap endpoint retorna una resposta, publica al chatter i en un avís d'advertència This operator does not expose generic Mirakl carriers via SH21. Tried: ….. Els punts suspensius són els endpoints provats.
  • Si l'endpoint que ha respost és diferent del que hi havia a Endpoint Shipping Carriers, el mòdul escriu en aquest camp el que ha respost.
  • Llegeix la resposta. Si no pot interpretar-la com una llista de transportistes, l'acció s'atura amb Unexpected response format from Mirakl carriers endpoint.
  • Processa la llista i n'obté dues dades: quants transportistes hi ha i quantes assignacions de transportista s'han actualitzat.
  • Si, després de processar la resposta, no hi ha cap transportista, publica al chatter i en un avís d'advertència The operator responded to … but returned no carriers. Carrier mapping remains optional for this instance. El buit és l'endpoint que ha respost.
Esquema fet amb codi, no una pantalla d'Odoo: el menú de Marketplaces, el botó d'obtenir transportistes de Mirakl a Odoo 17, 18, 19 i 20, i a un costat els missatges que el poden aturar
Esquema fet amb codi a partir del codi publicat del mòdul: menú, botó i dos dels missatges que poden sortir en prémer-lo.

Què has de veure quan va bé

L'avís d'èxit només surt quan, després de processar la resposta, hi ha almenys un transportista.

  • Un avís en pantalla amb el títol Mirakl Carriers i el text … carriers available from …. … map(s) updated. See chatter for full list. Els buits són, per ordre, el nombre de transportistes, l'endpoint que ha respost i el nombre d'assignacions actualitzades. L'avís no queda fix en pantalla.
  • Obre el chatter de la instància: el mòdul hi publica un missatge amb l'endpoint, quants transportistes hi ha disponibles, la llista amb el codi de cadascun i el seu nom entre parèntesis, i quantes assignacions de transportista s'han actualitzat.
  • Torna a mirar Endpoint Shipping Carriers: si va respondre un endpoint diferent del configurat, el camp ja té el valor del que va respondre.

Quan no va bé: què revisar en cada cas

  • Could not fetch carriers from Mirakl: … surt en prémer el botó quan una petició falla amb un error que no és un 404. Què fer: llegeix el detall que va després dels dos punts, que és l'error rebut. Si dubtes de la connexió amb Mirakl, mira què fa el botó Provar connexió.
  • Unexpected response format from Mirakl carriers endpoint. surt en prémer el botó quan la resposta arriba, però el mòdul no la pot llegir com a llista de transportistes. Què fer: revisa el valor de Endpoint Shipping Carriers i recorda el que diu la seva ajuda, que és l'endpoint SH21 per obtenir els transportistes d'enviament quan l'operador ho admet.
  • This operator does not expose generic Mirakl carriers via SH21. Tried: …. apareix al chatter i en un avís d'advertència quan cap endpoint retorna una resposta. Què fer: mira quins endpoints figuren després de «Tried:» i compara'ls amb Endpoint Shipping Carriers.
  • The operator responded to … but returned no carriers. Carrier mapping remains optional for this instance. apareix al chatter i en un avís d'advertència quan no queda cap transportista després de processar la resposta. Què fer: el mateix text diu que l'assignació de transportistes continua sent opcional per a aquesta instància.
  • Si FlexigoTech Cloud no deixa passar la petició (sense subscripció o amb el servei en pausa), l'acció s'atura i no es marca res: comprova que la subscripció està activa.

El rètol del botó en cada idioma

Idioma d'OdooRètol del botó
CastellàFetch Mirakl Carriers
AlemanyMirakl-Versanddienstleister abrufen
FrancèsRécupérer les transporteurs Mirakl
ItaliàRecupera corrieri Mirakl
PortuguèsObter Transportadoras Mirakl
Esquema fet amb codi, no una pantalla d'Odoo: el rètol del botó en castellà, alemany, francès, italià i portuguès
Esquema fet amb codi a partir de les traduccions publicades del mòdul: com es diu el botó segons l'idioma d'Odoo.

Què necessites i com t'ajuda FlexigoTech

Mirakl Connector és un mòdul de pagament únic per versió i necessita la subscripció a FlexigoTech Cloud: pla Connector, 49 € al mes o 490 € a l'any sense IVA, amb fins a 3 comptes de la plataforma. El preu de cada versió d'Odoo és a la fitxa d'Odoo Apps.

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Si vols que revisem la teva instància de Mirakl, tens la pàgina del mòdul.

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