Saltar para o conteúdo principal
Octopia (Cdiscount)

Referência de produto imutável no Octopia Connector: quando surge e o que fazer

O aviso de referência de produto imutável do Octopia Connector surge ao guardar um produto da Octopia quando alteras a sua referência, o produto já não está em rascunho e tinha outra diferente. Resolve-se deixando a referência anterior; se for mesmo preciso alterá-la, a própria mensagem diz que é necessário um pedido de suporte à 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
5 min

O que vês e onde

Abres Octopia › Catálogo › Produtos (Octopia › Catalog › Products), entras na ficha de um produto e alteras o campo Referência de produto do vendedor (Seller Product Reference). Esse campo está na ficha de Produtos Octopia (Octopia Products), dentro do grupo Identidade (Identity), e também na lista desse menu. O troço Octopia do menu pede a permissão Utilizador Octopia (Octopia User): sem ela não vês esse troço.

Ao guardar, o Odoo interrompe a ação e mostra esta mensagem:

A Referência de Produto do Vendedor é imutável na Octopia depois de o produto ter sido submetido (…). Alterá-la requer um pedido de suporte à Octopia. (The Seller Product Reference is immutable at Octopia once the product has been submitted (…). Changing it requires an Octopia support ticket.)

Onde a mensagem tem «…», o módulo escreve os nomes dos produtos afetados, separados por vírgulas. O aviso está no código publicado para Odoo 17, 18, 19 e 20, e o módulo está publicado no Odoo Apps para essas quatro versões.

Esquema feito com código, não um ecrã do Odoo: de cima para baixo, o menu Octopia › Catalog › Products, o guardar com o campo Seller Product Reference e a mensagem de referência imutável
Esquema feito com código a partir do código publicado do módulo: do menu à mensagem. As legendas estão em inglês, o texto original do módulo.

A ajuda do próprio campo diz o mesmo em menos palavras: A sua referência de produto imutável na Octopia (é necessário um pedido de suporte para a alterar após a criação). (Your immutable product reference at Octopia (a support ticket is needed to change it after creation).)

Esquema feito com código, não um ecrã do Odoo: a mesma mensagem em castelhano, alemão, francês, italiano e português
Esquema feito com código a partir das traduções publicadas do módulo: o mesmo texto em castelhano, alemão, francês, italiano e 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)

A condição exata, lida do código

A mensagem é lançada ao guardar as fichas de Produtos Octopia, por isso surge ao guardar alterações. Primeiro o código verifica se, entre as alterações a guardar, vem a referência. Se não vier, não há verificação e o guardar segue o seu curso.

Se vier, revê cada produto que está a ser guardado e fica com os que cumprem as três condições em simultâneo:

  • O produto já não está em rascunho.
  • Já tem uma referência escrita (não está vazia).
  • A referência nova é diferente da que tem.

Se houver pelo menos um produto assim, é lançada a mensagem com os nomes desses produtos. Se não houver nenhum, o guardar continua com normalidade.

Daqui saem quatro consequências práticas:

  • Nada desse guardar é gravado. A mensagem é lançada antes de escrever, pelo que também não se gravam outros campos que tenhas alterado ao mesmo tempo.
  • Em rascunho, o código não bloqueia. A verificação só olha para os produtos que já não estão em rascunho.
  • Uma referência vazia pode ser preenchida. Se o produto não tinha referência, o código não a bloqueia.
  • Escrever o mesmo valor não dá erro. Só dispara quando a referência nova difere da atual.

Um caso para ver

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

A Hogar Atlántico é uma loja inventada que gere o seu catálogo da Octopia a partir do Odoo. Uma pessoa da equipa abre Octopia › Catálogo › Produtos, entra na ficha de um candeeiro que já não está em rascunho e apercebe-se de que a referência tem uma gralha. Corrige o campo Referência de produto do vendedor, altera ainda outro campo da mesma ficha e carrega em guardar.

O Odoo mostra a mensagem com o nome do candeeiro entre parênteses e não guarda nada: nem a referência nova nem a outra alteração. As três condições cumprem-se em simultâneo: o produto não está em rascunho, já tinha uma referência e a nova é diferente.

A pessoa deixa no campo a referência que tinha, repete a outra alteração e guarda sem tocar na referência. Desta vez o guardar passa, porque a referência não vem entre as alterações. Como a gralha continua lá, abre um pedido com o suporte da Octopia, que é o que a própria mensagem pede para a alterar.

O que aprender com o caso: a mensagem não avisa de uma falha técnica, mas de uma regra que o módulo aplica ao guardar, e a alteração que a dispara perde-se por inteiro.

O que fazer quando te aparece

  1. Lê entre parênteses os nomes dos produtos afetados: são os que cumprem a condição.
  2. Deixa em Referência de produto do vendedor a referência que o produto tinha.
  3. Se tinhas alterado outros campos no mesmo guardar, repete-os e guarda sem tocar na referência.
  4. Se a referência tiver mesmo de mudar, a mensagem indica que alterá-la requer um pedido de suporte à Octopia: abre-o junto da Octopia.
  5. Confirma na ficha e na lista de Produtos Octopia que a referência é a anterior e que as tuas outras alterações foram guardadas.

Perguntas que vais fazer

Surge se só alterar outros campos da ficha?

Não. A verificação só se ativa quando, entre as alterações a guardar, está a referência.

Surge com um produto em rascunho?

O código não o bloqueia: só revê os produtos que já não estão em rascunho.

Posso preencher a referência se estava vazia?

Sim. O código só bloqueia a alteração quando o produto já tinha uma referência escrita.

Porque é que a mensagem mostra vários nomes?

Porque o guardar pode afetar mais de um produto. A mensagem junta, separados por vírgulas, os nomes dos que cumprem a condição.

O que acontece ao resto do que alterei?

Não se guarda. A mensagem interrompe o guardar antes de escrever fosse o que fosse.

Como a FlexigoTech te pode ajudar

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se estás a montar o catálogo da Octopia no teu Odoo e queres definir quem edita o quê antes de carregar referências, escreve-nos. Para outros botões e erros do módulo, começa por o que faz o botão Submit to Octopia.

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