Cada operador de Mirakl té el seu propi arbre de categories i els seus atributs. El que Leroy Merlin anomena d'una manera, Decathlon ho demana d'una altra. El connector, publicat per a Odoo 17, 18, 19 i 20, descarrega aquest diccionari i et deixa aparellar el teu catàleg amb ell una sola vegada.
Els passos
- Dona d'alta el marketplace a Mirakl › Configuration › Marketplaces amb la seva URL d'API i la seva clau.
- Espera la primera sincronització del diccionari de catàleg. La tasca es repeteix cada 60 minuts i deixa les categories de l'operador a Mirakl › Catalog › Categories.
- Revisa a Catalog › Attributes quins atributs són obligatoris a les categories que faràs servir.
- Obre Catalog › Value Lists per als atributs que només admeten valors tancats, com colors o materials. El teu valor d'Odoo ha de coincidir amb un de la llista.
- A Catalog › Category Mapping assigna a cada categoria dels teus productes la categoria de l'operador.
- Si envies tu, a Catalog › Carrier Mapping relaciona els teus transportistes amb els del marketplace.
- Exporta el catàleg. La tasca s'executa cada 30 minuts i també la pots llançar a mà.
- Mira l'estat de l'última exportació i de la validació de cada producte abans d'exportar ofertes.


Els estats que has de llegir
Cada exportació de catàleg deixa un estat: pendent, correcte, error o desconegut. Cada producte té a més el seu estat de validació: sense comprovar, correcte, avís o error. Un avís deixa publicar, però sol voler dir un atribut opcional buit que l'operador fa servir per filtrar. Val la pena omplir-lo.
Amb les ofertes passa el mateix. L'última exportació d'ofertes mostra el seu resultat i cada oferta porta el codi d'estat de Mirakl: 11 per a activa i 12 per a inactiva.

Errors típics i com arreglar-los
| Missatge | Què vol dir | Què cal fer |
|---|---|---|
Catalog validation failed: … | L'operador ha rebutjat un o diversos productes. El que segueix als dos punts diu quin i per què. | Corregeix l'atribut que indica i exporta de nou. |
No catalog import id found yet. Export catalog first. | Demanes el resultat d'una importació que encara no existeix. | Exporta el catàleg i espera que Mirakl torni el número d'importació. |
No import id found yet. Export the offer first. | El mateix, amb les ofertes. | Exporta l'oferta abans de consultar-ne el resultat. |
Selected category does not belong to this wizard. | A l'assistent has triat una categoria d'un altre marketplace. | Torna a obrir-lo des del marketplace correcte. |

Quan exportar ofertes
Només quan el producte està validat. Les ofertes s'exporten cada 5 minuts, però una oferta d'un producte que l'operador no ha acceptat es queda inactiva encara que tingui preu i estoc. Si a la llista d'ofertes en veus moltes d'inactives, el problema gairebé sempre és un pas abans, al catàleg.
Quan afegeixis un operador nou, repeteix el mapatge només per a les seves categories: el que ja vas mapejar per a un altre marketplace no es perd, perquè cada operador guarda el seu.
Els registres de Configuration › Logs guarden cada crida a Mirakl. Si un error no s'entén a la pantalla, hi tens la resposta completa de l'operador.
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 (83e54909): views/menu_views.xml
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): data/ir_cron_data.xml
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_catalog_binding_mixin.py
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_offer_binding_mixin.py
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_product_binding.py
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_category_search_wizard.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
