Saltar para o conteúdo principal
Advanced Shipping Carrier

Erros do Advanced Shipping Carrier Integration no Odoo: o que significam e o que fazer

As mensagens de erro do Advanced Shipping Carrier Integration indicam o que falta ou o que não é permitido: uma chave API, um código HS, uma categoria de mercadoria perigosa, um estado concreto do lote ou uma permissão de administrador. São os textos do módulo no Odoo 19 e 20 (no Odoo 17 e 18 o módulo publicado com este nome é outro produto), agrupados por momento: a transportadora, o FlexigoTech Cloud com a chave MyDHL e os envios.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 de novembro de 2026

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
6 min

Antes de começar: em que versões surgem estas mensagens

Tudo o que se segue vale para o Odoo 19 e 20. No Odoo 17 e 18 o módulo publicado com este nome é outro produto: a sua ficha apresenta-o como multitransportadora, o seu código chama diretamente as transportadoras e não usa o FlexigoTech Cloud. Por isso, nenhuma destas mensagens se aplica a essas duas versões.

Erros ao registar e ligar uma transportadora

São as mensagens que falam da própria transportadora: as suas credenciais, o seu código, a sua ligação e se pode ser eliminada.

Porque não me deixa guardar uma transportadora ativada?

O módulo exige credenciais a qualquer transportadora ativada. Verá API Key and Secret are required for enabled carrier '{record.name}' ou API Key is required for enabled carrier '{record.name}': a mensagem indica a transportadora e diz se falta apenas a chave API ou também o segredo. Preencha o que pede e volte a guardar. Se o aviso for Code '{record.code}' must be unique within the company., o código tem de ser único dentro da empresa: altere-o. E se a transportadora for genérica, Custom endpoint URL required for generic carriers significa que falta o URL do endpoint próprio.

O que significam os erros de ligação?

{self.name}: Connection timeout (>5s) indica que a ligação a essa transportadora demorou mais de 5 segundos. {self.name}: Connection failed - {str(e)} diz que a ligação falhou e acrescenta a seguir o erro técnico: é essa parte final que tem de ler. Se a transportadora usar OAuth2, OAuth2 token refresh requires a configured carrier token endpoint adapter. avisa de que renovar o token exige um adaptador de endpoint de token configurado para essa transportadora.

Porque não posso eliminar uma transportadora nem alterar a forma como se liga?

Com Cannot delete: {recent_shipments} shipments use this carrier in the last 90 days. Archive instead. o módulo diz-lhe quantos envios dos últimos 90 dias usam essa transportadora e propõe arquivá-la em vez de a eliminar. A outra mensagem é The connection of a carrier (direct, or through FlexigoTech Cloud) does not change: a carrier of another type is a new connection.: a ligação de uma transportadora, direta ou através do FlexigoTech Cloud, não muda. Se precisar da outra, crie uma transportadora nova.

Diálogo Record Carrier Invoice sobre a lista de envios com transportadora DHL Express, mês, ano, total, botão para carregar ficheiro e botões Record Invoice e Cancel
O assistente Record Carrier Invoice aberto sobre a lista de envios, com a DHL Express como transportadora.

FlexigoTech Cloud e a chave MyDHL

Que transportadoras funcionam através do FlexigoTech Cloud?

Segundo as mensagens do módulo, apenas a DHL Express. Com outra transportadora verá Only DHL Express works through FlexigoTech Cloud: nothing was sent., Only DHL Express works through FlexigoTech Cloud. ou %s does not work through FlexigoTech Cloud yet: only DHL Express does. Nothing was sent.. Mesmo com a DHL Express há pedidos que não passam por essa via: This DHL request is not available through FlexigoTech Cloud: nothing was sent.. Vários destes textos confirmam que não foi enviado nada (nothing was sent).

O que pede o módulo antes de guardar a chave MyDHL?

Se não aceitou que a transportadora funciona através do FlexigoTech Cloud, surge Accept first that this carrier works through FlexigoTech Cloud: nothing was sent and nothing was saved.. E como a chave API da MyDHL vai com o segredo, Enter the MyDHL API key first: it goes with the secret. pede-lhe que escreva primeiro a chave. A marca de chave guardada não se define manualmente: Only Odoo marks a MyDHL key as saved in FlexigoTech Cloud, when an administrator saves it. deixa claro que só o Odoo a marca, quando um administrador a guarda.

Quem pode eliminar a chave MyDHL e o que bloqueia enquanto existe?

Only an administrator deletes the MyDHL key saved in FlexigoTech Cloud. indica que eliminar a chave guardada é tarefa de um administrador. Enquanto essa chave existir, This carrier has a MyDHL key saved in FlexigoTech Cloud for its environment: an administrator deletes it first. Nothing was changed. trava a alteração que tentava fazer na transportadora. Peça a um administrador que elimine a chave desse ambiente e repita a alteração; a mensagem confirma que não foi modificado nada.

Erros ao cotar, criar, etiquetar e seguir envios

Porque um envio não é cotado, não é criado ou não imprime etiqueta?

Comece pela transportadora. No enabled carriers configured. Please configure at least one carrier. pede pelo menos uma transportadora ativada; No carrier configured e No carrier is configured for this shipment. dizem que falta transportadora, a segunda nesse envio concreto. Se o envio estiver bloqueado, o módulo não o cota (Blocked shipments cannot be quoted.), não o cria (Blocked shipments cannot be created.) nem imprime a sua etiqueta (Cannot print label for a blocked shipment.). E Failed to obtain tracking number from carrier indica que não foi obtido número de seguimento da transportadora.

Sequência com o assistente Bulk Print Labels e dois envios DHL Express selecionados, o diálogo Create Return sobre um envio no estado Delivered e o diálogo Record Carrier Invoice
Do assistente Bulk Print Labels ao diálogo Record Carrier Invoice, passando por Create Return.

Que dados pede um envio internacional ou com mercadoria perigosa?

O código HS aparece em duas mensagens: HS code is required before creating an international shipment. pede-o antes de criar um envio internacional e HS code is required to generate customs documents. para gerar os documentos de alfândega. Preencha-o antes de repetir a ação. Para mercadoria perigosa, Hazmat category is required for hazardous shipments. pede a categoria hazmat, e Selected carrier does not support hazardous materials. diz que a transportadora selecionada não admite materiais perigosos: verifique que transportadora leva esse envio.

Assistente Export Intrastat com mês e ano, texto explicativo do CSV e botões Export e Cancel sobre a lista de envios DHL Express nos estados Ready to Ship e Delivered
O assistente Export Intrastat sobre a lista de envios DHL Express em Ready to Ship e Delivered.

Porque não posso eliminar um envio ou uma etiqueta?

A shipment that went to the carrier cannot be deleted. protege os envios que foram para a transportadora e A generated label cannot be deleted. protege as etiquetas já geradas.

Diálogo Create Return sobre o formulário de um envio no estado Delivered com envio original, transportadora, tipo de serviço, caixa Email Customer e notas de devolução
O diálogo Create Return sobre um envio no estado Delivered.

Que erros dão os lotes, o webhook e as definições em dias?

Nos lotes, Batch job can only be executed from Draft or Paused status significa que o lote só se executa a partir de Draft ou Paused, e Batch job failed: {str(e)} que a execução falhou, com o erro técnico a seguir. No webhook, Webhook payload is missing a tracking number. diz que o que foi recebido não traz número de seguimento e No shipment found for tracking number %s. que esse número não corresponde a nenhum envio. Nas definições, %s must be a number of days above 0. pede um número de dias superior a 0.

Se a mensagem não for suficiente

Se quiser ver onde encaixa cada peça antes de mexer em alguma coisa, tem a colocação em funcionamento do módulo e como funciona por dentro. Na ficha do Odoo Apps custa 9 € por versão do Odoo (17, 18, 19 e 20), pagamento único sem IVA; no Odoo 19 e 20 precisa ainda da subscrição do FlexigoTech Cloud, com o plano Conector a 49 €/mês ou 490 €/ano sem IVA. Tem mais detalhe na sua página em flexigotech.com. Na FlexigoTech implementamos Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida, caso o seu caso peça algo diferente.

Continue a ler

Como funciona o Advanced Shipping Carrier Integration no Odoo 19 e 20: menus, tarefas e registosQue menus acrescenta o Advanced Shipping Carrier Integration no Odoo 19 e 20, que tarefas agendadas correm e com que frequência, e que registos usa um envio.Advanced Shipping Carrier Integration: o que não te contam ao arrancarQue campos preencher ao registar uma transportadora no Advanced Shipping Carrier Integration, que estados vais ver e o que rever na primeira semana.Advanced Shipping Carrier Integration: mitos e realidades antes de decidirO que cobre e o que não cobre o Advanced Shipping Carrier Integration no Odoo 19 e 20: DHL Express via FlexigoTech Cloud, custos, exclusões e porque o 17 e o 18 diferem.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes