Saltar para o conteúdo principal
Octopia (Cdiscount)

O botão Descarregar etiqueta do Octopia Connector: mitos e realidades

O botão Descarregar etiqueta pede a etiqueta de uma devolução através da ligação da sua conta e, se receber um ficheiro com conteúdo, guarda-o como PDF anexo na ficha; só aparece quando a devolução tem ID da devolução.

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

Onde está o botão e quando aparece

O botão Descarregar etiqueta (Download Label) está na ficha de Devoluções FFM (FFM Returns). Essa ficha abre-se a partir do menu Octopia › Fulfillment › Devoluções (Octopia › Fulfillment › Returns). O troço Octopia do menu exige a permissão Utilizador Octopia (Octopia User): se não a tiver, não vê esse troço.

O botão existe em todos os ramos publicados do módulo: Odoo 17, 18, 19 e 20. O funcionamento descrito a seguir é o do código do Odoo 20.

Esquema feito com código (não é um ecrã do Odoo): de cima para baixo, o caminho de menu Octopia, Fulfillment, Returns e o botão Download Label, com os rótulos em inglês do código do módulo
Esquema do menu e do botão no Odoo 17, 18, 19 e 20, com os rótulos originais em inglês.

Com o Odoo em português de Portugal, o botão chama-se Descarregar etiqueta. Consoante o idioma do seu Odoo, o rótulo muda assim:

Esquema feito com código a partir das traduções publicadas (não é um ecrã do Odoo): o texto Download Label em castelhano, alemão, francês, italiano e português
O mesmo botão consoante o idioma: Descargar etiqueta em castelhano, Etikett herunterladen em alemão, Télécharger l'étiquette em francês, Scarica etichetta em italiano e Descarregar etiqueta 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)

Ideias erradas sobre o botão, uma a uma

«O botão está em qualquer devolução»

Na realidade, o botão fica oculto quando o campo ID da devolução (Return ID) está vazio. Com os valores por defeito esse campo está vazio e, por isso, o botão não se vê. O campo aparece na ficha e também na lista de Devoluções FFM, pelo que é a primeira coisa a verificar se não encontra o botão. A condição é a mesma no Odoo 17, 18, 19 e 20.

«O botão cria a etiqueta com os dados do Odoo»

O código do Odoo 20 faz outra coisa. Para cada devolução, toma a conta indicada no campo Conta (Account) e obtém o respetivo cliente. Depois pede-lhe a etiqueta dessa devolução, identificada pelo valor de ID da devolução. Ou seja, a etiqueta é pedida com esse identificador e através da conta da devolução.

«Clicar no botão basta para ter a etiqueta»

Só se o que for recebido for um ficheiro com conteúdo. Segundo o código, se o que se recebe não é um ficheiro (bytes) ou chega vazio, o método passa à devolução seguinte sem criar nada e sem tocar na ficha. Depois de clicar, verifique se o campo Anexo da etiqueta (Label Attachment) foi preenchido. Se continuar vazio, o método não recebeu um ficheiro com conteúdo para essa devolução.

«Descarregar significa que o PDF fica guardado no seu computador»

O que o método faz é guardar a etiqueta dentro do Odoo. Cria um anexo PDF cujo nome é octopia-return-…-label.pdf, com o ID da devolução no lugar das reticências, e associa-o à própria devolução. Depois deixa esse anexo no campo Anexo da etiqueta.

Esse campo vê-se na ficha de Devoluções FFM e é só de leitura: é escrito pelo código ao clicar no botão, não pelo utilizador.

«Clicar duas vezes não muda nada»

Sempre que o método recebe conteúdo, cria um anexo novo e o campo Anexo da etiqueta passa a apontar para ele. Se num segundo clique não chegar um ficheiro com conteúdo, o método passa à devolução seguinte e o campo fica como estava.

«Qualquer utilizador chega ao botão, e sobre qualquer devolução»

Há dois matizes. O primeiro é o menu: o troço Octopia exige Utilizador Octopia, e sem essa permissão não vê esse troço. O segundo está no código: o método só trabalha com as devoluções que têm ID da devolução e salta as restantes.

O que verificar depois de clicar

Na ficha da devolução:

  • O campo Anexo da etiqueta tem valor. É o sinal de que o método recebeu um ficheiro com conteúdo e o guardou.
  • O anexo tem o nome octopia-return-…-label.pdf com o identificador dessa devolução.
  • Os campos Conta e ID da devolução são os da devolução que queria. São os dois valores que o método usa para pedir a etiqueta.

Se o que procura é outro botão do módulo, Submit to Octopia tem artigo próprio: Submit to Octopia.

Quanto custa e como ajuda a FlexigoTech

O Octopia Connector é um módulo de pagamento único por versão do Odoo e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma. Está publicado no Odoo Apps para Odoo 17, 18, 19 e 20; na Odoo App Store, cada versão compra-se aí.

A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Se está a implementar o Odoo e precisa de montar o fluxo de devoluções do Cdiscount ou do Octopia, 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 «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