Vai al contenuto principale
Mirakl

Un ordine Mirakl in Odoo, dall'acquisto al pagamento

Un ordine di un marketplace che gira su Mirakl passa per sette tappe in Odoo: arriva, viene accettato, preparato, spedito con tracciamento, fatturato, pagato nella liquidazione e, a volte, torna come reso. Questa cronologia ti dice cosa fa il connettore in ogni tappa e con quale frequenza.

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

Leroy Merlin, Decathlon o Bricodepot girano su Mirakl dietro le quinte. Per Odoo l'operatore non fa differenza: il connettore, pubblicato per Odoo 17, 18, 19 e 20, parla con l'API Mirakl di ogni marketplace che configuri e segue sempre lo stesso calendario.

Il percorso

  1. Quando il cliente compra L'ordine nasce sul marketplace in attesa di accettazione. Odoo non sa ancora nulla.
  2. Entro i 10 minuti successivi L'attività Mirakl - Sync Orders lo porta in Odoo. Compare in Mirakl › Operations › Orders con lo stato di accettazione in attesa.
  3. Al passaggio di accettazione successivo Mirakl - Accept Orders gira anch'essa ogni 10 minuti e accetta ciò che hai impostato come accettazione automatica. Se il marketplace non richiede accettazione, lo stato diventa non richiesto; se qualcosa fallisce, errore, ben visibile.
  4. All'accettazione Si crea l'ordine di vendita di Odoo con le sue righe e il cliente. La giacenza resta impegnata per gli altri canali.
  5. Quando la consegna viene preparata e convalidata Il tracciamento del vettore va al marketplace. Lo stato di tracciamento dell'ordine passa da in attesa a sincronizzato, o a errore se Mirakl lo rifiuta.
  6. Alla fatturazione La fattura cliente si registra in Odoo e poi si invia a Mirakl. L'ordine conta: una fattura in bozza non si invia.
  7. Quando arriva la liquidazione Settlements & Invoices raccoglie i pagamenti dell'operatore con il loro stato: in attesa, in lavorazione, trasferito o pagato. Ogni documento porta anche il suo stato contabile: non registrato, registrato o riconciliato.
  8. Se c'è un reso I resi si sincronizzano ogni 30 minuti e compaiono in Operations › Returns. Il rimborso ha il suo stato: in attesa, parziale, rimborsato o errore.
Elenco degli ordini Mirakl in Odoo con stato di accettazione e di spedizione
Ordini di un marketplace Mirakl dentro Odoo, ognuno con il suo stato. Schermata di Odoo con dati dimostrativi.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in inglese)

Nel frattempo, giacenza e prezzo

Mentre l'ordine avanza, altre tre attività tengono aggiornata la vetrina. Le offerte partono ogni 5 minuti. La giacenza passa dal flusso STO01 ogni 10 minuti e i prezzi da PRI01 ogni 15. Così, quando un ordine accettato prenota delle unità, gli altri marketplace lo vedono in pochi minuti.

Ordine di vendita di Odoo creato da un ordine Mirakl
L'ordine di vendita che il connettore crea all'accettazione. Tutto il resto parte da qui: consegna, fattura e reso. Schermata di Odoo con dati dimostrativi.

I due avvisi che vedrai più spesso

Al momento di inviare la fattura possono comparire due messaggi. Post the invoice before sending it to Mirakl. significa che la fattura è ancora in bozza: registrala e inviala di nuovo. This invoice is not linked to a Mirakl order. compare quando la fattura non viene da un ordine del marketplace, per esempio se l'hai creata a mano. La soluzione è fatturare dallo stesso ordine di vendita.

Consegna convalidata di un ordine Mirakl con il tracciamento già inviato
Consegna convalidata: il tracciamento è già arrivato al marketplace. Schermata di Odoo con dati dimostrativi.

Cosa non gira da solo

La sincronizzazione delle fatture da Mirakl, che gira una volta al giorno, è disattivata dopo l'installazione: la attivi se il tuo operatore la usa. Nemmeno i messaggi dei clienti si attivano in automatico. Così in Odoo non arrivano informazioni che nessuno guarderà.

Guarda il video su YouTube
Video dimostrativo del connettore Mirakl in Odoo, con l'API di Mirakl simulata.

Se ti chiedi perché un ordine è fermo, guarda prima il suo stato di accettazione e il suo stato di tracciamento nell'elenco. Quasi sempre uno dei due è in errore, e il messaggio dice perché.

Continua a leggere

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.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): data/ir_cron_data.xml
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_finance.py
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_invoice.py
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_order.py
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): models/stock_picking.py
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): models/account_move.py
  • Codice del modulo: flexigobe_mirakl_connector 20.0 (83e54909): views/menu_views.xml
  • apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
  • youtube.com/shorts/nbJU8l2bbCM