Salta al contingut principal
Mirakl

Com mapejar categories i atributs de Mirakl a Odoo, pas a pas

Per publicar productes en un marketplace Mirakl des d'Odoo has de dir al connector a quina categoria de l'operador correspon cada producte i amb quins valors omple els seus atributs obligatoris. Es fa al menú Catalog en aquest ordre: diccionari, categories, atributs i llistes de valors, mapatge, exportació i revisió de la validació.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 3 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
3 min

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

  1. Dona d'alta el marketplace a Mirakl › Configuration › Marketplaces amb la seva URL d'API i la seva clau.
  2. 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.
  3. Revisa a Catalog › Attributes quins atributs són obligatoris a les categories que faràs servir.
  4. 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.
  5. A Catalog › Category Mapping assigna a cada categoria dels teus productes la categoria de l'operador.
  6. Si envies tu, a Catalog › Carrier Mapping relaciona els teus transportistes amb els del marketplace.
  7. Exporta el catàleg. La tasca s'executa cada 30 minuts i també la pots llançar a mà.
  8. Mira l'estat de l'última exportació i de la validació de cada producte abans d'exportar ofertes.
Arbre de categories d'un operador Mirakl descarregat a Odoo
Les categories de l'operador, tal com les descarrega el connector. Captura d'Odoo amb dades de Leroy Merlin descarregades pel connector.
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)

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.

Llista d'atributs d'un operador Mirakl amb el seu tipus i si són obligatoris
Atributs de l'operador: tipus de dada i si són obligatoris. Captura d'Odoo amb dades de Leroy Merlin descarregades pel connector.

Errors típics i com arreglar-los

MissatgeQuè vol dirQuè 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.
Mapatge entre categories d'Odoo i categories de l'operador Mirakl
El mapatge de categories: a l'esquerra les teves, a la dreta les de l'operador. Captura d'Odoo amb dades de Leroy Merlin descarregades pel connector.

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

Una comanda de Mirakl a Odoo, de la compra al cobramentCronologia d'una comanda d'un marketplace Mirakl dins d'Odoo 17, 18, 19 i 20: acceptació, enviament, seguiment, devolució, factura i liquidació.Exemple: un fabricant que ven en diversos marketplaces Mirakl amb fulls de càlculCas d'exemple d'un fabricant que ven en diversos marketplaces Mirakl amb fulls de càlcul i què canvia quan ho porta tot a Odoo amb el connector.
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