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, pestanyaCarriers, grupCarrier 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.

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.

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 Carriersi 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 deEndpoint Shipping Carriersi 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 ambEndpoint 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'Odoo | Rètol del botó |
|---|---|
| Castellà | Fetch Mirakl Carriers |
| Alemany | Mirakl-Versanddienstleister abrufen |
| Francès | Récupérer les transporteurs Mirakl |
| Italià | Recupera corrieri Mirakl |
| Portuguès | Obter Transportadoras Mirakl |

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
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): views/mirakl_instance_views.xml
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
