Saltar para o conteúdo principal
Shopify

O que faz o botão «Sincronizar produtos» do Shopify Connector

O botão Sincronizar produtos (Sync Products) da ficha da instância pede à Shopify os produtos por páginas, passa cada um à ligação de produto do módulo e, se tudo correr bem, regista a data em Last Product Sync; se algo falhar, pára e deixa o erro no registo de sincronização. Aqui tens as verificações e os passos pela ordem em que acontecem.

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

Antes de carregar: onde está e o que faz o Odoo sozinho

A ficha da instância abre-se a partir do menu Vendas (Sales): entra em Shopify, depois em Control Center e por fim em Instances. O botão Sincronizar produtos existe nos ramos 17, 18, 19 e 20 do Odoo e, segundo a condição da sua vista, aparece sempre.

Esquema feito com código: o caminho de menu Sales, Shopify, Control Center, Instances e o botão Sync Products
Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo: o caminho do menu e o botão, presentes no Odoo 17, 18, 19 e 20.

O botão não é o único caminho. O que ele faz também o faz a tarefa agendada Shopify Sync Products, a cada hora, que vem desativada ao instalar o módulo. O que se segue descreve o código publicado para o Odoo 20.0.

  • Decide se te basta a tarefa agendada Shopify Sync Products (a cada hora, desativada ao instalar): se não a ativares, podes lançar a sincronização de produtos com este botão.
  • Abre a ficha da instância e anota o valor de Last Product Sync. Vê-se na ficha e na lista de instâncias, só de leitura: é o módulo que o escreve, não tu.
  • No separador Operations, grupo Configurações de sincronização (Sync Settings), revê Page Size (50 por defeito) e Max Pages (20 por defeito). Se pores menos de um em qualquer dos dois, o módulo usa um.
  • Se a instância não passa pela FlexigoTech Cloud, o código exige que tenha token de acesso antes de enviar o que quer que seja.
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)

O que faz o botão, por ordem

  1. Cria um registo de sincronização da instância, do tipo produtos, marcado como em curso.
  2. Prepara a consulta à Shopify. Pede os produtos ordenados por data de atualização e, de cada um, entre outros dados: título, fornecedor, tipo de produto, estado, descrição, etiquetas, data de atualização, imagem em destaque, opções e até 250 variantes com o seu SKU, preço, preço de comparação, código de barras e quantidade de inventário.
  3. Decide o filtro. Se Last Product Sync estiver vazio, não põe nenhum. Se tiver data, pede apenas os produtos atualizados na Shopify desde esse momento.
  4. Chama a Shopify por páginas do tamanho de Page Size, passando em cada chamada o cursor da página anterior.
  5. Entrega cada produto recebido à ligação de produto da Shopify do módulo e soma-o ao total.
  6. Pára quando a Shopify indica que não há mais páginas ou quando chega ao número de páginas de Max Pages.
  7. Escreve em Last Product Sync a data e a hora desse momento e fecha o registo de sincronização, com o total contado como produtos atualizados.

Um pormenor do último passo: a data é escrita ao sair do ciclo, tanto se já não havia mais páginas como se se cortou por Max Pages. A execução seguinte parte, portanto, dessa data. Tem isto presente ao definir Page Size e Max Pages numa loja com muitos produtos.

O que faz a chamada à Shopify

  • Se a instância vai pela FlexigoTech Cloud, o pedido passa pelo serviço, que acrescenta o token que guarda (e renova). O Odoo não se liga à loja nem recebe o token.
  • Sem esse caminho, o Odoo chama a Shopify com o token da instância.
  • Se a Shopify responder que excedeste o seu limite de pedidos, a chamada espera (o tempo que a Shopify indicar ou uns segundos, com um máximo de trinta, e mais tempo a cada nova tentativa) e repete. Faz até três tentativas.
  • Se a Shopify rejeitar o token na primeira tentativa e a instância tiver token de renovação, o módulo repete a chamada uma vez, com o token que a instância tiver nesse momento.
  • Qualquer outra resposta de erro, uma resposta com erros ou uma resposta com erros de utilizador interrompe a ação com esse erro. Também pára se as tentativas se esgotarem.

Se falhar: o que muda e o que não muda

  • Perante um erro, o módulo marca o registo de sincronização como falhado, guarda nele o texto do erro (cortado se for muito longo) e volta a lançar o erro, pelo que a ação pára.
  • Numa execução falhada, Last Product Sync não é atualizado: esse passo vem depois do ciclo.
  • Se a FlexigoTech Cloud pausar a execução, o módulo apaga o registo dessa execução (não fica como falhada) e a ação pára igualmente.

Depois de carregar: o que verificar

  • Last Product Sync mostra a data e hora atuais na ficha e na lista de instâncias.
  • Se a tua loja tem mais produtos do que cabem em Page Size por Max Pages, lembra-te de que a data é escrita na mesma e que a execução seguinte pede apenas o que foi atualizado desde aí.
  • Verifica como se chama o botão no teu idioma do Odoo. Com o Odoo em castelhano é Sincronizar produtos; as restantes traduções publicadas estão no esquema.
Esquema feito com código do texto Sync Products consoante o idioma do Odoo: 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 é uma captura do Odoo: em castelhano, Sincronizar produtos; em alemão, Produkte synchronisieren; em francês, Synchroniser les produits; em italiano, Sincronizza prodotti; em português, Sincronizar produtos.

Para o stock da Shopify tens outro artigo: o que faz o botão «Pull Stock».

Preço e ajuda

O Shopify Connector custa 9 € por versão do Odoo, sem IVA, em pagamento único (para 17, 18, 19 e 20; consulta a ficha), e precisa da subscrição da FlexigoTech Cloud: plano Conector, 49 €/mês ou 490 €/ano sem IVA.

Se estás a implementar o Odoo e queres deixar a sincronização de produtos bem configurada, 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 Pull Stock do Shopify Connector, passo a passoO que faz o botão Pull Stock do Shopify Connector no Odoo 20: quando aparece, o que verifica, que ajustes de inventário cria e que erros pode dar.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes