Vai al contenuto principale
Mirakl

Come configurare Leroy Merlin o Decathlon nel connettore Mirakl

Leroy Merlin e Decathlon vendono tramite Mirakl, e in Odoo ciascuno si configura come un marketplace in più del connettore Mirakl. Ciò che cambia è il profilo dell'operatore: con il modulo di Leroy Merlin o quello di Decathlon installato, scegli il profilo in «Provider Code» e Odoo spunta le caselle degli ordini e dei resi di cui hai bisogno, compila l'indirizzo dell'operatore e, alla validazione di un prelievo, invia il tracciamento a Mirakl senza che tu debba premere nulla.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 5 novembre 2026

In breve

Modulo
Mirakl
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 17.0, 18.0, 19.0 e 20.0
Lettura
4 min

Configurare l'operatore

  1. Installa il connettore Mirakl e il modulo dell'operatore: «Leroy Merlin for Mirakl» o «Decathlon for Mirakl». Senza quel modulo, «Provider Code» offre solo «Generic Mirakl».
  2. Vai su Mirakl › Configuration › Marketplaces e crea un nuovo marketplace.
  3. In «Provider Code» scegli Leroy Merlin o Decathlon. Odoo compila in quel momento le caselle del profilo che sono deselezionate e i campi vuoti.
  4. Controlla l'indirizzo. Per Leroy Merlin è https://adeo-marketplace.mirakl.net, con l'API su https://adeo-marketplace.mirakl.net/api; per Decathlon, marketplace-decathlon-eu.mirakl.net.
  5. Completa la connessione con i dati del tuo account presso l'operatore, salva e premi «Test Connection».
Elenco dei marketplace Mirakl in Odoo, uno per operatore, con il relativo codice fornitore e l'ultimo test di connessione
Un marketplace per operatore in Mirakl › Configuration › Marketplaces. In questo database dimostrativo non sono installati i moduli degli operatori, quindi tutti e tre usano «Generic Mirakl». Schermata di Odoo con dati dimostrativi.

Se parti dal profilo generico e digiti l'indirizzo dell'operatore, Odoo lo riconosce dall'host: adeo-marketplace o leroymerlin per Leroy Merlin; marketplace-decathlon, marketplace.decathlon, seller.decathlon, partner.decathlon, .decathlon.net o .decathlon.com per Decathlon. E se passi da un operatore a un altro, l'indirizzo del precedente viene sostituito con quello del nuovo. Un indirizzo digitato a mano che non appartiene a nessun operatore noto viene rispettato.

Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in inglese)

Cosa spunta il profilo

CasellaProfilo genericoLeroy Merlin e DecathlonA cosa serve
Sync Orders EnabledDeselezionataSelezionataL'azione pianificata «Mirakl - Sync Orders» importa i suoi ordini ogni 10 minuti
Auto Accept OrdersDeselezionataSelezionataL'azione pianificata «Mirakl - Accept Orders» accetta ogni 10 minuti gli ordini che Mirakl tiene in attesa della tua accettazione
Accept Pending On ImportDeselezionataSelezionataTenta di accettare gli ordini in attesa subito dopo ogni importazione, manuale o programmata
Auto Confirm SaleDeselezionataSelezionataConferma gli ordini di vendita importati
Sync Returns EnabledDeselezionataSelezionataL'azione pianificata «Mirakl - Sync Returns» recupera i resi ogni 30 minuti
Returns Fallback To OrdersSelezionataSelezionataSe l'operatore non offre resi tramite API, li crea a partire dai rimborsi presenti negli ordini

Il profilo compila solo ciò che è vuoto o deselezionato. Un valore che avevi già impostato resta. Questo conta per «Offer Price Tax Mode»: il profilo prevede «Include Sales Taxes», ma il campo arriva già impostato su «As Computed», quindi scegliere il profilo nel modulo non lo cambia. Decidi tu come esporre i prezzi delle tue offerte e impostalo prima di esportare.

Leroy Merlin: catalogo e offerte nel formato dell'operatore

Il profilo di Leroy Merlin spunta altre due caselle, che di default sono deselezionate e che il profilo di Decathlon non tocca:

  • Esportare il catalogo nel formato dell'operatore. L'aiuto del campo lo dice così: When enabled, catalog export defaults to Mirakl operator-format multipart CSV instead of raw JSON.
  • Esportare le offerte con l'importazione di file OF01 nel formato dell'operatore: When enabled, offer export defaults to Mirakl OF01 operator-format multipart file import.

Se esporti da un marketplace che non ha il profilo di Leroy Merlin, controlla queste due caselle prima di dare la colpa al catalogo.

La spedizione parte alla validazione del prelievo

Con questi due profili, validare in Odoo la consegna di un ordine Mirakl basta per avvisare il marketplace, anche se la casella «Send Tracking to Mirakl on Validation» è deselezionata, com'è di default. Sul profilo generico è quella casella a decidere.

Prima di validare, Odoo aggiorna l'ordine di vendita con quello di Mirakl e inserisce nel prelievo il contatto di consegna dell'acquirente. Se a quel contatto mancano via, città, codice postale o telefono, richiede di nuovo l'ordine a Mirakl e lo ricostruisce.

Poi la spedizione avviene in due passi. Prima il tracciamento (OR23). Se Mirakl non dà ancora l'ordine come spedito, Odoo lo segna come spedito (OR24). Se l'operatore non accetta il primo passo, per esempio con un 404 o perché non riconosce il codice del corriere, Odoo passa direttamente al secondo. E quando il tuo corriere di Odoo si traduce solo come OTHER, usa il corriere che arrivava nell'ordine Mirakl.

Prelievo validato di un ordine Mirakl con il pulsante Push Mirakl Tracking e il tracciamento nello stato Synced
Un prelievo validato: il pulsante «Push Mirakl Tracking», lo stato del tracciamento su Synced, l'ultima richiesta inviata a Mirakl e, nella cronologia, «Mirakl tracking pushed successfully.» Schermata di Odoo con dati dimostrativi.

Se il prelievo non ha un numero di tracciamento

Non si invia nulla. Odoo lo annota sul prelievo: 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. Inserisci il numero del corriere e premi «Push Mirakl Tracking», che invia il tracciamento a mano.

Se mancano le righe dell'ordine

Con questi due profili, la spedizione richiede le righe dell'ordine Mirakl. Se non le trova né nell'ordine Mirakl né in quello di vendita, si ferma con Missing Mirakl order lines to push tracking.

Posso avere Leroy Merlin e Decathlon nello stesso Odoo?

Sì. Ogni operatore è un marketplace distinto in Mirakl › Configuration › Marketplaces, con il proprio profilo, la propria chiave e il proprio negozio.

E se non voglio che gli ordini vengano accettati automaticamente?

Deseleziona «Auto Accept Orders» e «Accept Pending On Import» dopo aver scelto il profilo e salva: ciò che imposti a mano prevale sul profilo. Se in seguito scegli di nuovo il profilo in «Provider Code», le selezionerà di nuovo.

Continua a leggere

Un ordine Mirakl in Odoo, dall'acquisto al pagamentoCronologia di un ordine di un marketplace Mirakl dentro Odoo 17, 18, 19 e 20: accettazione, spedizione, tracciamento, reso, fattura e liquidazione.Come mappare categorie e attributi Mirakl in Odoo, passo dopo passoCome preparare il catalogo di un marketplace Mirakl in Odoo: dizionario delle categorie, attributi, liste di valori, mappatura ed esportazione, con gli errori tipici.Mettere in funzione Leroy Merlin Connector in Odoo: domande e risposteQuali campi compilare in Leroy Merlin Connector per Odoo, quali stati attraversa il tracciamento e cosa controllare nella prima settimana dopo il collegamento.
Verificato nel codice del connettore (versione 17.0, 18.0, 19.0 e 20.0)

Fonti

  • Codice del modulo: 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)
  • Codice del modulo: 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
  • Codice del modulo: 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
  • Codice del modulo: 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
  • Codice del modulo: 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
  • Codice del modulo: 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)