Salta al contingut principal
Mirakl

Com donar d'alta Leroy Merlin o Decathlon al connector de Mirakl

Leroy Merlin i Decathlon venen amb Mirakl, i a Odoo cadascun es dona d'alta com un marketplace més del connector de Mirakl. El que canvia és el perfil de l'operador: amb el mòdul de Leroy Merlin o el de Decathlon instal·lat, tries el perfil a «Provider Code» i Odoo deixa marcades les caselles de comandes i devolucions que necessites, posa l'adreça de l'operador i, en validar un albarà, envia el seguiment a Mirakl sense que hagis de prémer res.

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ó 17.0, 18.0, 19.0 i 20.0
Lectura
4 min

Donar d'alta l'operador

  1. Instal·la el connector de Mirakl i el mòdul de l'operador: «Leroy Merlin for Mirakl» o «Decathlon for Mirakl». Sense aquest mòdul, «Provider Code» només ofereix «Generic Mirakl».
  2. Ves a Mirakl › Configuration › Marketplaces i crea un marketplace nou.
  3. A «Provider Code», tria Leroy Merlin o Decathlon. Odoo omple en aquell moment les caselles del perfil que estiguin desmarcades i els camps buits.
  4. Revisa l'adreça. Per a Leroy Merlin és https://adeo-marketplace.mirakl.net, amb l'API a https://adeo-marketplace.mirakl.net/api; per a Decathlon, marketplace-decathlon-eu.mirakl.net.
  5. Completa la connexió amb les dades del teu compte a l'operador, desa i prem «Test Connection».
Llista de marketplaces de Mirakl a Odoo, un per operador, amb el seu codi de proveïdor i l'última prova de connexió
Un marketplace per operador a Mirakl › Configuration › Marketplaces. En aquesta base de demostració no hi ha instal·lats els mòduls d'operador, així que els tres fan servir «Generic Mirakl». Captura d'Odoo amb dades de demostració.

Si comences amb el perfil genèric i escrius l'adreça de l'operador, Odoo el reconeix pel host: adeo-marketplace o leroymerlin per a Leroy Merlin; marketplace-decathlon, marketplace.decathlon, seller.decathlon, partner.decathlon, .decathlon.net o .decathlon.com per a Decathlon. I si canvies d'un operador a un altre, l'adreça de l'anterior se substitueix per la del nou. Una adreça escrita a mà que no és de cap operador conegut es respecta.

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)

El que deixa marcat el perfil

CasellaPerfil genèricLeroy Merlin i DecathlonPer a què serveix
Sync Orders EnabledDesmarcadaMarcadaLa tasca «Mirakl - Sync Orders» importa les seves comandes cada 10 minuts
Auto Accept OrdersDesmarcadaMarcadaLa tasca «Mirakl - Accept Orders» accepta cada 10 minuts les comandes que Mirakl té esperant la teva acceptació
Accept Pending On ImportDesmarcadaMarcadaIntenta acceptar les comandes en espera just després de cada importació, manual o programada
Auto Confirm SaleDesmarcadaMarcadaConfirma les comandes de venda importades
Sync Returns EnabledDesmarcadaMarcadaLa tasca «Mirakl - Sync Returns» porta les devolucions cada 30 minuts
Returns Fallback To OrdersMarcadaMarcadaSi l'operador no ofereix devolucions per l'API, les crea a partir dels reemborsaments que vénen a les comandes

El perfil només omple el que està buit o desmarcat. Si ja havies posat un valor, es queda. Això afecta «Offer Price Tax Mode»: el perfil porta «Include Sales Taxes», però el camp ja ve amb «As Computed», així que en triar el perfil al formulari no canvia. Decideix tu com dones els preus de les teves ofertes i deixa-ho posat abans d'exportar.

Leroy Merlin: catàleg i ofertes en el format de l'operador

El perfil de Leroy Merlin marca dues caselles més, que de sèrie vénen desmarcades i que el de Decathlon no toca:

  • Exportar el catàleg en el format d'operador. L'ajuda del camp ho diu així: When enabled, catalog export defaults to Mirakl operator-format multipart CSV instead of raw JSON.
  • Exportar les ofertes amb la importació de fitxers OF01 en format d'operador: When enabled, offer export defaults to Mirakl OF01 operator-format multipart file import.

Si exportes des d'un marketplace que no té el perfil de Leroy Merlin, comprova aquestes dues caselles abans de culpar el catàleg.

L'enviament surt en validar l'albarà

Amb aquests dos perfils, validar a Odoo el lliurament d'una comanda de Mirakl basta per avisar el marketplace, encara que la casella «Send Tracking to Mirakl on Validation» estigui desmarcada, que és com ve. Al perfil genèric és aquesta casella la que decideix.

Abans de validar, Odoo actualitza la comanda de venda amb la de Mirakl i posa a l'albarà el contacte de lliurament del comprador. Si a aquest contacte li falta el carrer, la ciutat, el codi postal o el telèfon, torna a demanar la comanda a Mirakl i la refà.

Després, l'enviament va en dos passos. Primer el seguiment (OR23). Si Mirakl encara no dona la comanda per enviada, Odoo la marca com a enviada (OR24). Si l'operador no admet el primer pas, per exemple amb un 404 o perquè no reconeix el codi del transportista, Odoo prova directament el segon. I quan el teu transportista d'Odoo només es tradueix com a OTHER, fa servir el transportista que venia a la comanda de Mirakl.

Albarà validat d'una comanda de Mirakl amb el botó Push Mirakl Tracking i el seguiment en estat Synced
Un albarà validat: el botó «Push Mirakl Tracking», l'estat del seguiment a Synced, l'última petició enviada a Mirakl i, a l'historial, «Mirakl tracking pushed successfully.» Captura d'Odoo amb dades de demostració.

Si l'albarà no porta número de seguiment

No s'envia res. Odoo ho deixa escrit a l'albarà: Shipment not sent to Mirakl: this transfer has no tracking reference. Add the carrier's tracking number to the delivery and click Push Mirakl Tracking to notify the marketplace. Posa el número del transportista i prem «Push Mirakl Tracking», que envia el seguiment a mà.

Si falten les línies de la comanda

Amb aquests dos perfils, l'enviament necessita les línies de la comanda de Mirakl. Si no les troba, ni a la comanda de Mirakl ni a la de venda, s'atura amb Missing Mirakl order lines to push tracking.

Puc tenir Leroy Merlin i Decathlon al mateix Odoo?

Sí. Cada operador és un marketplace diferent a Mirakl › Configuration › Marketplaces, amb el seu perfil, la seva clau i la seva botiga.

I si no vull que les comandes s'acceptin soles?

Desmarca «Auto Accept Orders» i «Accept Pending On Import» després de triar el perfil i desa: el que poses a mà guanya al perfil. Si més endavant tornes a triar el perfil a «Provider Code», les tornarà a marcar.

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ó.Com mapejar categories i atributs de Mirakl a Odoo, pas a pasCom preparar el catàleg d'un marketplace Mirakl a Odoo: diccionari de categories, atributs, llistes de valors, mapatge i exportació, amb els errors típics.Posar en marxa Leroy Merlin Connector a Odoo: preguntes i respostesQuins camps cal omplir a Leroy Merlin Connector per a Odoo, quins estats té el seguiment i què has de revisar la primera setmana després de connectar.
Comprovat al codi del connector (versió 17.0, 18.0, 19.0 i 20.0)

Fonts

  • Codi del mòdul: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (_onchange_provider_code, _apply_provider_defaults_to_record, _should_apply_provider_default), views/menu_views.xml, views/mirakl_instance_views.xml; flexigobe_mirakl_provider_leroy_merlin · 17.0 e4e5b5d · 18.0 01707b8 · 19.0 6e605bb · 20.0 f3f10df y flexigobe_mirakl_provider_decathlon · 17.0 d6944fe · 18.0 8b78e2d · 19.0 c0c6021 · 20.0 80e11d3: models/mirakl_instance.py (_mirakl_provider_default_values)
  • Codi del mòdul: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (cron_sync_orders, cron_accept_orders, cron_sync_returns), data/ir_cron_data.xml
  • Codi del mòdul: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (_mirakl_provider_known_hosts, _onchange_connection_urls, _mirakl_detect_provider_from_urls); proveedores Leroy Merlin y Decathlon (mismos commits que mir.prov.perfil): _mirakl_provider_detection_signatures
  • Codi del mòdul: flexigobe_mirakl_provider_leroy_merlin · 17.0 e4e5b5d · 18.0 01707b8 · 19.0 6e605bb · 20.0 f3f10df: models/mirakl_instance.py; flexigobe_mirakl_provider_decathlon (commits de mir.prov.perfil): models/mirakl_instance.py; flexigobe_mirakl_connector (commits de mir.prov.perfil): models/mirakl_marketplace_profile_mixin.py
  • Codi del mòdul: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/stock_picking.py (button_validate, _mirakl_sync_sale_shipping_contacts, action_mirakl_push_tracking), models/mirakl_instance.py (_mirakl_auto_push_tracking_on_validate), views/stock_picking_views.xml; proveedores Leroy Merlin y Decathlon: _mirakl_auto_push_tracking_on_validate y _mirakl_repair_shipping_before_validate devuelven True
  • Codi del mòdul: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (push de seguimiento con _mirakl_supports_advanced_tracking_flow)