Vai al contenuto principale
Mirakl

Cosa aggiunge Mirakl Connector all'ordine di vendita di Odoo (Vendite)

Mirakl Connector aggiunge all'ordine di vendita una scheda Mirakl con l'istanza, l'ordine, il suo stato, l'ultima sincronizzazione e i dati di spedizione e contatto, e si vede solo quando l'ordine ha un Ordine Mirakl. Inoltre cambia cosa succede quando elimini l'ordine, salvi modifiche ai suoi indirizzi e lo fatturi.

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

Cosa tocca il modulo in Vendite

Il modulo estende l'ordine di vendita standard dell'app Vendite (Sales) di Odoo. Quello che aggiunge sono campi nella scheda, uno dei quali anche nell'elenco degli ordini, e modifiche al comportamento nel codice dell'ordine. Ecco cosa conviene sapere prima di aprire il primo ordine che arriva da un marketplace.

Schema realizzato con il codice: l'app Vendite in alto e, sotto, i campi che le aggiunge Mirakl Connector
Schema generato a partire dal codice del modulo, non è una schermata di Odoo. Le etichette sono in inglese, il testo originale del codice.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in inglese)

Dettagli che non si vedono nella scheda

I campi non compaiono finché l'ordine non ha un Ordine Mirakl

I campi del modulo si trovano nella scheda dell'ordine di vendita, nella scheda Mirakl, divisi in due gruppi: Marketplace e Spedizione e contatto (Shipping & Contact). Tutti restano nascosti finché Ordine Mirakl (Mirakl Order) è vuoto, quindi in un ordine senza quel valore non vedrai nulla di tutto questo.

Nel gruppo Marketplace ci sono Istanza Mirakl (Mirakl Instance), Ordine Mirakl, Stato ordine Mirakl (Mirakl Order State) e Ultima sincronizzazione Mirakl il (Mirakl Last Sync At). Tutti e quattro sono di sola lettura: si consultano, non si modificano.

Schema realizzato con il codice con il testo del gruppo Marketplace in altre lingue: Marktplatz, Place de marché e Marktplaats
Schema generato a partire dalle traduzioni del modulo, non è una schermata di Odoo. Con Odoo in tedesco il gruppo appare come Marktplatz, in francese come Place de marché e in olandese come Marktplaats.

L'email del cliente può essere un relay anonimizzato

Email cliente Mirakl (Mirakl Customer Email) si trova nel gruppo Spedizione e contatto ed è di sola lettura. Secondo il suo aiuto, non sempre contiene l'email reale dell'acquirente: quando esiste, contiene il relay anonimizzato che Mirakl crea per ogni ordine, e ciò che invii lì arriva all'acquirente. Se non c'è relay, contiene l'email del cliente che arriva con l'ordine.

Il telefono e la persona di contatto hanno una logica propria

Telefono del cliente Mirakl (Mirakl Customer Phone) raccoglie il telefono che l'acquirente ha indicato nel marketplace, per averlo a portata di mano direttamente dall'ordine. Secondo il suo aiuto, viene salvato anche nel contatto di consegna. È di sola lettura.

Persona di contatto Mirakl (Mirakl Contact Person) ha una condizione in più. Si vede solo se l'ordine ha un Ordine Mirakl e inoltre il campo stesso ha un valore. Il suo aiuto dice che contiene la persona che ha effettuato l'ordine quando il marketplace invia anche un nome di azienda, e che in quel caso l'azienda viene usata come nome del contatto di consegna. Se non lo vedi, il campo è vuoto in quell'ordine.

Il metodo di spedizione compare anche nell'elenco degli ordini

Metodo di spedizione Mirakl (Mirakl Shipping Method) si trova in Spedizione e contatto e, a differenza degli altri, compare anche nell'elenco degli ordini di vendita. Il suo aiuto dice che è il metodo di spedizione scelto dall'acquirente nel marketplace (ad esempio, Standard o Giorno successivo) e che resta vuoto quando l'operatore non lo invia.

Un campo vuoto qui, quindi, non indica un errore: è quello che succede quando l'operatore non manda quel dato.

Eliminare un ordine Mirakl lo lascia eliminato

Il modulo cambia cosa succede quando si elimina un ordine di vendita. Secondo il codice di Odoo 20, prima di eliminarlo cerca gli ordini Mirakl collegati. Se l'ordine di vendita ha un Ordine Mirakl, cerca anche l'ordine Mirakl con quell'identificatore nella stessa istanza, il che copre un preventivo che non è mai stato collegato. Dopo l'eliminazione, segna quegli ordini Mirakl come eliminati.

Il motivo si trova in un commento del codice stesso: un ordine di vendita eliminato deve restare eliminato, perché l'ordine Mirakl lo ricorda e una nuova sincronizzazione non lo crea né lo conferma di nuovo automaticamente.

Cambiare cliente o indirizzi in un ordine Mirakl

In Odoo 20, quando salvi modifiche al cliente, all'indirizzo di consegna o all'indirizzo di fatturazione di un ordine con Ordine Mirakl, il modulo esegue il salvataggio in modo diverso dallo standard. Negli ordini senza Ordine Mirakl, il salvataggio è quello standard.

La fattura può uscire semplificata o completa a seconda dell'istanza

Quando prepara la fattura dall'ordine, il modulo guarda l'impostazione del tipo di fattura spagnola dell'istanza Mirakl dell'ordine (codice di Odoo 20). Quell'impostazione risiede nell'istanza, non nell'ordine; la trovi spiegata in I campi di Istanza Mirakl in Mirakl Connector.

  • Se l'ordine non ha istanza, o l'impostazione è su automatico, la fattura viene preparata come in Odoo standard.
  • Se la localizzazione spagnola di Odoo non è installata (le fatture non hanno il campo di fattura semplificata), non viene toccato nulla neppure in questo caso.
  • Se l'impostazione è semplificata, la fattura viene segnata come semplificata. Se è completa, viene segnata come non semplificata.

Come si integra con il resto e quanto costa

Il modulo è a pagamento unico per versione e richiede l'abbonamento a FlexigoTech Cloud: piano Connettore, 49 €/mese o 490 €/anno IVA esclusa. La connessione passa da FlexigoTech Cloud, che conserva cifrate le credenziali, sorveglia la sincronizzazione e avvisa via email se fallisce. È pubblicato per Odoo 17, 18, 19 e 20; nell'Odoo App Store ogni versione si acquista lì. Più dettagli nella scheda di Odoo Apps e nella pagina del modulo.

Se vuoi che verifichiamo come si presenta il flusso degli ordini nel tuo Odoo, FlexigoTech implementa Odoo 17, 18, 19 e 20 e sviluppa connettori e integrazioni su misura.

Continua a leggere

Checklist dell'istanza Mirakl Connector, campo per campoChecklist per compilare l'istanza di Mirakl Connector in Odoo: connessione, conti di liquidazione e opzioni, con quello che dice la guida di ogni campo.Campi dell'istanza Mirakl in Mirakl Connector: cosa significano e cosa inserireGuida comparata ai campi della scheda Istanze Mirakl in Mirakl Connector per Odoo: cosa dice ogni aiuto, il valore predefinito e cosa inserire.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti