Saltar para o conteúdo principal
Shopify

O que faz o botão Pull Stock do Shopify Connector, passo a passo

O botão Pull Stock traz para o Odoo as existências da Shopify: lê o que a Shopify tem na sua localização principal e cria ajustes de inventário na localização do Odoo associada para os igualar, descontando o que o Odoo já entregou e a Shopify ainda não cumpriu. Só funciona com a caixa Obter o stock da Shopify (Pull stock from Shopify) ativa e com permissões de Inventário.

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

Quando aparece e o que precisa

O botão Pull Stock está na ficha de Shopify Instances, que se abre a partir do menu Vendas › Shopify › Control Center › Instances (com o Odoo em castelhano, o primeiro troço chama-se Vendas). Existe nas versões 17, 18, 19 e 20 do módulo e vê-se sempre, sem qualquer condição.

Esquema com o menu Vendas › Shopify › Control Center › Instances, o botão Pull Stock e, ao lado, os textos que o podem travar
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 Pull Stock e o que o pode travar.

Para que faça alguma coisa, a instância precisa da caixa Obter o stock da Shopify ativa: assim a Shopify passa a ser a dona do stock. Segundo a sua ajuda, não pode estar ativa ao mesmo tempo que o envio de stock (Sync Stock Enabled) nem com outra loja que traga stock para a mesma localização do Odoo. A ajuda acrescenta que o que a Shopify conta como danificado, em controlo de qualidade ou como stock de segurança entra na sua existência: no Odoo é stock como o resto.

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

  1. Comece pelo caminho automático. Na ficha de Shopify Instances, separador Operations, grupo Configurações de sincronização (Sync Settings), ative Obter o stock da Shopify. Vem desativada por defeito.
  2. Ative também a tarefa agendada Shopify Pull Stock (Shopify → Odoo): corre a cada seis horas e vem desativada na instalação. A ajuda da caixa avisa disso: ativá-la não lança a obtenção.
  3. Prima Pull Stock apenas quando quiser trazer o stock agora, sem esperar pela tarefa. É o caminho manual e percorre o que se segue.
  4. Antes de criar o que quer que seja, o botão verifica que a caixa está ativa. Se não estiver, para e não altera nada.
  5. Depois verifica que quem o prime tem permissões de Inventário, porque a obtenção faz ajustes de inventário. Se não as tiver, para com a mensagem de permissões da tabela.
  6. Cria uma entrada no registo de sincronização, do tipo obtenção de stock, em curso.
  7. Procura as ligações de produto ativas dessa instância que têm item de inventário da Shopify e descarta as de um produto de outra empresa ligado antes de uma correção. Se não sobrar nenhuma, fecha o registo como concluído, com uma nota, e não altera nada.
  8. Decide a localização do Odoo: a associada à localização principal da Shopify ou, se não houver, a localização de stock do armazém da loja (da sua empresa). Se não encontrar nenhuma, marca o registo como falhado e deixa lá o motivo.
  9. Verifica que nenhuma outra loja ativa com a caixa ativada traga stock para essa mesma localização, para uma dentro dela ou para uma que a contenha. Se acontecer, marca o registo como falhado e para sem tocar no stock.
  10. Usa a localização da Shopify guardada em Default Location Gid (separador Webhooks da ficha). Se estiver vazia, pede à Shopify a sua primeira localização e guarda-a aí.
  11. Pergunta à Shopify, em blocos de cem artigos, quanto há nessa localização (o que lá está dentro, incluindo o que já está comprometido).
  12. Salta os produtos com rastreio por lotes ou números de série, os que não se armazenam e os kits, e regista-os. Os produtos para os quais a Shopify não devolveu quantidade ficam por tocar.
  13. Se na localização do Odoo (com as suas filhas) houver uma contagem pendente desse produto, não a atropela: deixa-o sem ajustar e regista-o.
  14. Calcula a diferença: existências da Shopify, menos o que o Odoo entregou a partir dessa localização (com as suas filhas) para encomendas abertas da loja e a Shopify ainda não cumpriu, menos o que o Odoo tem disponível na localização. Não conta o que o conector cumpriu nem as encomendas que a Shopify cumpriu por outra via.
  15. Se a diferença for positiva, cria e aplica um ajuste de inventário que sobe o stock da localização. Se for negativa, baixa-o retirando das existências da localização (filhas e pacotes incluídos, nunca o que pertence a um proprietário), por ordem de saída. Se o Odoo não tiver stock ajustável suficiente para baixar, não ajusta esse produto e conta-o como erro.
  16. Cada produto é tratado à parte: se um falhar, conta-se como erro e segue-se com o seguinte. Quando ajusta um, anota a data de sincronização na sua ligação.
  17. Fecha o registo com uma nota: quantas quantidades trouxe e que produtos saltou, deixou com contagem pendente ou não conseguiu baixar. Fica correto se não houve erros, parcial se houve erros e algo foi atualizado, e falhado se houve erros e nada foi atualizado.

Algumas mensagens que o botão pode dar

MensagemQuando apareceO que fazer
Obter o stock da Shopify faz ajustes de inventário: são precisas permissões de Inventário. (Pulling stock from Shopify makes inventory adjustments: it needs Inventory rights.)Ao premir o botão sem permissões de Inventário.Que o prima um utilizador com permissões de Inventário.
Sincronização de stock Shopify falhou para …: … (Shopify stock pull failed for …: …)Se algo falhar durante a obtenção, já com o registo criado. Primeiro vai o domínio da loja (Shop Domain) e depois o motivo.Leia o motivo depois dos dois pontos: o registo fica como falhado com esse texto.

Se a FlexigoTech Cloud tiver pausado o serviço, o código apaga a entrada do registo e não a deixa como falhada; nesse caso a mensagem de falha da última linha não é gerada.

Esquema com a mensagem de permissões de Inventário 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): a mensagem de permissões da tabela em cinco idiomas.

O que verificar depois

Abra o registo dessa execução: o seu estado e a sua nota dizem quantas quantidades se trouxeram e que produtos se saltaram, ficaram por uma contagem pendente ou não se conseguiram baixar. Os ajustes ficam no histórico de inventário e são valorizados como qualquer outro. Se um produto aparecer na nota por uma contagem pendente, a própria nota indica aplicá-la ou apagá-la no Odoo.

Custo e ajuda

O módulo custa 9 € por versão do Odoo, para 17, 18, 19 e 20, sem IVA e de pagamento único. Precisa ainda da subscrição da FlexigoTech Cloud: o plano Conector é de 49 €/mês ou 490 €/ano sem IVA.

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

A mensagem «Authorize … in Shopify first (Authorize in Shopify).» do Shopify ConnectorQuando surge Authorize … in Shopify first (Authorize in Shopify). no Shopify Connector, que condição do código o provoca e como resolver o problema.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes