Saltar para o conteúdo principal
Octopia (Cdiscount)

O que faz o botão «Submeter à Octopia» das promoções, passo a passo

O botão Submeter à Octopia só aparece em promoções em Rascunho: verifica a seleção, gera um pacote zip com o XML, publica-o como ligação para a Octopia o descarregar e deixa a promoção em Submetido.

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á e quando se vê

O botão Submeter à Octopia (Submit to Octopia) está no ecrã Promoções (Promotions), a que chega por Octopia › Ofertas › Promoções (Octopia › Offers › Promotions). 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 nos ramos 17, 18, 19 e 20 do módulo.

Só se vê quando o campo Estado (State) da promoção tem o valor Rascunho (Draft): com qualquer outro valor fica oculto. Como o valor por defeito é Rascunho, uma promoção acabada de criar mostra o botão. Os valores do campo são Rascunho, Submetido (Submitted), Integrado (Integrated) e Rejeitado (Rejected).

Esquema feito com código, não um ecrã do Odoo: o menu de Promoções, o botão de envio com os avisos que o podem travar a um lado e o estado em que deixa a ficha
Esquema do percurso do botão segundo o código publicado do módulo (não é uma captura do Odoo).

Com o Odoo em português o botão chama-se Submeter à Octopia; o esquema seguinte mostra como é rotulado noutros idiomas.

Esquema feito com código a partir das traduções do módulo: o texto do botão em espanhol, alemão, francês, italiano e português
Esquema (não é uma captura do Odoo): em português Submeter à Octopia, em alemão An Octopia übermitteln, em francês Soumettre à Octopia e em italiano Invia a 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)

O que acontece ao carregar, por ordem

Antes de carregar, deixe cada promoção preparada na sua ficha, no grupo Promoção (Promotion): o campo Oferta (Offer) e o campo Tipo de promoção (Promo Type). O valor por defeito é Venda flash (Tipo 1) (Flash Sale (Type 1)); também existe Saldos legais franceses / Soldes (Tipo 3) (French Legal Sales / Soldes (Type 3)). Com o Tipo 3 aparece, no mesmo grupo, o campo Preço de referência de venda (Sales Reference Price); com o valor por defeito não se vê.

  1. O módulo fica apenas com as promoções selecionadas que estão em Rascunho. As que estiverem noutro estado não são tocadas. Se não restar nenhuma, pára com um aviso.
  2. Verifica se as promoções em rascunho pertencem à mesma conta. Se houver mais do que uma conta, pára com um aviso.
  3. Revê as promoções do Tipo 3: cada uma precisa de um preço, seja o Preço de referência de venda da própria promoção ou o preço da oferta associada. Se faltar em alguma, pára com um aviso.
  4. Constrói um pacote zip que contém o XML das promoções.
  5. Guarda o zip como anexo não público, com um token de acesso, e compõe uma ligação de descarga a partir do URL base do seu Odoo. O envio é por ligação: a Octopia descarrega o pacote a partir desse endereço e a API não aceita o conteúdo diretamente.
  6. Usa a ligação da conta para entregar essa ligação à Octopia.
  7. Obtém a referência do pacote da resposta: se trouxer um identificador de pacote, ou se a resposta for um número, guarda-o; caso contrário, a referência fica vazia.
  8. Escreve nas promoções em rascunho: Estado passa a Submetido, e guarda a referência do pacote, o zip anexo e a ligação.
  9. Deixa uma entrada de sucesso no registo de sincronização da conta, com o número de promoções enviadas.

Os avisos da tabela seguinte surgem antes de construir seja o que for, pelo que, se aparecer um, nada muda. A mudança de estado chega quase no fim: se algo falhar antes, as promoções não passam a Submetido.

Os avisos que podem parar o envio

MensagemQuando surgeO que fazer
Nenhuma promoção em rascunho selecionada. (No draft promotions selected.)Nenhuma das promoções selecionadas está em Rascunho.Selecione pelo menos uma promoção em Rascunho.
Submeta promoções de uma conta de cada vez. (Submit promotions of one account at a time.)As promoções em rascunho selecionadas pertencem a mais do que uma conta.Lance o envio em separado para as de cada conta.
O Tipo 3 (soldes) exige um preço de referência de venda. (Type 3 (soldes) requires a sales reference price.)Há uma promoção do Tipo 3 em rascunho sem Preço de referência de venda e cuja oferta também não tem preço.Preencha Preço de referência de venda na ficha, onde aparece ao escolher o Tipo 3.

Sobre o Tipo 3, a ajuda do campo Tipo de promoção diz que declara os saldos legais franceses ('soldes') e que só é válido dentro dos períodos legais de saldos. A ajuda de Preço de referência de venda descreve-o como obrigatório para o Tipo 3: o preço de referência legal ao qual se aplica o desconto. Repare que o aviso só surge se faltarem os dois preços, o da promoção e o da oferta.

O que verificar depois

  • Na lista de Promoções, a coluna Estado das promoções enviadas deve mostrar Submetido.
  • O botão desaparece dessas promoções, porque só se vê em Rascunho.
  • Este botão só escreve Submetido: os valores Integrado e Rejeitado existem no campo, mas não são escritos por esta ação.

O registo de sincronização não é exclusivo do botão. A tarefa agendada Octopia: obter discussões (fila ToTreat) (Octopia: pull discussions (ToTreat queue)), que corre a cada quinze minutos, também escreve nele. A tarefa Octopia: atualizar referenciais (categorias, marcas, transportadoras, tipologias) (Octopia: refresh referentials (categories, brands, carriers, typologies)), que corre a cada sete dias, deixa uma entrada de erro quando algum passo da atualização falha. Ambas estão ativas ao instalar.

Como o ajudamos na FlexigoTech

Se está a implementar o Odoo e quer ligar a Cdiscount e a Octopia, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. O módulo está publicado no Odoo Apps para essas quatro versões e precisa da subscrição do FlexigoTech Cloud: a ligação passa por esse serviço (plano Conector: 49 €/mês ou 490 €/ano, sem IVA), que guarda as credenciais cifradas e avisa por e-mail se a sincronização falhar.

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.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.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