Salta al contingut principal
Advanced Shipping Carrier

Errors d'Advanced Shipping Carrier Integration a Odoo: què signifiquen i què fer

Els missatges d'error d'Advanced Shipping Carrier Integration anomenen allò que falta o allò que no es permet: una clau API, un codi HS, una categoria de mercaderia perillosa, un estat concret del lot o un permís d'administrador. Són els textos del mòdul a Odoo 19 i 20 (a Odoo 17 i 18 el mòdul publicat amb aquest nom és un altre producte), agrupats per moment: el transportista, FlexigoTech Cloud amb la clau MyDHL i els enviaments.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 4 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
6 min

Abans de començar: a quines versions surten aquests missatges

Tot el que segueix val per a Odoo 19 i 20. A Odoo 17 i 18 el mòdul publicat amb aquest nom és un altre producte: la seva fitxa el presenta com a multitransportista, el seu codi crida directament els transportistes i no fa servir FlexigoTech Cloud. Per això cap d'aquests missatges s'aplica a aquestes dues versions.

Errors en donar d'alta i connectar un transportista

Són els missatges que parlen del transportista en si: les seves credencials, el seu codi, la seva connexió i si es pot esborrar.

Per què no em deixa desar un transportista activat?

El mòdul demana credencials a tot transportista activat. Veuràs API Key and Secret are required for enabled carrier '{record.name}' o API Key is required for enabled carrier '{record.name}': el missatge anomena el transportista i diu si falta només la clau API o també el secret. Omple el que demana i torna a desar. Si l'avís és Code '{record.code}' must be unique within the company., el codi ha de ser únic dins de l'empresa: canvia'l. I si el transportista és genèric, Custom endpoint URL required for generic carriers vol dir que falta l'URL de l'endpoint propi.

Què signifiquen els errors de connexió?

{self.name}: Connection timeout (>5s) indica que la connexió amb aquest transportista ha trigat més de 5 segons. {self.name}: Connection failed - {str(e)} diu que la connexió ha fallat i afegeix darrere l'error tècnic: aquesta part final és la que has de llegir. Si el transportista fa servir OAuth2, OAuth2 token refresh requires a configured carrier token endpoint adapter. avisa que refrescar el token exigeix un adaptador d'endpoint de token configurat per a aquest transportista.

Per què no puc esborrar un transportista ni canviar com es connecta?

Amb Cannot delete: {recent_shipments} shipments use this carrier in the last 90 days. Archive instead. el mòdul et diu quants enviaments dels últims 90 dies fan servir aquest transportista i et proposa arxivar-lo en lloc d'esborrar-lo. L'altre missatge és The connection of a carrier (direct, or through FlexigoTech Cloud) does not change: a carrier of another type is a new connection.: la connexió d'un transportista, directa o a través de FlexigoTech Cloud, no canvia. Si necessites l'altra, dones d'alta un transportista nou.

Diàleg Record Carrier Invoice sobre la llista d'enviaments amb transportista DHL Express, mes, any, total, botó per pujar fitxer i botons Record Invoice i Cancel
L'assistent Record Carrier Invoice obert sobre la llista d'enviaments, amb DHL Express com a transportista.

FlexigoTech Cloud i la clau MyDHL

Quins transportistes funcionen a través de FlexigoTech Cloud?

Segons els missatges del mòdul, només DHL Express. Amb un altre transportista veuràs Only DHL Express works through FlexigoTech Cloud: nothing was sent., Only DHL Express works through FlexigoTech Cloud. o %s does not work through FlexigoTech Cloud yet: only DHL Express does. Nothing was sent.. Fins i tot amb DHL Express hi ha peticions que no passen per aquesta via: This DHL request is not available through FlexigoTech Cloud: nothing was sent.. Diversos d'aquests textos confirmen que no s'ha enviat res (nothing was sent).

Què demana el mòdul abans de desar la clau MyDHL?

Si no has acceptat que el transportista funciona a través de FlexigoTech Cloud, surt Accept first that this carrier works through FlexigoTech Cloud: nothing was sent and nothing was saved.. I com que la clau API de MyDHL va juntament amb el secret, Enter the MyDHL API key first: it goes with the secret. et demana escriure primer la clau. La marca de clau desada no es posa a mà: Only Odoo marks a MyDHL key as saved in FlexigoTech Cloud, when an administrator saves it. deixa clar que només Odoo la marca, quan un administrador la desa.

Qui pot esborrar la clau MyDHL i què bloqueja mentre existeix?

Only an administrator deletes the MyDHL key saved in FlexigoTech Cloud. indica que esborrar la clau desada és cosa d'un administrador. Mentre aquesta clau existeixi, This carrier has a MyDHL key saved in FlexigoTech Cloud for its environment: an administrator deletes it first. Nothing was changed. frena el canvi que intentaves al transportista. Demana a un administrador que esborri la clau d'aquest entorn i repeteix el canvi; el missatge confirma que no s'ha modificat res.

Errors en cotitzar, crear, etiquetar i seguir enviaments

Per què un enviament no es cotitza, no es crea o no imprimeix etiqueta?

Comença pel transportista. No enabled carriers configured. Please configure at least one carrier. demana almenys un transportista activat; No carrier configured i No carrier is configured for this shipment. diuen que falta transportista, el segon en aquest enviament concret. Si l'enviament està bloquejat, el mòdul no el cotitza (Blocked shipments cannot be quoted.), no el crea (Blocked shipments cannot be created.) ni n'imprimeix l'etiqueta (Cannot print label for a blocked shipment.). I Failed to obtain tracking number from carrier indica que no s'ha obtingut número de seguiment del transportista.

Seqüència amb l'assistent Bulk Print Labels i dos enviaments DHL Express seleccionats, el diàleg Create Return sobre un enviament en estat Delivered i el diàleg Record Carrier Invoice
De l'assistent Bulk Print Labels al diàleg Record Carrier Invoice, passant per Create Return.

Quines dades demana un enviament internacional o amb mercaderia perillosa?

El codi HS apareix en dos missatges: HS code is required before creating an international shipment. el demana abans de crear un enviament internacional i HS code is required to generate customs documents. per generar els documents de duana. Completa'l abans de repetir l'acció. Per a mercaderia perillosa, Hazmat category is required for hazardous shipments. demana la categoria hazmat, i Selected carrier does not support hazardous materials. diu que el transportista seleccionat no admet materials perillosos: revisa quin transportista porta aquest enviament.

Assistent Export Intrastat amb mes i any, text explicatiu del CSV i botons Export i Cancel sobre la llista d'enviaments DHL Express en estats Ready to Ship i Delivered
L'assistent Export Intrastat sobre la llista d'enviaments DHL Express en Ready to Ship i Delivered.

Per què no puc esborrar un enviament o una etiqueta?

A shipment that went to the carrier cannot be deleted. protegeix els enviaments que han anat al transportista i A generated label cannot be deleted. protegeix les etiquetes ja generades.

Diàleg Create Return sobre el formulari d'un enviament en estat Delivered amb enviament original, transportista, tipus de servei, casella Email Customer i notes de devolució
El diàleg Create Return sobre un enviament en estat Delivered.

Quins errors donen els lots, el webhook i els ajustos en dies?

En els lots, Batch job can only be executed from Draft or Paused status vol dir que el lot només s'executa des de Draft o Paused, i Batch job failed: {str(e)} que l'execució ha fallat, amb l'error tècnic al darrere. Al webhook, Webhook payload is missing a tracking number. diu que el que s'ha rebut no porta número de seguiment i No shipment found for tracking number %s. que aquest número no correspon a cap enviament. Als ajustos, %s must be a number of days above 0. demana un nombre de dies més gran que 0.

Si el missatge no et basta

Si vols veure on encaixa cada peça abans de tocar res, tens la posada en marxa del mòdul i com funciona per dins. A la fitxa d'Odoo Apps costa 9 € per versió d'Odoo (17, 18, 19 i 20), pagament únic sense IVA; a Odoo 19 i 20 necessita a més la subscripció a FlexigoTech Cloud, amb el pla Connector a 49 €/mes o 490 €/any sense IVA. Tens més detall a la seva pàgina a flexigotech.com. A FlexigoTech implantem Odoo 17, 18, 19 i 20 i desenvolupem connectors i integracions a mida, per si el teu cas demana alguna cosa diferent.

Continua llegint

Com funciona Advanced Shipping Carrier Integration a Odoo 19 i 20: menús, tasques i registresQuins menús afegeix Advanced Shipping Carrier Integration a Odoo 19 i 20, quines tasques programades s'executen i cada quan, i quins registres fa servir un enviament.Advanced Shipping Carrier Integration: el que no et expliquen en posar-lo en marxaQuins camps omplir en donar d'alta un transportista a Advanced Shipping Carrier Integration, quins estats veuràs i què revisar la primera setmana.Advanced Shipping Carrier Integration: mites i realitats abans de decidirQuè cobreix i què no Advanced Shipping Carrier Integration a Odoo 19 i 20: DHL Express via FlexigoTech Cloud, què costa, què queda fora i per què 17 i 18 difereixen.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts