Saltar para o conteúdo principal
Octopia (Cdiscount)

O que faz o botão «Submeter à Octopia» das devoluções FFM

O botão Submeter à Octopia (Submit to Octopia) está na ficha das devoluções FFM e cria a devolução na Octopia com os dados dessa ficha. Só aparece enquanto a devolução não tem ID da devolução (Return ID) e para com Uma devolução precisa de pelo menos uma linha. (A return needs at least one line.) se a ficha não tiver linhas.

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

Onde está o botão e quando aparece

As fichas de devolução abrem-se a partir do menu Octopia › Fulfillment › Devoluções (Octopia › Fulfillment › Returns). O separador Octopia exige a permissão Utilizador Octopia (Octopia User): se não a tiver, não vê esse separador. No ecrã Devoluções FFM (FFM Returns) está o botão, e está nas quatro versões publicadas do módulo: Odoo 17, 18, 19 e 20.

Esquema do menu Octopia, Fulfillment, Returns e do botão Submit to Octopia, com a mensagem que o pode parar ao lado
Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo: o menu, o botão (Odoo 17, 18, 19 e 20) e a mensagem que o pode parar.

O botão tem uma única condição de visibilidade: oculta-se quando o campo ID da devolução tem valor. Com os valores por defeito esse campo está vazio, por isso o botão vê-se. Dito ao contrário: uma devolução que já tem ID da devolução deixa de oferecer o botão.

Com o Odoo em português de Portugal o botão chama-se Submeter à Octopia. Assim se lê em cada idioma com tradução publicada:

Esquema com o texto do botão Submit to Octopia consoante o idioma do Odoo: espanhol, 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.
Idioma do OdooRótulo do botão
EspanholSubmeter à Octopia
AlemãoAn Octopia übermitteln
FrancêsSoumettre à Octopia
ItalianoInvia a Octopia
PortuguêsSubmeter à Octopia
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)

Um caso para acompanhar do princípio ao fim

Exemplo Caso ilustrativo: a empresa e os seus dados são inventados para explicar o fluxo.

A Hogar Norte é uma loja inventada que vende utensílios de casa na Cdiscount e gere as suas devoluções FFM a partir do Odoo. Um cliente devolve um produto de um envio já efetuado. A Marta, do apoio ao cliente, abre a ficha da devolução em Octopia › Fulfillment › Devoluções e preenche o que essa ficha mostra: a Conta (Account) da Octopia, o Envio de saída (Outbound Shipment) de onde vem o produto, o Comentário (Comment) se quiser deixar uma nota e as Linhas (Lines) da devolução.

Primeiro carrega em Submeter à Octopia com a ficha sem linhas: a ação para e aparece Uma devolução precisa de pelo menos uma linha. Não se enviou nada para a Octopia. A Marta acrescenta uma linha em Linhas e carrega de novo. Desta vez o módulo prepara o pedido, envia-o com a conta escolhida e, se a resposta trouxer o identificador da devolução, guarda-o em ID da devolução. Depois passa a devolução ao estado criado e regista uma linha no registo de sincronização da conta. Como ID da devolução já tem valor, o botão desaparece da ficha.

O que se aprende com o caso: a verificação prévia que o módulo faz é que existam linhas, e o rasto de que a criação chegou à Octopia é o valor de ID da devolução.

O que faz o botão, por ordem

  1. Se a devolução já tem ID da devolução, o método salta-a sem fazer nada.
  2. Verifica que a devolução tem linhas. Se não tiver nenhuma, para com Uma devolução precisa de pelo menos uma linha. e não continua.
  3. Prepara o pedido com o identificador externo do Envio de saída, o motivo da devolução e, por cada linha, o produto, a quantidade e o estado do produto.
  4. Se Comentário tem texto, acrescenta-o ao pedido. Se estiver vazio, o pedido segue sem comentário.
  5. Liga-se à Conta da devolução e pede à Octopia que crie a devolução.
  6. Se a resposta incluir o identificador da devolução, guarda-o em ID da devolução.
  7. Passa a devolução ao estado criado.
  8. Regista uma linha no registo de sincronização da conta: do tipo fulfillment, com resultado correto, com o envio de saída no texto e um registo contado.

Esse registo não é exclusivo do botão. Também escrevem nele duas tarefas agendadas. A tarefa Octopia: atualizar referenciais (categorias, marcas, transportadoras, tipologias) (Octopia: refresh referentials (categories, brands, carriers, typologies)) corre a cada sete dias e está ativa ao instalar, mas só regista quando algum passo da atualização falha: nesse caso deixa um erro de referenciais incompletos. A tarefa Octopia: obter discussões (fila ToTreat) (Octopia: pull discussions (ToTreat queue)) corre a cada 15 minutos, está ativa ao instalar e também deixa o seu registo nesse histórico.

A mensagem que pode parar o botão

MensagemQuando apareceO que fazer
Uma devolução precisa de pelo menos uma linha.Ao carregar em Submeter à Octopia com a devolução sem linhas.Acrescente pelo menos uma linha em Linhas da ficha e carregue de novo.

A verificação acontece antes de preparar o pedido e de ligar à Octopia. Quando a mensagem aparece, essa devolução não é enviada e não se guarda nada do que o botão ia escrever: nem ID da devolução, nem a mudança de estado, nem a linha de registo.

Dúvidas que surgem ao usá-lo

O comentário é enviado se o deixar vazio?

Não. O módulo só acrescenta o comentário ao pedido quando Comentário tem texto.

Com que conta é enviado?

Com a que consta em Conta na ficha da devolução. Também a vê na lista de Devoluções FFM, junto com o Envio de saída.

O que acontece se a resposta não trouxer identificador?

O módulo passa na mesma a devolução ao estado criado e regista a linha de registo, mas ID da devolução fica vazio. Segundo a condição de visibilidade do botão, com esse campo vazio o botão continua visível.

Pode enviar-se duas vezes a mesma devolução?

Depende de ID da devolução. Se a devolução já o tem, não: o botão não se mostra e o método salta-a. Se ficou vazio porque a resposta não trouxe identificador, o botão continua visível e carregar de novo volta a enviar o pedido à Octopia.

O que precisa para o usar

O módulo é de pagamento único por versão e está publicado na Odoo Apps para Odoo 17, 18, 19 e 20; cada versão do Odoo compra-se lá em separado e o seu preço está na respetiva ficha. Além disso, precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, para até 3 contas da plataforma (o plano Pro custa 98 €/mês ou 980 €/ano sem IVA, para até 10).

A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar; se a plataforma mudar a sua API, o módulo e o serviço adaptam-se. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição fornece; os dados ficam no seu Odoo.

O módulo tem outros botões com o seu próprio artigo, como Abrir conversa e Declarar à Octopia.

Se precisar de ajuda com a Octopia e o Odoo

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiser rever como as suas devoluções FFM se encaixam no seu Odoo, escreva-nos.

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.Declarar à Octopia no Odoo: checklist do botão, passo a passoChecklist do botão Declarar à Octopia do Octopia Connector: o que verifica, o que muda no envio e na encomenda, e o que fazer com as mensagens que o travam.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes