Quando surge exatamente esta mensagem
A mensagem Cada volume precisa de uma transportadora (mapeada ou texto livre). (Every parcel needs a carrier (mapped or free text).) surge ao clicar no botão Declarar à Octopia (Declare to Octopia) do assistente com que se declara o envio de uma encomenda. Esse botão vê-se sempre, no Odoo 17, 18, 19 e 20, e a mensagem está no código publicado das quatro versões. A condição descrita a seguir é a do código do Odoo 20.0.


O que significa: a condição do código
Ao clicar no botão, o módulo percorre uma a uma as linhas de volume do assistente. Para cada linha decide que nome de transportadora vai declarar: toma o nome (a etiqueta) da transportadora mapeada da Octopia, se existir, e, se não existir, o texto livre escrito na linha. Se depois disso não ficar nenhum nome, lança a mensagem. Dito de forma simples: cada volume precisa de pelo menos uma das duas coisas, uma transportadora mapeada com nome ou um texto livre.
| Situação da linha de volume | Resultado ao clicar em Declarar à Octopia |
|---|---|
| Tem uma transportadora mapeada da Octopia com nome | Passa esta verificação: usa-se esse nome e o texto livre já não conta |
| O mapeamento está vazio (ou sem nome) e há texto livre | Passa esta verificação: usa-se o texto livre |
| Não tem nem uma coisa nem outra | Surge a mensagem e a ação é interrompida |
A verificação segue a ordem das linhas e pára na primeira que falha. Se vários volumes estiverem sem transportadora, corrigir um pode devolver-te a mesma mensagem pelo seguinte.
É um erro que interrompe a ação: não se guarda nada do que a declaração ia alterar. Surge antes de o módulo criar o registo de envio e antes de chamar a Octopia, pelo que nada é declarado e a encomenda não passa a enviada.
Com o Odoo em português de Portugal vês Cada volume precisa de uma transportadora (mapeada ou texto livre).. O esquema seguinte reúne esse mesmo texto junto com as suas traduções publicadas em espanhol, alemão, francês e italiano.

Como resolver, passo a passo
- Abre o assistente de declaração da encomenda, o que contém o botão
Declarar à Octopia, e revê as respetivas linhas de volume. - Em cada linha, indica a transportadora de uma destas duas formas: com uma transportadora mapeada da Octopia ou com o respetivo nome em texto livre.
- Se indicaste uma transportadora mapeada e a mensagem persiste, verifica se essa transportadora tem nome: o módulo lê a etiqueta e, se estiver vazia, trata-a como se não houvesse transportadora. Nesse caso, escolhe outra mapeada ou escreve o nome em texto livre.
- Revê todas as linhas, não só a primeira: a verificação pára na primeira que falha, e as seguintes podem estar iguais.
- Clica de novo em
Declarar à Octopia. - Se a Octopia aceitar a declaração, o assistente fecha. Se a Octopia rejeitar a chamada, o módulo lança um erro e o assistente não fecha.
O que faz o módulo quando a transportadora já está correta
Superada a verificação, o módulo prepara cada volume com o seu número, o nome da transportadora (a mapeada ou o texto livre) e, se a linha o tiver, o URL de seguimento. Se um volume cobrir apenas parte das linhas da encomenda, acrescenta à declaração quais são. As CGMAD do Cdiscount Marketplace (25/08/2025, p. 47) indicam que a confirmação de envio leva o número de seguimento.
Depois cria um registo de envio e declara o envio à Octopia com a conta da encomenda. Se a Octopia o aceitar, o registo fica como enviado com a respetiva data, a encomenda é marcada como enviada e o módulo regista uma entrada de sucesso no seu registo de sincronização. Se for a Octopia a rejeitar a declaração, já não é esta mensagem: o registo de envio fica em estado de erro com o texto da falha.
O que verificar depois
- Que o assistente fechou sem mostrar nenhum aviso.
- Que a encomenda consta como enviada.
- Que há uma entrada de sucesso de envios no registo de sincronização do módulo.
Custo e ajuda
O conector é de pagamento único por versão do Odoo (publicado para 17, 18, 19 e 20) e requer a subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA.
A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se as tuas transportadoras precisarem de um tratamento próprio ao declarar envios, escreve-nos e vemos o caso.
Continue a ler
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- Código do módulo: flexigobe_octopia_connector 20.0 (4848da6a): wizard/octopia_shipment_wizard.py
- Código do módulo: flexigobe_octopia_connector 20.0 (4848da6a): views/octopia_completeness2_views.xml
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
- marketplace.cdiscount.com/wp-content/uploads/2025/08/2025.08.25-CGMAD-FR.pdf
- flexigotech.com/en/services.html
- flexigotech.com/precios.html
