Saltar para o conteúdo principal
Octopia (Cdiscount)

O que faz o botão «Submeter à Octopia» do Octopia Connector, passo a passo

O botão Submeter à Octopia (Submit to Octopia) envia para a Octopia, num único pedido, os PDF das faturas de cliente validadas de uma importação de faturas em massa. Vê-se enquanto a importação não tem ID da importação (Import ID) e, se nenhuma fatura cumprir as condições, pára com uma única mensagem e não grava nada.

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
5 min

Onde está o botão e quando se vê

As importações de faturas em massa abrem-se a partir de Octopia › Finanças › Importações de faturas em massa (Octopia › Finance › Bulk Invoice Imports). O primeiro nível, Octopia, exige a permissão Utilizador Octopia (Octopia User): se não a tiver, não vê esse nível do menu.

O botão Submeter à Octopia está na ficha da importação e existe nas versões 17, 18, 19 e 20 do Odoo.

Esquema feito com código, não é um ecrã do Odoo: de cima para baixo, o menu das importações de faturas em massa e o botão Submit to Octopia, com a mensagem que o pode travar ao lado
Esquema gerado a partir do código publicado do módulo, com as legendas originais em inglês: o menu, o botão (Odoo 17, 18, 19 e 20) e a mensagem que o pode travar.

Com o Odoo em português de Portugal o botão chama-se Submeter à Octopia; noutros idiomas a legenda muda, como mostra este outro esquema.

Esquema feito com código, não é um ecrã do Odoo: o texto Submit to Octopia em castelhano, alemão, francês, italiano e português
Esquema a partir das traduções publicadas do módulo: em castelhano, Enviar a Octopia; em alemão, An Octopia übermitteln; em francês, Soumettre à Octopia; em italiano, Invia a Octopia; em português, Submeter à Octopia.

Na ficha vai ver três campos que importam para este botão:

  • Conta (Account): vê-se na ficha e na lista de importações.
  • Faturas (Invoices): vê-se na ficha.
  • ID da importação (Import ID): vê-se na ficha e na lista, só de leitura. Não o escreve você: é o próprio botão que o preenche.

A regra de visibilidade é curta: o botão fica oculto quando ID da importação tem valor. Com o campo vazio, o botão vê-se.

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)

Passo a passo: o que faz ao clicar

No Odoo 20.0, ao clicar, o botão faz o seguinte.

  1. Abre a importação. Entre pelo menu acima e abra a ficha. Veja Conta e Faturas: o botão trabalha com as faturas desse campo e com a conta da ficha.
  2. Verifica que o botão se vê. Se ID da importação já tem valor, o botão não aparece. E se a ação for lançada sobre uma importação que já o tem, o código ignora-a sem lhe tocar.
  3. Clique em Submeter à Octopia. Das faturas de Faturas, o botão fica só com as que estão validadas, são faturas de cliente e estão associadas a uma encomenda da Octopia. As que não cumprem alguma das três condições ficam fora do envio sem aviso, desde que pelo menos uma as cumpra. Se não sobrar nenhuma, a ação pára com a mensagem da secção seguinte e não se grava nada do que ia mudar.
  4. Gera-se um PDF por fatura. Cada ficheiro tem o nome da fatura, com a barra / substituída por um sublinhado e a extensão .pdf. Se a fatura não tiver nome, o ficheiro chama-se invoice.pdf.
  5. Envia-se tudo para a Octopia num único pedido. Os PDF seguem anexados como ficheiros, usando a ligação da Conta da ficha.
  6. Guarda-se a referência. O que se segue escreve-se depois de fazer o pedido. Se a resposta da Octopia trouxer um identificador de importação, fica guardado em ID da importação; se não o trouxer, o campo fica vazio. A importação passa a estar marcada como em curso e regista-se a data e a hora do envio.
  7. Marcam-se as faturas e as encomendas. Cada fatura enviada fica marcada como enviada para a Octopia, com data e hora, e cada encomenda da Octopia associada a essas faturas fica marcada com a fatura enviada, também com data e hora.
  8. Fica registo do envio. O módulo acrescenta uma entrada ao registo de sincronização da conta, com a referência da importação (um ponto de interrogação se não existir) e o número de faturas enviadas.

A mensagem que pode aparecer

Ao clicar em Submeter à Octopia, o botão pode parar com esta mensagem:

Selecione pelo menos uma fatura de cliente VALIDADA associada a uma encomenda Octopia. (Select at least one POSTED customer invoice linked to an Octopia order.)

Aparece quando, entre as Faturas da ficha, nenhuma cumpre ao mesmo tempo as três condições: estar validada, ser fatura de cliente e estar associada a uma encomenda da Octopia. Quando aparece, não se envia nada e não se altera nada: nem ID da importação, nem as marcas das faturas e das encomendas, nem a entrada de registo.

O que fazer:

  • Abra a lista de Faturas da ficha e verifique uma a uma se estão validadas, e não em rascunho.
  • Confirme que são faturas de cliente.
  • Confirme que alguma está associada a uma encomenda da Octopia.
  • Volte a clicar no botão quando pelo menos uma cumprir as três.

O que verificar depois

  • ID da importação já tem valor e o botão desapareceu da ficha. É o sinal de que a importação foi enviada.
  • Se ID da importação ficou vazio, segundo o código a resposta da Octopia não trazia identificador. Como o botão só se oculta quando esse campo tem valor, continuará visível; antes de voltar a clicar, tenha presente que as faturas e as encomendas já ficaram marcadas como enviadas nesse clique.

Se quiser ver outros botões do módulo explicados com o mesmo método, tem Importar e Criar fatura de fornecedor.

Como se articula com a subscrição e com a FlexigoTech

O módulo compra-se uma vez por versão do Odoo (está publicado para 17, 18, 19 e 20, na sua ficha do Odoo Apps) e precisa da subscrição da FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA. A ligação à Octopia passa pela FlexigoTech Cloud, que guarda as credenciais cifradas e avisa por e-mail se a sincronização falhar.

Se estiver a implementar o Odoo e quiser que o circuito de faturas com a Octopia fique bem montado, ou precisar de uma integração à medida, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

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.Os campos de Oferta da Octopia no Odoo: glossário do Octopia ConnectorGlossário dos campos de Oferta do Octopia Connector no Odoo: o que diz a ajuda de cada um, quais são só de leitura e o que preencher ao publicar.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes