Vai al contenuto principale
Advanced Shipping Carrier

Errori di Advanced Shipping Carrier Integration in Odoo: cosa significano e cosa fare

I messaggi di errore di Advanced Shipping Carrier Integration indicano ciò che manca o ciò che non è consentito: una chiave API, un codice HS, una categoria di merce pericolosa, uno stato preciso del lotto o un permesso da amministratore. Sono i testi del modulo in Odoo 19 e 20 (in Odoo 17 e 18 il modulo pubblicato con questo nome è un altro prodotto), raggruppati per momento: il vettore, FlexigoTech Cloud con la chiave MyDHL e le spedizioni.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 4 novembre 2026

In breve

Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 20.0 · nelle fonti collegate in fondo
Lettura
6 min

Prima di iniziare: in quali versioni compaiono questi messaggi

Tutto quello che segue vale per Odoo 19 e 20. In Odoo 17 e 18 il modulo pubblicato con questo nome è un altro prodotto: la sua scheda lo presenta come multivettore, il suo codice chiama direttamente i vettori e non usa FlexigoTech Cloud. Per questo nessuno di questi messaggi si applica a quelle due versioni.

Errori durante la creazione e la connessione di un vettore

Sono i messaggi che riguardano il vettore in sé: le sue credenziali, il suo codice, la sua connessione e se si può eliminare.

Perché non riesco a salvare un vettore attivato?

Il modulo richiede le credenziali a ogni vettore attivato. Vedrai API Key and Secret are required for enabled carrier '{record.name}' oppure API Key is required for enabled carrier '{record.name}': il messaggio nomina il vettore e dice se manca solo la chiave API o anche il segreto. Compila ciò che viene richiesto e salva di nuovo. Se l'avviso è Code '{record.code}' must be unique within the company., il codice deve essere univoco all'interno dell'azienda: cambialo. E se il vettore è generico, Custom endpoint URL required for generic carriers significa che manca l'URL dell'endpoint personalizzato.

Cosa significano gli errori di connessione?

{self.name}: Connection timeout (>5s) indica che la connessione con quel vettore ha impiegato più di 5 secondi. {self.name}: Connection failed - {str(e)} dice che la connessione è fallita e aggiunge in coda l'errore tecnico: è quella parte finale che devi leggere. Se il vettore usa OAuth2, OAuth2 token refresh requires a configured carrier token endpoint adapter. segnala che aggiornare il token richiede un adattatore di endpoint del token configurato per quel vettore.

Perché non posso eliminare un vettore né cambiare il modo in cui si connette?

Con Cannot delete: {recent_shipments} shipments use this carrier in the last 90 days. Archive instead. il modulo ti dice quante spedizioni degli ultimi 90 giorni usano quel vettore e ti propone di archiviarlo invece di eliminarlo. L'altro messaggio è The connection of a carrier (direct, or through FlexigoTech Cloud) does not change: a carrier of another type is a new connection.: la connessione di un vettore, diretta o tramite FlexigoTech Cloud, non cambia. Se ti serve l'altra, crea un nuovo vettore.

Finestra Record Carrier Invoice sopra l'elenco delle spedizioni con vettore DHL Express, mese, anno, totale, pulsante per caricare il file e pulsanti Record Invoice e Cancel
La procedura guidata Record Carrier Invoice aperta sopra l'elenco delle spedizioni, con DHL Express come vettore.

FlexigoTech Cloud e la chiave MyDHL

Quali vettori funzionano tramite FlexigoTech Cloud?

Secondo i messaggi del modulo, solo DHL Express. Con un altro vettore vedrai Only DHL Express works through FlexigoTech Cloud: nothing was sent., Only DHL Express works through FlexigoTech Cloud. oppure %s does not work through FlexigoTech Cloud yet: only DHL Express does. Nothing was sent.. Anche con DHL Express ci sono richieste che non passano da questa via: This DHL request is not available through FlexigoTech Cloud: nothing was sent.. Diversi di questi testi confermano che non è stato inviato nulla (nothing was sent).

Cosa richiede il modulo prima di salvare la chiave MyDHL?

Se non hai accettato che il vettore funziona tramite FlexigoTech Cloud, compare Accept first that this carrier works through FlexigoTech Cloud: nothing was sent and nothing was saved.. E poiché la chiave API di MyDHL va insieme al segreto, Enter the MyDHL API key first: it goes with the secret. ti chiede di inserire prima la chiave. Il contrassegno di chiave salvata non si imposta a mano: Only Odoo marks a MyDHL key as saved in FlexigoTech Cloud, when an administrator saves it. chiarisce che lo imposta solo Odoo, quando un amministratore la salva.

Chi può eliminare la chiave MyDHL e cosa blocca finché esiste?

Only an administrator deletes the MyDHL key saved in FlexigoTech Cloud. indica che eliminare la chiave salvata spetta a un amministratore. Finché quella chiave esiste, This carrier has a MyDHL key saved in FlexigoTech Cloud for its environment: an administrator deletes it first. Nothing was changed. blocca la modifica che stavi tentando sul vettore. Chiedi a un amministratore di eliminare la chiave di quell'ambiente e ripeti la modifica; il messaggio conferma che non è stato modificato nulla.

Errori durante preventivo, creazione, etichetta e tracking delle spedizioni

Perché una spedizione non viene quotata, non si crea o non stampa l'etichetta?

Parti dal vettore. No enabled carriers configured. Please configure at least one carrier. richiede almeno un vettore attivato; No carrier configured e No carrier is configured for this shipment. dicono che manca il vettore, il secondo in quella specifica spedizione. Se la spedizione è bloccata, il modulo non la quota (Blocked shipments cannot be quoted.), non la crea (Blocked shipments cannot be created.) e non ne stampa l'etichetta (Cannot print label for a blocked shipment.). E Failed to obtain tracking number from carrier indica che non è stato ottenuto il numero di tracciamento dal vettore.

Sequenza con la procedura guidata Bulk Print Labels e due spedizioni DHL Express selezionate, la finestra Create Return su una spedizione in stato Delivered e la finestra Record Carrier Invoice
Dalla procedura guidata Bulk Print Labels alla finestra Record Carrier Invoice, passando per Create Return.

Quali dati richiede una spedizione internazionale o con merce pericolosa?

Il codice HS compare in due messaggi: HS code is required before creating an international shipment. lo richiede prima di creare una spedizione internazionale e HS code is required to generate customs documents. per generare i documenti doganali. Completalo prima di ripetere l'azione. Per la merce pericolosa, Hazmat category is required for hazardous shipments. richiede la categoria hazmat, e Selected carrier does not support hazardous materials. dice che il vettore selezionato non ammette materiali pericolosi: controlla quale vettore gestisce quella spedizione.

Procedura guidata Export Intrastat con mese e anno, testo esplicativo del CSV e pulsanti Export e Cancel sopra l'elenco delle spedizioni DHL Express negli stati Ready to Ship e Delivered
La procedura guidata Export Intrastat sopra l'elenco delle spedizioni DHL Express in Ready to Ship e Delivered.

Perché non posso eliminare una spedizione o un'etichetta?

A shipment that went to the carrier cannot be deleted. protegge le spedizioni che sono andate al vettore e A generated label cannot be deleted. protegge le etichette già generate.

Finestra Create Return sul modulo di una spedizione in stato Delivered con spedizione originale, vettore, tipo di servizio, casella Email Customer e note di reso
La finestra Create Return su una spedizione in stato Delivered.

Quali errori danno i lotti, il webhook e le impostazioni in giorni?

Nei lotti, Batch job can only be executed from Draft or Paused status significa che il lotto si esegue solo da Draft o Paused, e Batch job failed: {str(e)} che l'esecuzione è fallita, con l'errore tecnico in coda. Nel webhook, Webhook payload is missing a tracking number. dice che quanto ricevuto non contiene un numero di tracciamento e No shipment found for tracking number %s. che quel numero non corrisponde ad alcuna spedizione. Nelle impostazioni, %s must be a number of days above 0. richiede un numero di giorni maggiore di 0.

Se il messaggio non ti basta

Se vuoi vedere dove si incastra ogni pezzo prima di toccare qualcosa, trovi la messa in funzione del modulo e come funziona al suo interno. Nella scheda di Odoo Apps costa 9 € per versione di Odoo (17, 18, 19 e 20), pagamento una tantum IVA esclusa; in Odoo 19 e 20 richiede inoltre l'abbonamento a FlexigoTech Cloud, con il piano Connettore a 49 €/mese o 490 €/anno IVA esclusa. Trovi maggiori dettagli nella sua pagina su flexigotech.com. In FlexigoTech implementiamo Odoo 17, 18, 19 e 20 e sviluppiamo connettori e integrazioni su misura, nel caso il tuo caso richieda qualcosa di diverso.

Continua a leggere

Come funziona Advanced Shipping Carrier Integration in Odoo 19 e 20: menu, attività e recordQuali menu aggiunge Advanced Shipping Carrier Integration in Odoo 19 e 20, quali azioni pianificate girano e ogni quanto, e quali record usa una spedizione.Advanced Shipping Carrier Integration: quello che nessuno ti dice alla messa in funzioneQuali campi compilare registrando un vettore in Advanced Shipping Carrier Integration, quali stati vedrai e cosa controllare durante la prima settimana.Advanced Shipping Carrier Integration: miti e realtà prima di decidereCosa copre e cosa no Advanced Shipping Carrier Integration in Odoo 19 e 20: DHL Express via FlexigoTech Cloud, costi, esclusioni e perché 17 e 18 sono diversi.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti