Vai al contenuto principale
Mirakl

L'azione «Mirakl - Sincronizza ordini»: cosa fa e cosa controllare se non fa nulla

Mirakl - Sincronizza ordini (Mirakl - Sync Orders) gira ogni 10 minuti da quando installi Mirakl Connector e, a ogni passata, importa gli ordini di ogni marketplace che tocca e ricontrolla quelli ancora aperti. Se non fa nulla, poche condizioni la lasciano fuori: chi la lancia, quali marketplace entrano, l'intervallo proprio di ciascuno e la connessione con FlexigoTech Cloud.

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 e 20.0 · nelle fonti collegate in fondo
Lettura
5 min

Cosa fa l'azione a ogni passata

Schema fatto con il codice: in alto l'azione pianificata di sincronizzazione ordini, che gira ogni 10 minuti ed è attiva all'installazione, e sotto il menu dei marketplace, con le etichette in inglese
Schema fatto con il codice a partire dal codice pubblicato del modulo, non una schermata di Odoo: l'azione ogni 10 minuti, attiva all'installazione (Odoo 17, 18, 19 e 20), e il menu dei marketplace.

Cosa fa Mirakl - Sincronizza ordini a ogni passata?

Secondo il codice di Odoo 20.0, una passata segue quest'ordine. Prima verifica che chi la esegue sia amministratore. Poi prende i marketplace attivi che hanno abilitata la sincronizzazione degli ordini e tiene quelli che può chiamare (più sotto, quali restano fuori). Per ognuno che tocca in base al suo intervallo, importa gli ordini e, subito dopo, ricontrolla gli ordini aperti già presenti in Odoo. Poi passa al marketplace successivo.

Ogni quanto gira e come si chiama nel mio Odoo?

Gira ogni 10 minuti ed è attiva all'installazione del modulo. È presente in tutti i rami pubblicati (Odoo 17, 18, 19 e 20) e in Odoo 17.0 si ripete senza fine. Con Odoo in italiano si chiama Mirakl - Sincronizza ordini; lo schema seguente mostra il suo nome in altre lingue.

Schema fatto con il codice con il nome dell'azione secondo la lingua: in spagnolo Mirakl - Sincronizar pedidos, in tedesco Mirakl - Bestellungen synchronisieren, in francese Mirakl - Synchroniser les commandes, in italiano Mirakl - Sincronizza ordini e in portoghese Mirakl - Sincronizar Encomendas
Schema fatto con il codice a partire dalle traduzioni pubblicate del modulo, non una schermata di Odoo: il nome dell'azione in spagnolo, tedesco, francese, italiano e portoghese.

Importa tutti i marketplace a ogni passata?

Non necessariamente: dipende dall'intervallo proprio di ciascun marketplace. Se non ha intervallo (è il valore predefinito), importa a ogni passata, cioè ogni 10 minuti. Se ha un intervallo e c'è già una sincronizzazione di ordini precedente, il marketplace aspetta che sia trascorso quel tempo dall'ultima; se non ce n'è ancora nessuna, importa. L'azione continua a svegliarsi ogni 10 minuti, ma quel marketplace salta le passate finché non tocca a lui.

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

Cosa legge da Mirakl e cosa ricontrolla dopo

Cosa chiede a Mirakl quando importa gli ordini e quando smette di chiedere?

Chiede gli ordini per pagine, con una dimensione di pagina e un massimo di pagine per passata, a partire da un punto di partenza temporale. Ogni ordine viene salvato separatamente: se uno fallisce, resta una voce di registro di livello errore con il riferimento dell'ordine e la passata prosegue con gli altri. Smette di chiedere quando una pagina porta meno ordini della dimensione di pagina o quando ha già letto il totale indicato dalla risposta; se si esaurisce il massimo di pagine, annota una voce di registro di livello avviso. E se una pagina arriva senza ordini e il connettore non riconosce la forma della risposta, non la tratta come una pagina vuota: annota un errore e smette di chiedere pagine.

A cosa serve il ricontrollo degli ordini aperti?

L'importazione incrementale guarda solo una finestra di tempo recente. Per questo, dopo aver importato, l'azione rilegge gli ordini che sono già in Odoo e non sono ancora terminati: così un cambio di stato fatto nel marketplace molto tempo dopo la creazione dell'ordine arriva in Odoo. Viene eseguito solo se quel ricontrollo è abilitato nel marketplace; altrimenti non fa nulla. Legge gli ordini a lotti: se un lotto fallisce, lo annota nel log del server e prova ordine per ordine. Al termine di ogni lotto, segna tutti i suoi ordini con la data del ricontrollo, anche quelli che il marketplace non ha restituito, così un ordine mancante non blocca la rotazione degli altri.

Cosa controllare se non fa nulla

Perché compare Solo un amministratore può eseguire questa azione pianificata. (Only an administrator can run this scheduled action.)?

La prima cosa che fa l'azione è verificare che chi la esegue sia amministratore. Se non lo è, si ferma con quel messaggio e non elabora nessun marketplace.

Quali marketplace lascia fuori una passata?

Quelli non attivi o senza la sincronizzazione degli ordini abilitata. Tra quelli rimasti, vanno per primi quelli che non passano da FlexigoTech Cloud; quelli che passano vengono chiamati solo se hanno una chiave salvata, perché senza di essa il servizio li rifiuterebbe, e se il permesso salvato nel tuo Odoo non include il servizio del modulo, nessuno di quelli che passano da FlexigoTech Cloud viene chiamato (questo controllo non usa la rete). Infine, quelli con intervallo proprio saltano la passata finché non tocca a loro. Le schede dei marketplace si aprono da Mirakl › Configurazione › Marketplace.

Cosa succede se un marketplace dà errore o FlexigoTech Cloud mette in pausa la connessione?

Ci sono due strade. Se un marketplace fallisce con un errore, viene scritto nel log del server, si salva una voce di registro di livello errore con il messaggio dell'errore e l'azione prosegue con il marketplace successivo; poiché il ricontrollo degli ordini aperti viene dopo l'importazione nello stesso blocco, quel marketplace non lo raggiunge in quella passata. Se invece FlexigoTech Cloud mette in pausa la connessione, l'azione smette di scorrere i marketplace in quella passata e la successiva continua; i marketplace diretti vanno per primi perché nessuno resti indietro. La pausa conta solo nel rapporto di salute di FlexigoTech Cloud, con codici e mai testo. Se la pausa arriva durante il ricontrollo degli ordini aperti, il lotto che si stava leggendo non viene segnato; i lotti già terminati conservano la loro data di ricontrollo.

Ho bisogno dell'abbonamento a FlexigoTech Cloud?

Sì. Mirakl Connector è a pagamento unico per versione e richiede l'abbonamento a FlexigoTech Cloud, piano Connettore: 49 €/mese o 490 €/anno, IVA esclusa, fino a 3 account della piattaforma. È pubblicato per Odoo 17, 18, 19 e 20; il prezzo di ogni versione è nella scheda e nella pagina del modulo. La connessione passa da FlexigoTech Cloud: conserva cifrate le credenziali, sorveglia la sincronizzazione e avvisa via e-mail se fallisce. Senza abbonamento, o con il servizio sospeso, si ferma ciò che offre l'abbonamento; i dati restano nel tuo Odoo.

Se stai implementando Odoo e vuoi rivedere con qualcuno come resta questa sincronizzazione, FlexigoTech implementa Odoo 17, 18, 19 e 20 e sviluppa connettori e integrazioni su misura.

Continua a leggere

L'errore «Conferma la fattura prima di inviarla a Mirakl.» in Mirakl ConnectorQuando compare l'errore «Conferma la fattura prima di inviarla a Mirakl.» in Mirakl Connector per Odoo, cosa controlla il codice e come risolverlo.L'attività «Mirakl - Accetta ordini», passata per passataCosa fa a ogni passata l'attività pianificata Mirakl - Accetta ordini di Mirakl Connector per Odoo, ogni quanto gira e cosa controllare se non accetta nulla.Cosa fa il pulsante «Annulla in Mirakl» di Mirakl Connector, passo passoCosa fa il pulsante Annulla in Mirakl di Mirakl Connector per Odoo: quando compare, cosa controlla, cosa cambia nell'ordine e quali errori può dare.
Verificato nel codice del connettore (versione 17.0 e 20.0) e nelle fonti collegate

Fonti