Saltar para o conteúdo principal
Octopia (Cdiscount)

Declarar à Octopia no Odoo: checklist do botão, passo a passo

O botão Declarar à Octopia (Declare to Octopia) verifica que há volumes, que a encomenda não é de Fulfillment e que cada volume tem número e transportadora; se tudo bater certo, declara o envio à Octopia e marca a encomenda como enviada. Aqui tens o que ver antes, o que faz ao carregar e o que rever depois.

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

Antes de carregar: onde está o botão e o que o envio deve cumprir

O botão Declarar à Octopia (Declare to Octopia) está na mesma ficha que os campos Encomenda (Order), Transferência (Picking) e Volumes (Parcels). A vista não lhe põe nenhuma condição: vê-se sempre, no Odoo 17, 18, 19 e 20.

Esquema feito a partir do código do botão Declarar à Octopia, com algumas das mensagens que o podem travar e o estado error em que deixa a ficha
Esquema a partir do código do módulo, não um ecrã do Odoo: o botão, as mensagens que o travam e o estado error.

O que o botão verifica, por esta ordem

  • Há pelo menos um volume. Se a lista Volumes estiver vazia, o botão pára com Adicione pelo menos um volume. (Add at least one parcel.). É a primeira verificação.
  • A encomenda é das que expedes tu. No Odoo 20.0, se a encomenda trouxer indicado um modo de fornecimento que não é o do vendedor, o botão pára com As encomendas Fulfillment expedem-se sozinhas -- a declaração seria recusada (409) pela Octopia. (Fulfillment orders ship themselves -- declaring one would be refused (409) by Octopia.). Se o modo de fornecimento estiver vazio, esta verificação não trava nada.
  • Cada volume tem número de volume. Os volumes são revistos um a um; o primeiro sem número pára a ação com Cada volume precisa de um número de volume. (Every parcel needs a parcel number.).
  • Cada volume tem transportadora. Envia-se o nome da transportadora mapeada e, se não existir, o texto livre. Sem nenhum dos dois, surge Cada volume precisa de uma transportadora (mapeada ou texto livre). (Every parcel needs a carrier (mapped or free text).).

Se alguma destas verificações falhar, a ação pára nesse ponto: o registo de envio e a chamada à Octopia vêm depois.

Dados opcionais que seguem na declaração

  • Endereço de acompanhamento. Se um volume o tiver, é acrescentado à sua declaração; se não, o volume segue sem ele.
  • Linhas da encomenda. Se um volume tiver marcadas algumas linhas da encomenda, mas não todas, a declaração nomeia essas linhas. Se não tiver nenhuma marcada, ou tiver todas, não as detalha.
  • Transferência. Se a ficha trouxer transferência, o envio que se cria guarda-a.

As CGMAD do Cdiscount Marketplace (25/08/2025, p. 47) indicam que a confirmação de envio leva o número de seguimento.

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 ao carregar, passo a passo

No Odoo 20.0, depois de superadas as verificações, o botão faz isto, por esta ordem:

  1. Cria o registo de envio da encomenda, com os volumes preparados e a transferência, se existir.
  2. Toma a ligação da conta Octopia da encomenda e envia à Octopia a declaração de envio, com o identificador da encomenda na Octopia e os volumes.
  3. Se a Octopia devolver um erro da sua API, escreve no envio o estado error e, como mensagem, o texto do erro seguido do detalhe de erros que a resposta traga, e volta a lançar o mesmo erro. A ação termina com esse erro e a encomenda não é marcada como enviada.
  4. Se correr tudo bem, coloca o envio no estado sent com a data e hora de envio, marca a encomenda como enviada, deixa uma linha no registo de sincronização (tipo envios, resultado correto, com o identificador da encomenda e o número de volumes) e fecha a janela.

Com o Odoo em português de Portugal, o botão chama-se Declarar à Octopia; noutros idiomas muda o rótulo:

Esquema feito a partir do código com base nas traduções do módulo, com o texto do botão em cinco idiomas
Esquema a partir dos ficheiros de idioma do módulo, não um ecrã do Odoo: castelhano «Declarar a Octopia», alemão An Octopia melden, francês Déclarer à Octopia, italiano Dichiara a Octopia e português Declarar à Octopia.

Depois de carregar: o que verificar

  • A janela fechou-se: é o que o botão faz quando termina bem.
  • O envio está em sent e a encomenda figura como enviada.
  • Há uma linha nova no registo de sincronização, do tipo envios.
  • Se surgiu um erro da Octopia, lê o texto completo, que inclui o detalhe de erros da resposta, e corrige o que indicar antes de voltar a declarar.
  • Se a mensagem é uma das da primeira secção, a falha está nos dados da ficha: essas verificações fazem-se antes de criar o envio e de chamar a Octopia.

O que é preciso para o ter

O módulo é de pagamento único por versão e está publicado na Odoo Apps para 17, 18, 19 e 20; o preço de cada versão está na sua ficha da Odoo Apps. Além disso, precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA. A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas e vigia a sincronização.

Como te ajuda a FlexigoTech

Se estás a implementar o Odoo e queres deixar pronto o circuito de envios com a Octopia, na FlexigoTech implementamos o Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida.

Continue a ler

O que faz o botão «Abrir discussão» do Octopia Connector: mitos e realidadesO que faz o botão Abrir discussão do Octopia Connector no Odoo: quando se vê, o que verifica, o que muda e que erros dá, desmontando ideias erradas.O que faz o botão «Submeter à Octopia» das promoções, passo a passoComo funciona o botão Submeter à Octopia das promoções no Odoo: quando aparece, o que verifica, o que altera e que avisos pode dar.O que faz o botão «Submeter à Octopia» de um cancelamento, com um casoO que faz o botão Submeter à Octopia de um cancelamento no Odoo: quando aparece, o que verifica, o que muda e como resolver a mensagem de erro.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes