Saltar para o conteúdo principal
Shopify

O que faz o botão «Sincronizar pedidos» do Shopify Connector for Odoo, passo a passo

O botão Sincronizar pedidos (Sync Orders) da ficha da loja pede ao Shopify os pedidos atualizados desde a última vez, processa-os no Odoo e regista a data a partir da qual continuar. Manualmente faz o mesmo que a tarefa agendada: aqui tens o que verifica, o que muda e quando para com um erro.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 5 de novembro de 2026

O essencial

Módulo
Shopify
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á o botão e quem o vê

As fichas das lojas abrem-se a partir do menu Shopify › Configuração › Lojas (Shopify › Configuration › Stores). O primeiro nível Shopify exige a permissão Visualizador (Viewer) e o nível Configuração (Configuration) exige Operador (Operator); se não tiveres uma delas, não vês esse nível. No ecrã Instâncias Shopify (Shopify Instances) está o botão Sincronizar pedidos, que se vê sem condições no Odoo 17, 18, 19 e 20.

Esquema com o menu das lojas, o botão de sincronizar pedidos e, ao lado, a mensagem de erro que pode interromper a ação
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 (Odoo 17, 18, 19 e 20) e a mensagem que o pode interromper.

Com o Odoo em castelhano o botão chama-se Sincronizar pedidos; o rótulo muda conforme o idioma do teu Odoo, como mostra este esquema.

Esquema com o rótulo do botão 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: Sincronizar pedidos (castelhano), Bestellungen synchronisieren (alemão), Synchroniser les commandes (francês), Sincronizza ordini (italiano) e Sincronizar pedidos (português).
Your Odoo doesn't talk to Amazon, Temu or Shopify?
Vídeo: Your Odoo doesn't talk to Amazon, Temu or Shopify? (vídeo em inglês)

Passo a passo: o que acontece ao sincronizar pedidos

Isto é o que o código faz, pela ordem em que o faz.

  1. Primeiro, o caminho automático. A tarefa agendada Sincronizar encomendas Shopify (Shopify Sync Orders) executa-se a cada 5 minutos e chega à mesma ação que o botão; vem desativada na instalação. Por isso o botão é a via para a lançar manualmente, não o passo normal.
  2. Carregas no botão. O módulo cria um registo da sincronização, do tipo pedidos, em estado de execução.
  3. Calcula desde quando pedir. Se Última sincronização de encomendas (Last Order Sync) tem data e a loja já importou algum pedido, pede os pedidos atualizados desde essa data. Se não, recua a partir do momento atual uma janela de horas configurada na loja, nunca inferior a uma hora. O filtro é pela data de atualização do pedido, não pela data de criação.
  4. Aplica o âmbito de importação da loja. Conforme o âmbito configurado, pede todos os pedidos, só os pagos, ou os pagos que continuam pendentes de cumprimento.
  5. Pede páginas ao Shopify. Chegam primeiro os pedidos atualizados há mais tempo, e cada um é processado no Odoo um a um. Pára quando o Shopify não tem mais ou quando atinge Páginas máx. (Max Pages), que por defeito no código é 20 e se vê na ficha, separador Operações (Operations), grupo Configurações de sincronização (Sync Settings).
  6. Primeira vez: segunda passagem sem filtro de data. Se não chegou nenhum pedido e a loja nunca importou um, repete o pedido sem o filtro de data, percorrendo o histórico desde o pedido mais antigo (com o mesmo limite de páginas). Se a loja já tinha importado pedidos e não chega nada, não repete: uma loja tranquila é o normal.
  7. Se chegaram pedidos, regista a data. Última sincronização de encomendas passa a ser o momento atual, o contador Erros de sincronização consecutivos (Consecutive Sync Errors) volta a zero e o último erro guardado é limpo. Se a execução parou pelo limite de páginas, a data que se guarda é a do último pedido processado quando é posterior à que já existia (ou não existia nenhuma); a data nunca recua. A execução seguinte continua a partir daí. Se o Shopify não devolveu nenhum pedido, nada disto é escrito.
  8. Fecha o registo. Anota a hora de fim e a duração, conta todos os pedidos processados como atualizados (esta ação não conta nenhum como criado) e sem erros, pelo que o registo fica como correto. O botão devolve o total de pedidos sincronizados.

Que erros pode dar

Ao carregar em Sincronizar pedidos, a ação pode parar com Sincronização de pedido Shopify falhou para …: … (Shopify order sync failed for …: …). Depois de «para» vai o valor de Domínio da loja (Shop Domain) e depois dos dois pontos, o texto do erro que a provocou. Antes de mostrar o aviso, o módulo marca o registo da sincronização como falhado e guarda nele o texto do erro.

Outros dois finais possíveis, também segundo o código:

  • Se o erro já é um aviso do Odoo dos que se mostram num diálogo, o registo é marcado como falhado e esse aviso é mostrado tal como está.
  • Se o FlexigoTech Cloud pausou a sincronização, o módulo apaga o registo dessa execução, para que não figure como falhada, e a ação pára.

O contador Erros de sincronização consecutivos é escrito pelo código, não por ti. Vai sem rótulo na ficha (só se vê o número, apenas de leitura) e só aparece quando é diferente de zero. Preenchem-no o botão Sincronizar pedidos, o botão Executar (Run) e a tarefa agendada; esvazia-o o botão Repor sincronização (Reset Sync), que também esvazia Última sincronização de encomendas.

O que verificar depois de sincronizar

  • A data. Última sincronização de encomendas vê-se na ficha e na lista de Instâncias Shopify, apenas de leitura. Se não mudar após uma execução sem erros, o Shopify não devolveu pedidos; se a ação parou com um aviso ou o FlexigoTech Cloud a pausou, a data também não é atualizada.
  • O domínio. Domínio da loja vê-se na ficha e na lista. A sua ajuda diz: «Use o seu domínio Shopify exato, por exemplo: flexigobe.myshopify.com». O aviso de falha leva esse domínio, por isso compara um com o outro.
  • O limite de páginas. O código corta ao atingir Páginas máx., pelo que esse campo limita quantas páginas de pedidos se pedem ao Shopify em cada execução. Com muitos pedidos pendentes, a data avança até ao último pedido processado e a execução seguinte continua a partir daí.
  • O contador de erros. Se aparece na ficha, há erros consecutivos registados; volta a zero quando uma execução com pedidos termina bem.

Custo e versões

O módulo está publicado no Odoo Apps para Odoo 17, 18, 19 e 20, e funciona com a subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, até 3 contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição fornece; os dados ficam no teu Odoo. O preço do módulo de cada versão está na ficha do Odoo Apps e na página do módulo.

Como te ajuda a FlexigoTech

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se queres rever como fica configurada a tua loja Shopify no Odoo, escreve-nos.

Continue a ler

A encomenda de venda … não está associada a uma encomenda do Shopify: o que fazerO que significa o erro «não está associada a uma encomenda do Shopify» no Odoo, quando surge com o botão Enviar para o Shopify e como verificá-lo passo a passo.A mensagem «O URL webhook não está disponível» no Shopify para OdooQuando aparece «O URL webhook não está disponível» no conector Shopify para Odoo, que condição o provoca e o que verificar passo a passo.Shopify no Odoo: o que fazer se lhe falta acesso OperatorO que significa o aviso de acesso Operator ou Manager do Shopify no Odoo, quando aparece ao enviar ou cancelar uma encomenda e como se resolve.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes