Vai al contenuto principale
Mirakl

Checklist dell'istanza Mirakl Connector, campo per campo

La scheda istanza di Mirakl riunisce la connessione, i conti di liquidazione e alcune opzioni; qui trovi, campo per campo, cosa significa ciascuno secondo la sua guida e cosa conviene inserire.

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

Le schede si aprono dal menu Mirakl › Configurazione › Marketplace, nell'elenco Istanze Mirakl.

Schema con il menu Mirakl, Configurazione, Marketplace e i campi della scheda istanza
Schema realizzato con codice a partire dal codice pubblicato del modulo (non è una schermata di Odoo): il menu e i campi della scheda.

Prima di toccare la scheda

  • Permesso. Per vedere la chiave serve essere Mirakl Manager: la guida di Chiave API dice che solo i Mirakl Manager possono vederla o modificarla, e la Chiave API di Mirakl (FlexigoTech Cloud) la vedono solo gli utenti con quel permesso.
  • Account venditore del marketplace. Aprilo in un'altra scheda: da lì arrivano l'host dell'operatore e la chiave API, secondo la guida di quei campi.
  • Abbonamento. Il modulo richiede l'abbonamento a FlexigoTech Cloud (piano Connettore). Il prezzo è in fondo.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in inglese)

Profilo del marketplace

  • Codice fornitore. Si vede nella scheda e anche nell'elenco Istanze Mirakl. È il profilo di marketplace/fornitore che usa l'istanza; secondo la sua guida, installando i complementi fornitore compaiono profili specifici dell'operatore, come Leroy Merlin. Il valore predefinito è Mirakl generico.

Scheda Connessione, gruppo Accesso

Questi campi si trovano nella scheda Connessione, gruppo Accesso.

  • Connessione a Mirakl. È in sola lettura e vale FlexigoTech Cloud per impostazione predefinita. La sua guida dice che i marketplace nuovi si collegano tramite FlexigoTech Cloud e che Diretta (chiave API salvata in Odoo) resta solo per quelli già esistenti prima di questa versione, che continuano a funzionare così come sono stati acquistati. Non c'è nulla da inserire: controlla solo quale percorso ha la tua istanza.
  • Chiave API di Mirakl (FlexigoTech Cloud). Si trova nel gruppo FlexigoTech Cloud. Con i valori predefiniti è visibile, e si nasconde se la connessione non è quella di FlexigoTech Cloud. La sua guida dice che viene inviata una sola volta, cifrata, a FlexigoTech Cloud e che non viene mai salvata in Odoo.
  • URL base. È l'host reale dell'operatore. La sua guida avverte che Mirakl non fornisce un host universale condiviso da tutti i marketplace. Per gli operatori noti si compila da sola; altrimenti inseriscila dal tuo account venditore. Esempio della guida: https://adeo-marketplace.mirakl.net. È obbligatoria prima di poter testare la connessione o sincronizzare.
  • URL base API. È l'URL base reale dell'API per l'operatore scelto. La sua guida dice che normalmente è l'URL base più /api, con questo esempio: https://adeo-marketplace.mirakl.net/api.
  • Chiave API. Con i valori predefiniti non si vede: si nasconde quando la connessione è FlexigoTech Cloud, quindi compare nelle istanze con connessione Directa. È la chiave API del venditore (Settings > API key nel tuo account venditore) ed è necessaria prima di poter usare Testa connessione o sincronizzare.
  • Negozio. Si vede nella scheda e in questo gruppo. È un identificativo facoltativo per ambienti multinegozio. Secondo la sua guida, Testa connessione lo compila automaticamente quando Mirakl espone il negozio del venditore.

Scheda Finanze

Qui c'è la contabilità delle liquidazioni. Nella scheda Finanze ci sono due gruppi.

Gruppo Contabilità liquidazioni

  • Registro liquidazioni. Uno dei registri disponibili per contabilizzare le scritture di liquidazione di Mirakl. Se lo lasci vuoto, al primo utilizzo viene creato un registro dedicato, Liquidazioni Mirakl. Scegline uno tuo se preferisci che non venga creato quello.
  • Conto transitorio marketplace. Un conto transitorio dello stato patrimoniale che rappresenta quanto il marketplace ti deve per gli ordini: viene addebitato dalle vendite e accreditato quando la liquidazione effettua il pagamento.
  • Conto spese commissioni. Il conto di spesa per la commissione e le tariffe del marketplace.
  • Conto transitorio pagamenti / banca. Viene addebitato con il pagamento netto che ti trasferiscono e poi si riconcilia con l'accredito bancario reale: a mano in Community, con la sincronizzazione bancaria in Enterprise, secondo la sua guida.

Gruppo Opzioni

  • Conto analitico. Facoltativo. Serve a far sì che le liquidazioni di questo marketplace alimentino un conto economico per canale nei report analitici di Odoo. Impostalo se vuoi quella lettura per canale.
  • Registra automaticamente le liquidazioni. Crea automaticamente la registrazione contabile quando si importa una liquidazione. È disattivata per impostazione predefinita: attivala solo se vuoi quella registrazione all'importazione.

Scheda AI (facoltativa)

  • Abilita approfondimenti AI. Si trova nella scheda AI (facoltativa) ed è disattivata. Con Odoo in italiano, la sua guida dice Opzionale. Il connettore funziona pienamente senza AI. Se non lo abiliti / non imposti una chiave, non viene mai effettuata alcuna chiamata AI e nulla cambia. Se non ti serve, lasciala così.
Schema con il testo della guida del campo degli approfondimenti AI in cinque lingue
Schema realizzato con codice a partire dalle traduzioni pubblicate del modulo (non è una schermata di Odoo): la guida di Abilita approfondimenti AI in spagnolo, tedesco, francese, italiano e portoghese.

Revisione prima di dare per buona l'istanza

  • Controlla che URL base e URL base API puntino allo stesso operatore; normalmente la seconda è la prima più /api, come negli esempi della guida.
  • Se la tua istanza usa la connessione Directa, verifica che URL base e Chiave API siano compilate prima di provare a testare la connessione o sincronizzare.
  • Dopo aver testato la connessione, guarda Negozio: la sua guida dice che si compila da solo quando Mirakl espone il negozio del venditore.
  • Rivedi con il tuo commercialista i conti del gruppo Contabilità liquidazioni.

Prezzo e aiuto con l'avvio

Il modulo è a pagamento unico per versione di Odoo ed è pubblicato su Odoo Apps per 17, 18, 19 e 20 (consulta la scheda di Odoo Apps o la pagina del modulo). 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, controlla la sincronizzazione e avvisa via e-mail se fallisce. Con l'abbonamento, il modulo per le nuove versioni di Odoo è incluso se lo hai acquistato su flexigotech.com; nell'Odoo App Store, ogni versione di Odoo si acquista lì.

FlexigoTech implementa Odoo 17, 18, 19 e 20 e sviluppa connettori e integrazioni su misura. Se vuoi che rivediamo insieme a te la scheda della tua istanza, scrivici.

Continua a leggere

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