Vai al contenuto principale
Mirakl

Campi dell'istanza Mirakl in Mirakl Connector: cosa significano e cosa inserire

La scheda Istanze Mirakl distribuisce i suoi campi su più schede, e ognuno ha il proprio aiuto. Qui li confrontiamo: cosa dice l'aiuto, quale valore hanno di default e cosa cambia se li lasci vuoti o li compili.

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
7 min

Dove si trovano i campi

Le schede si aprono dal menu Mirakl › Configurazione › Marketplace. Nella scheda Istanze Mirakl (Mirakl Instances), i campi di questa guida sono distribuiti in tre schede: Corrieri (Carriers), Ordini e resi (Orders and Returns) e Operazioni manuali (Manual Operations).

Schema realizzato con codice del menu Mirakl, Configuration, Marketplaces e della scheda Mirakl Instance con i campi confrontati qui
Schema realizzato con codice a partire dal codice pubblicato del modulo, non è una schermata di Odoo: il menu e i campi della scheda con le loro etichette originali.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in inglese)

Finestre di importazione e limiti

Questi campi delimitano ciò che viene importato, analizzato o consultato. Tutti hanno un valore predefinito nel codice.

CampoDove si trovaCosa dice l'aiutoPredefinito
Giorni di sincronizzazione iniziale degli ordini (Initial Order Sync Days)Ordini e resi, gruppo Windows«Finestra storica utilizzata quando non c'è una precedente sincronizzazione degli ordini. Anche l'importazione manuale usa questo intervallo.»30
Giorni di sincronizzazione iniziale dei resi (Initial Return Sync Days)Ordini e resi, gruppo Windows«Finestra storica utilizzata quando non c'è una precedente sincronizzazione dei resi. Anche l'importazione manuale usa questo intervallo.»30
Pagine massime di sincronizzazione (Max Sync Pages)Ordini e resi, gruppo Windows«Limite di sicurezza per le importazioni paginate di ordini/resi.»40
Limite generazione collegamenti offerta (Offer Binding Generate Limit)Operazioni manuali, gruppo Offerte (Offers)«Numero massimo di prodotti analizzati durante la generazione automatica dei collegamenti offerta mancanti.»500
Endpoint corrieri di spedizione (Endpoint Shipping Carriers)Corrieri, gruppo Sincronizzazione corrieri (Carrier Sync)«Endpoint Mirakl SH21 utilizzato per recuperare i corrieri di spedizione disponibili quando supportato dall'operatore.»/shipping/carriers

I due campi dei giorni definiscono la finestra usata quando non esiste ancora una sincronizzazione precedente di ordini o di resi, e l'aiuto aggiunge che l'importazione manuale usa lo stesso intervallo. Pagine massime di sincronizzazione è, secondo il suo aiuto, un limite di sicurezza per le importazioni paginate.

Cliente dell'ordine: due modalità e due caselle

Il campo Modalità cliente ordini (Order Customer Mode) si trova in Ordini e resi, gruppo Cliente e privacy (Customer & Privacy). Ha due valori: Un cliente per acquirente (standard) (One customer per shopper (standard)), quello predefinito, e Cliente predefinito unico con contatti figli di consegna (Single default customer with delivery child contacts).

CampoQuando è visibilePredefinito
Modalità cliente ordiniNel gruppo Cliente e privacyUn cliente per acquirente (standard)
Cliente predefinito del marketplace (Default Marketplace Customer)Solo con la modalità cliente unico; con i valori predefiniti non è visibileNascosto con la modalità standard
Contatti di consegna come aziende (Delivery Contacts as Companies)Solo con la modalità cliente unico; con i valori predefiniti non è visibileDisattivata
Usa email di notifica Mirakl (Use Mirakl Notification Email)Nel gruppo Cliente e privacyDisattivata

Cosa dice l'aiuto di ciascuna opzione:

  • Modalità standard: ogni acquirente diventa il proprio cliente in Odoo.
  • Cliente predefinito unico: tutti gli ordini del marketplace vengono assegnati a un cliente fisso, quello che scegli in Cliente predefinito del marketplace. L'indirizzo di consegna dell'acquirente viene salvato come suo contatto figlio (tipo Consegna, contrassegnato come acquirente del marketplace), così i dati personali restano circoscritti e possono essere nascosti con una regola di record. Le fatture vengono emesse al cliente predefinito e non riportano dati dell'acquirente.
  • Contatti di consegna come aziende: solo con cliente unico. Ogni indirizzo di consegna diventa un contatto aziendale a sé invece di un contatto figlio del cliente predefinito, in modo che l'ordine di vendita, la consegna e il documento di trasporto mostrino l'azienda del cliente finale e mai il nome del cliente predefinito. L'aiuto indica che la persona va in Persona di contatto, e che l'email che Mirakl invia per il cliente non viene salvata: nei marketplace in cui l'operatore acquista da te (GACD, ad esempio) è un indirizzo dell'operatore, non del cliente.
  • Email di notifica: Mirakl rende anonimo l'acquirente dietro un indirizzo di relay per ordine, che cambia a ogni ordine. Con la casella attiva, il relay viene usato come email del contatto di consegna dell'ordine (mai su una scheda cliente permanente), così le risposte arrivano all'acquirente tramite Mirakl. In modalità cliente unico, il contatto figlio dell'acquirente porta sempre il relay quando Mirakl lo fornisce. Il valore di ogni ordine viene salvato anche nell'ordine di vendita.

Bridge vendite: vuoto o compilato

Nella scheda Ordini e resi, il gruppo Bridge vendite (Sales Bridge) riunisce campi il cui aiuto spiega cosa succede se li lasci vuoti.

CampoSe lo lasci vuotoSe lo compili
Prodotto di spedizione (Shipping Product). A schermo è senza etichetta: si vede solo il suo contenutoNon viene aggiunta alcuna riga di spedizione all'ordine di venditaQuel prodotto di tipo servizio viene usato per la riga delle spese di spedizione
Crea ordini di vendita dal (Create Sales Orders From)Nessun limiteGli ordini Mirakl creati prima di quella data vengono importati ma non diventano mai ordini di vendita
Addetto vendite negli ordini (Salesperson on Orders)Decide Odoo: l'addetto vendite del cliente o, se non ne ha, l'utente che ha importato l'ordine (OdooBot nell'importazione automatica)Quell'addetto vendite viene impostato su ogni ordine di vendita importato da questo marketplace
Metodo di spedizione negli ordini (Shipping Method on Orders)Gli ordini di vendita non hanno un metodo di spedizioneQuel metodo viene impostato su ogni ordine di vendita e, con esso, sulla sua consegna

Due precisazioni dell'aiuto. In Crea ordini di vendita dal, il motivo è evitare che gli ordini gestiti prima di usare il connettore vengano spediti di nuovo. In Metodo di spedizione negli ordini, l'aiuto chiede di assegnarlo in Mirakl > Catálogo > Asignación de transportistas affinché il numero di tracciamento arrivi a Mirakl con il corriere corretto.

Inviare il tracking alla convalida

La casella Invia il tracking a Mirakl alla convalida (Send Tracking to Mirakl on Validation) è disattivata di default. Se attivata, quando convalidi la consegna in Odoo la spedizione viene inviata a Mirakl (numero di tracciamento, corriere e conferma di spedizione), così il marketplace segna l'ordine come spedito e l'acquirente vede il tracking. L'aiuto pone due requisiti: la consegna deve avere un numero di tracciamento e il suo corriere dovrebbe essere mappato nella scheda Corrieri. Se il numero manca, il documento di trasporto non viene toccato e una nota ne spiega il motivo. Alcuni profili di marketplace, come Leroy Merlin, lo inviano sempre perché l'operatore lo richiede.

Il campo dell'endpoint dei corrieri

L'aiuto di Endpoint corrieri di spedizione si legge, con Odoo in italiano, «Endpoint Mirakl SH21 utilizzato per recuperare i corrieri di spedizione disponibili quando supportato dall'operatore.». Lo schema mostra lo stesso testo in tedesco, francese, italiano e portoghese.

Schema con l'aiuto del campo Endpoint Shipping Carriers in spagnolo, tedesco, francese, italiano e portoghese
Schema realizzato con codice a partire dalle traduzioni pubblicate del modulo, non è una schermata di Odoo.

Cosa inserire in base al tuo caso

  • Vendevi sul marketplace prima di installare il connettore: compila Crea ordini di vendita dal; secondo l'aiuto, gli ordini precedenti vengono importati ma non diventano ordini di vendita.
  • Non vuoi un cliente Odoo per ogni acquirente: scegli la modalità cliente unico e indica il Cliente predefinito del marketplace; l'aiuto suggerisce un contatto generico per marketplace.
  • Vuoi che l'acquirente veda il tracking alla convalida: attiva Invia il tracking a Mirakl alla convalida e verifica il corriere nella scheda Corrieri.
  • Non vuoi la riga delle spese di spedizione: lascia vuoto Prodotto di spedizione.
  • Non hai un addetto vendite fisso per questi ordini: lascia vuoto Addetto vendite negli ordini e deciderà Odoo secondo il suo aiuto.

Costo e supporto di FlexigoTech

Mirakl Connector è un modulo a pagamento unico per versione di Odoo (pubblicato su Odoo Apps per 17, 18, 19 e 20) e richiede l'abbonamento a FlexigoTech Cloud: piano Connettore, 49 €/mese o 490 €/anno IVA esclusa, fino a 3 account della piattaforma. La connessione passa per FlexigoTech Cloud, che conserva cifrate le credenziali, sorveglia la sincronizzazione e avvisa via email se fallisce. Hai la scheda di Odoo Apps e la pagina del modulo. Se preferisci che qualcuno configuri l'istanza con te, 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.I campi dell'istanza Mirakl in Odoo: cosa significa ciascuno e cosa impostareGuida ai campi dell'istanza di Mirakl Connector per Odoo: spedizione, sconto, commissione, lingua, fatture e sincronizzazione, secondo la loro guida.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti