Saltar para o conteúdo principal
Octopia (Cdiscount)

O que faz o botão «Recuperar histórico» do Octopia Connector, passo a passo

O botão Recuperar histórico não descarrega as encomendas por si: verifica que a conta está ligada, regista o período que escolheu e avisa a tarefa agendada de encomendas para que o importe em segundo plano. Aqui tem quando aparece, o que preencher, o que muda e o erro que pode dar.

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 quem o vê

O botão Recuperar histórico (Backfill) está na ficha Recuperar histórico de encomendas (Backfill Orders), que se abre a partir do menu Octopia › Encomendas › Recuperar histórico de encomendas (Octopia › Orders › Backfill Orders). Existe nas versões 17, 18, 19 e 20 do Odoo, e a vista não lhe impõe qualquer condição: vê-se assim que abre a ficha.

As permissões vão por troços do menu: o troço Recuperar histórico de encomendas exige Gestor Octopia (Octopia Manager) e o troço Octopia exige Utilizador Octopia (Octopia User). Se não tiver um deles, não vê esse troço.

Esquema feito com código: o menu Octopia, Orders, Backfill Orders e o botão Backfill, com as mensagens que o acompanham de um lado
Esquema feito com código a partir do código publicado do módulo (não é um ecrã do Odoo): o menu, o botão, presente nas versões 17, 18, 19 e 20, e as mensagens que o acompanham, com os textos originais do código.

Com o Odoo em português, o botão chama-se Recuperar histórico. O esquema seguinte recolhe como se chama noutros idiomas do Odoo.

Esquema feito com código com o rótulo do botão Backfill em castelhano, alemão, francês, italiano e português
Esquema feito com código a partir das traduções publicadas do módulo (não é um ecrã do Odoo): o rótulo do botão consoante o idioma do Odoo.
Idioma do OdooRótulo do botão
CastelhanoRecuperar histórico
AlemãoNachimport
FrancêsRattrapage
ItalianoAvvia recupero storico
PortuguêsRecuperar histórico
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 para recuperar encomendas de um período

  1. Abra Octopia › Encomendas › Recuperar histórico de encomendas. Se não vir o menu, reveja as permissões Utilizador Octopia e Gestor Octopia do seu utilizador.
  2. Em Conta (Account) escolha a conta Octopia da qual quer recuperar as encomendas. O campo traz um valor por defeito, por isso confirme-o antes de continuar, sobretudo se trabalhar com mais do que uma conta.
  3. Preencha Data desde (Date From) e Data até (Date To), que são o período. Data até vem por defeito com a data e hora atuais e Data desde também traz um valor por defeito. Altere-os se o período de que precisa for outro.
  4. Clique em Recuperar histórico.
  5. Se a conta não estiver ligada, a ação para com uma mensagem (detalhamo-la mais abaixo). Teste a ligação e volte a clicar.
  6. Se a conta estiver ligada, verá o aviso Recuperação de histórico iniciada (Backfill started) com o texto As encomendas do período são importadas em segundo plano: os Registos de sincronização mostram o progresso. (The orders of the period are imported in the background: Sync Logs shows the progress.) O aviso não fica fixo no ecrã.
  7. Acompanhe o progresso nos Registos de sincronização, para onde remete o próprio aviso.

O que faz o botão por dentro, por ordem

No Odoo 20, o botão faz estas coisas, uma a seguir à outra:

  • Verifica a conta. Se a conta escolhida não estiver no estado ligado, pára aí. Nada do que a ação ia alterar é guardado.
  • Regista o período. Procura a linha de controlo dessa conta para a recuperação de encomendas (se for a primeira vez, cria-a) e escreve nela a sua Data desde e a sua Data até. Além disso, deixa vazio o ponto de retoma dessa janela.
  • Avisa a tarefa agendada de encomendas. O botão não importa nada nesse momento: pede a essa tarefa que arranque.
  • Devolve o aviso. É o aviso Recuperação de histórico iniciada acima.

Porque é que não se importa no momento

Uma recuperação longa não se executa dentro do pedido web: seria cortada ao atingir o limite de tempo do pedido e competiria com a tarefa agendada pela linha da conta. Por isso o botão só deixa registado o período e avisa a tarefa agendada de encomendas para que o importe em segundo plano.

Uma consequência direta do código: se clicar no botão outra vez para a mesma conta, as datas voltam a ser escritas nessa mesma linha e o ponto de retoma volta a ser esvaziado.

A mensagem que pode parar o botão

Ao clicar em Recuperar histórico, a ação pode parar com esta mensagem:

MensagemQuando apareceO que fazer
Teste primeiro a ligação: as encomendas são lidas com uma ligação que funcione. (Test the connection first: orders are read with a working connection.)Ao clicar no botão, se a conta escolhida não estiver no estado ligado.Teste a ligação dessa conta e, quando funcionar, volte a clicar em Recuperar histórico.

Quando aparece esta mensagem, não foi registado nenhum período nem foi avisada a tarefa agendada.

O aviso Recuperação de histórico iniciada não é um erro: é o que o botão devolve depois de registar o período e avisar a tarefa agendada de encomendas.

O que verificar depois

  • Que o aviso Recuperação de histórico iniciada apareceu: significa que o período está registado e a tarefa de encomendas foi avisada.
  • Que os Registos de sincronização vão mostrando o progresso, como indica o aviso.
  • Que em Conta estava a conta que pretendia, se trabalhar com mais do que uma.
  • Que Data desde e Data até cobriam o período de que precisava antes de clicar, porque são os valores que o botão regista.

Como a FlexigoTech o ajuda

Se está a implementar o Odoo e quer deixar o Octopia ligado e testado antes de recuperar histórico, na FlexigoTech implementamos o Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida.

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

  • Código do módulo: flexigobe_octopia_connector 20.0 (4848da6a): views/octopia_completeness_views.xml
  • Código do módulo: flexigobe_octopia_connector 20.0 (4848da6a): wizard/octopia_import_wizard.py
  • flexigotech.com/en/services.html