Vai al contenuto principale
Mirakl

Come mappare categorie e attributi Mirakl in Odoo, passo dopo passo

Per pubblicare prodotti su un marketplace Mirakl da Odoo, indichi al connettore a quale categoria dell'operatore appartiene ogni prodotto e quali valori riempiono i suoi attributi obbligatori. Si fa nel menu Catalog in quest'ordine: dizionario, categorie, attributi e liste di valori, mappatura, esportazione e controllo della validazione.

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

In breve

Modulo
Mirakl
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 20.0 · nelle fonti collegate in fondo
Lettura
3 min

Ogni operatore Mirakl ha il suo albero di categorie e i suoi attributi. Quello che Leroy Merlin chiama in un modo, Decathlon lo chiede in un altro. Il connettore, pubblicato per Odoo 17, 18, 19 e 20, scarica quel dizionario e ti permette di allinearci il tuo catalogo una volta sola.

I passaggi

  1. Registra il marketplace in Mirakl › Configuration › Marketplaces con il suo URL API e la sua chiave.
  2. Aspetta la prima sincronizzazione del dizionario del catalogo. L'attività si ripete ogni 60 minuti e lascia le categorie dell'operatore in Mirakl › Catalog › Categories.
  3. Controlla in Catalog › Attributes quali attributi sono obbligatori nelle categorie che userai.
  4. Apri Catalog › Value Lists per gli attributi che accettano solo valori chiusi, come colori o materiali. Il tuo valore in Odoo deve coincidere con uno della lista.
  5. In Catalog › Category Mapping, assegna ognuna delle tue categorie di prodotto alla categoria dell'operatore.
  6. Se spedisci tu, collega i tuoi vettori a quelli del marketplace in Catalog › Carrier Mapping.
  7. Esporta il catalogo. L'attività gira ogni 30 minuti e puoi anche lanciarla a mano.
  8. Controlla lo stato dell'ultima esportazione e la validazione di ogni prodotto prima di esportare le offerte.
Albero delle categorie di un operatore Mirakl scaricato in Odoo
Le categorie dell'operatore, così come le scarica il connettore. Schermata di Odoo con dati di Leroy Merlin scaricati dal connettore.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in inglese)

Gli stati da saper leggere

Ogni esportazione del catalogo lascia uno stato: in attesa, riuscita, errore o sconosciuto. Ogni prodotto ha anche il suo stato di validazione: non controllato, OK, avviso o errore. Con un avviso puoi ancora pubblicare, ma di solito indica un attributo opzionale vuoto che l'operatore usa per i filtri. Conviene compilarlo.

Per le offerte è lo stesso. L'ultima esportazione delle offerte mostra il suo risultato, e ogni offerta porta il codice di stato di Mirakl: 11 per attiva e 12 per inattiva.

Elenco degli attributi di un operatore Mirakl con tipo e obbligatorietà
Gli attributi dell'operatore: tipo di dato e se sono obbligatori. Schermata di Odoo con dati di Leroy Merlin scaricati dal connettore.

Errori tipici e come risolverli

MessaggioCosa significaCosa fare
Catalog validation failed: …L'operatore ha rifiutato uno o più prodotti. Quello che segue i due punti dice quale e perché.Correggi l'attributo indicato ed esporta di nuovo.
No catalog import id found yet. Export catalog first.Hai chiesto il risultato di un'importazione che ancora non esiste.Esporta il catalogo e aspetta che Mirakl restituisca il numero di importazione.
No import id found yet. Export the offer first.Lo stesso, per le offerte.Esporta l'offerta prima di consultarne il risultato.
Selected category does not belong to this wizard.Nella procedura guidata hai scelto una categoria di un altro marketplace.Riaprila dal marketplace giusto.
Mappatura tra categorie di Odoo e categorie dell'operatore Mirakl
La mappatura delle categorie: le tue a sinistra, quelle dell'operatore a destra. Schermata di Odoo con dati di Leroy Merlin scaricati dal connettore.

Quando esportare le offerte

Solo quando il prodotto è validato. Le offerte si esportano ogni 5 minuti, ma l'offerta di un prodotto che l'operatore non ha accettato resta inattiva anche con prezzo e giacenza. Se nell'elenco vedi molte offerte inattive, il problema è quasi sempre un passaggio prima, nel catalogo.

Quando aggiungi un nuovo operatore, ripeti la mappatura solo per le sue categorie: ciò che hai già mappato per un altro marketplace resta, perché ogni operatore conserva la sua.

I record in Configuration › Logs conservano ogni chiamata a Mirakl. Se un errore sullo schermo non ha senso, lì c'è la risposta completa dell'operatore.

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.Esempio: un produttore che vende su diversi marketplace Mirakl con fogli di calcoloCaso di esempio di un produttore che vende su diversi marketplace Mirakl con fogli di calcolo, e cosa cambia quando tutto passa in Odoo con il connettore.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti

  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): views/menu_views.xml
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): data/ir_cron_data.xml
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_catalog_binding_mixin.py
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_offer_binding_mixin.py
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_product_binding.py
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_category_search_wizard.py
  • apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector