Vai al contenuto principale
Mirakl

Pulsante «Recupera corrieri Mirakl»: cosa fa e quali errori dà

Il pulsante Recupera corrieri Mirakl (Fetch Mirakl Carriers) chiede a Mirakl l'elenco dei corrieri della tua istanza, lo elabora e lascia il risultato nel chatter. Si vede sempre nella schermata Istanze Mirakl. Se la risposta contiene almeno un corriere, mostra un avviso a schermo e pubblica l'elenco completo nel chatter; se non ci sono corrieri o nessun endpoint risponde, pubblica il motivo nel chatter e mostra un avviso di attenzione; se la richiesta fallisce con un altro errore, si ferma con un messaggio di errore.

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

Prima di premere: dove si trova e cosa controllare

Le schede delle istanze si aprono dal menu Mirakl › Configurazione › Marketplace. Il pulsante Recupera corrieri Mirakl si trova nella schermata Istanze Mirakl e non dipende da nessuna condizione della vista: si vede sempre, in Odoo 17, 18, 19 e 20.

  • Apri la scheda dell'istanza da Mirakl › Configurazione › Marketplace. Il pulsante lavora su una sola istanza, quella che hai aperto.
  • Verifica che il tuo Odoo sia della versione 17, 18, 19 o 20: il modulo è pubblicato su Odoo Apps per queste quattro e il pulsante è presente in tutte.
  • Controlla il campo Endpoint corrieri di spedizione (Endpoint Shipping Carriers), nella scheda, tab Corrieri, gruppo Sincronizzazione corrieri. La sua guida dice: «Endpoint Mirakl SH21 utilizzato per recuperare i corrieri di spedizione disponibili quando supportato dall'operatore.» Il valore predefinito presente nel codice è /shipping/carriers.
  • Conferma che l'abbonamento a FlexigoTech Cloud sia attivo. La connessione passa da quel servizio e, senza abbonamento o con il servizio sospeso, si ferma ciò che dà l'abbonamento; i dati restano nel tuo Odoo.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in inglese)

Cosa fa il pulsante quando lo premi, in ordine

  • Interroga Mirakl: lancia una richiesta di lettura (GET) a un endpoint dei corrieri. Se ci sono più endpoint candidati, li prova uno dopo l'altro.
  • Se un endpoint risponde con un errore 404, passa al candidato successivo.
  • Se l'errore è di altro tipo, l'azione si ferma con Impossibile recuperare i corrieri da Mirakl: …, dove i puntini sono l'errore ricevuto. Poiché l'azione si ferma, non viene salvato ciò che stava per cambiare e non compare nessun avviso.
  • Se FlexigoTech Cloud non lascia passare la richiesta (senza abbonamento o con il servizio in pausa), l'azione si ferma e non viene segnato nulla.
  • Se nessun endpoint restituisce una risposta, pubblica nel chatter e in un avviso di attenzione Questo operatore non espone i corrieri Mirakl generici tramite SH21. Provati: ….. I puntini sono gli endpoint provati.
  • Se l'endpoint che ha risposto è diverso da quello presente in Endpoint corrieri di spedizione, il modulo scrive in quel campo quello che ha risposto.
  • Legge la risposta. Se non riesce a interpretarla come un elenco di corrieri, l'azione si ferma con Formato di risposta imprevisto dall'endpoint dei corrieri Mirakl.
  • Elabora l'elenco e ottiene due dati: quanti corrieri ci sono e quante mappature dei corrieri sono state aggiornate.
  • Se, dopo aver elaborato la risposta, non c'è nessun corriere, pubblica nel chatter e in un avviso di attenzione L'operatore ha risposto a … ma non ha restituito alcun corriere. La mappatura dei corrieri rimane opzionale per questa istanza. Lo spazio è l'endpoint che ha risposto.
Schema realizzato con codice, non una schermata di Odoo: il menu Marketplace, il pulsante per recuperare i corrieri Mirakl in Odoo 17, 18, 19 e 20, e a lato i messaggi che possono fermarlo
Schema realizzato con codice a partire dal codice pubblicato del modulo: menu, pulsante e due dei messaggi che possono comparire premendolo.

Cosa devi vedere quando va bene

L'avviso di successo compare solo quando, dopo aver elaborato la risposta, c'è almeno un corriere.

  • Un avviso a schermo con il titolo Corrieri Mirakl e il testo … corrieri disponibili da …. … mappatura/e aggiornata/e. Vedi il chatter per l'elenco completo. Gli spazi sono, nell'ordine, il numero di corrieri, l'endpoint che ha risposto e il numero di mappature aggiornate. L'avviso non resta fisso a schermo.
  • Apri il chatter dell'istanza: il modulo pubblica lì un messaggio con l'endpoint, quanti corrieri sono disponibili, l'elenco con il codice di ciascuno e il suo nome tra parentesi, e quante mappature dei corrieri sono state aggiornate.
  • Guarda di nuovo Endpoint corrieri di spedizione: se ha risposto un endpoint diverso da quello configurato, il campo ora ha il valore di quello che ha risposto.

Quando non va bene: cosa controllare in ogni caso

  • Impossibile recuperare i corrieri da Mirakl: … compare quando premi il pulsante e una richiesta fallisce con un errore che non è un 404. Cosa fare: leggi il dettaglio che segue i due punti, che è l'errore ricevuto. Se hai dubbi sulla connessione con Mirakl, vedi cosa fa il pulsante Prova connessione.
  • Formato di risposta imprevisto dall'endpoint dei corrieri Mirakl. compare quando premi il pulsante e la risposta arriva, ma il modulo non riesce a leggerla come elenco di corrieri. Cosa fare: controlla il valore di Endpoint corrieri di spedizione e ricorda cosa dice la sua guida, cioè che è l'endpoint SH21 per recuperare i corrieri di spedizione quando supportato dall'operatore.
  • Questo operatore non espone i corrieri Mirakl generici tramite SH21. Provati: …. compare nel chatter e in un avviso di attenzione quando nessun endpoint restituisce una risposta. Cosa fare: guarda quali endpoint figurano dopo «Provati:» e confrontali con Endpoint corrieri di spedizione.
  • L'operatore ha risposto a … ma non ha restituito alcun corriere. La mappatura dei corrieri rimane opzionale per questa istanza. compare nel chatter e in un avviso di attenzione quando non resta nessun corriere dopo aver elaborato la risposta. Cosa fare: il testo stesso dice che la mappatura dei corrieri resta opzionale per quell'istanza.
  • Se FlexigoTech Cloud non lascia passare la richiesta (senza abbonamento o con il servizio in pausa), l'azione si ferma e non viene segnato nulla: verifica che l'abbonamento sia attivo.

L'etichetta del pulsante in ogni lingua

Lingua di OdooEtichetta del pulsante
SpagnoloRecupera corrieri Mirakl
TedescoMirakl-Versanddienstleister abrufen
FranceseRécupérer les transporteurs Mirakl
ItalianoRecupera corrieri Mirakl
PortogheseObter Transportadoras Mirakl
Schema realizzato con codice, non una schermata di Odoo: l'etichetta del pulsante in spagnolo, tedesco, francese, italiano e portoghese
Schema realizzato con codice a partire dalle traduzioni pubblicate del modulo: come si chiama il pulsante secondo la lingua di Odoo.

Cosa ti serve e come ti aiuta FlexigoTech

Mirakl Connector è un modulo a pagamento unico per versione e richiede l'abbonamento a FlexigoTech Cloud: piano Connettore, 49 €/mese o 490 €/anno IVA esclusa, con fino a 3 account della piattaforma. Il prezzo di ogni versione di Odoo è nella scheda di Odoo Apps.

FlexigoTech implementa Odoo 17, 18, 19 e 20 e sviluppa connettori e integrazioni su misura. Se vuoi che controlliamo la tua istanza Mirakl, trovi la pagina del modulo.

Continua a leggere

Mirakl Connector: «Imposta la chiave API Mirakl prima di testare la connessione»Quando compare l'errore di chiave API vuota in Mirakl Connector per Odoo, quale condizione lo provoca e come risolverlo premendo Testa connessione.Mirakl Connector: «Questo collegamento non ha alcuna istanza Mirakl configurata.»Quando compare in Mirakl Connector l'avviso di collegamento senza istanza Mirakl configurata, quale condizione lo provoca e cosa fare quando appare.Cosa fa il pulsante Testa connessione di Mirakl Connector, passo per passoCosa fa il pulsante Testa connessione di Mirakl Connector in Odoo: quando compare, cosa controlla, cosa salva nella scheda e quali errori può dare.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti