Saltar para o conteúdo principal
Octopia (Cdiscount)

«Cada volume precisa de um número de volume.» no Octopia Connector: quando aparece e como se resolve

A mensagem Cada volume precisa de um número de volume. (Every parcel needs a parcel number.) aparece ao clicar em Declarar à Octopia (Declare to Octopia) quando alguma linha de volume tem o número de volume vazio. Resolve-se preenchendo esse número em cada linha e voltando a clicar no botão: até lá não se cria o registo do envio nem se chama a Octopia.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 5 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
4 min

O que significa a mensagem e quando aparece

O que quer dizer Cada volume precisa de um número de volume.?

Que na janela a partir da qual declaras o envio de uma encomenda há pelo menos uma linha de volume com o número de volume vazio. O módulo não declara o envio à Octopia se algum volume for sem ele: o aviso interrompe a ação e daí não passa.

Quando aparece exatamente?

O módulo percorre as linhas de volume da janela, uma a seguir à outra. Em cada uma verifica se o número de volume está vazio; assim que encontra uma assim, lança a mensagem e para nesse ponto. Basta uma única linha vazia para que apareça, mesmo que todas as outras estejam completas. O código faz ainda outras verificações sobre a encomenda antes de percorrer as linhas e sobre cada linha depois desta. Esta mensagem só aparece quando o número de volume está vazio; se vires um texto diferente, a causa é outra.

Com que botão aparece?

Com Declarar à Octopia, o botão dessa mesma janela. No Odoo 17, 18, 19 e 20 o botão vê-se sempre, e a mensagem está no código publicado das quatro versões.

Esquema com o botão Declare to Octopia e, por baixo, a mensagem Every parcel needs a parcel number.
Esquema feito com código a partir do código publicado do módulo (Odoo 17, 18, 19 e 20), não uma captura do Odoo: o botão Declarar à Octopia e, por baixo, a mensagem, com os textos originais do código em inglês.

Como o vejo no meu Odoo?

Com o Odoo em português, a mensagem é Cada volume precisa de um número de volume. e o botão chama-se Declarar à Octopia. O módulo traz o mesmo texto traduzido para outros idiomas; a figura seguinte mostra a mensagem em castelhano, alemão, francês, italiano e português.

Esquema com a mensagem do número de volume em castelhano, alemão, francês, italiano e português
Esquema feito com código a partir das traduções publicadas do módulo, não uma captura do Odoo: a mesma mensagem em cinco idiomas, entre eles Cada volume precisa de um número de volume. em português.
48 business hours to accept each Cdiscount order. Do it in Odoo
Vídeo: 48 business hours to accept each Cdiscount order. Do it in Odoo (vídeo em inglês)

O que acontece quando aparece

Envia-se alguma coisa à Octopia ao ver a mensagem? Tem a ver com a ligação?

Não se envia nada. A mensagem interrompe a ação e não se guarda nada do que ia mudar. A verificação dos números de volume vem antes de criar o registo do envio, antes de preparar a ligação com a Octopia e antes de declarar o que quer que seja. Por isso não se cria o registo do envio, não se chama a Octopia e a encomenda não passa a enviada. Não é uma falha de ligação: é uma verificação do que está na janela. Podes corrigir a linha em falta e voltar a clicar em Declarar à Octopia sem que fique nada a meio.

O que se envia à Octopia quando todas as linhas passam a verificação?

Para cada volume, o módulo monta um dado com o número de volume e o nome da transportadora (o da transportadora mapeada ou, se não existir, o texto livre), e acrescenta o endereço de seguimento se a linha o tiver. Depois cria o registo do envio e declara o envio à Octopia. Se a declaração falhar, a ação para com o erro. Se não falhar, o módulo marca o registo do envio como enviado, passa a encomenda a enviada e deixa uma entrada no registo de sincronização do módulo. As CGMAD do Cdiscount Marketplace (p. 47) indicam que a confirmação de envio leva o número de seguimento; o que esta mensagem verifica é o número de volume de cada linha.

Como resolver

O que faço para que desapareça?

Revê uma a uma as linhas de volume da janela e confirma que todas têm o seu número de volume, incluindo a última. Quando não restar nenhuma vazia, clica de novo em Declarar à Octopia. Se houver vários volumes, cada um é uma linha e cada linha precisa do seu próprio número: preencher uma não serve para as outras. Enquanto uma linha continuar vazia, a ação para e não se declara nada.

E se a mensagem continuar a aparecer?

Então ainda há alguma linha com o número vazio. O módulo para na primeira que encontra, pelo que corrigir essa não garante que as seguintes estejam bem: revê-as todas antes de voltar a clicar. Se aparecer outra mensagem, trata-a em separado, porque esta só fala do número de volume.

Podem ajudar-me a implementar o Odoo com a Octopia?

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se a tua forma de declarar envios precisar de algo mais à medida, pode estudar-se como desenvolvimento.

Continue a ler

O que faz o botão «Submeter à Octopia» do Octopia Connector, passo a passoO que faz o botão Submeter à Octopia nas importações de faturas em massa: quando aparece, o que verifica, o que altera e o erro que pode dar.O que faz o botão «Importar» do Octopia Connector, passo a passoO que faz o botão Importar do Octopia Connector no Odoo: quando aparece, o que importa, o que muda, que aviso mostra e que entrada deixa no registo.O que faz o botão «Criar fatura de fornecedor» do Octopia ConnectorO que faz o botão Criar fatura de fornecedor do Octopia Connector no Odoo: quando aparece, o que verifica, o que cria e onde pode parar.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes