Integração WMS com Shopify: pedidos, estoque e fulfillment

Shopify concentra catálogo, carrinho e checkout, mas não separa, embala nem despacha um pedido. Essa parte cabe ao armazém. A integração precisa levar pedidos liberados até o WMS e devolver estoque, fulfillment e rastreamento sem deixar a loja prometer uma unidade que já foi vendida em outro canal.

Resposta rápida

A integração com o Shopify importa pedidos liberados, mapeia produto e localização, reserva estoque no WMS e devolve fulfillment com volumes e rastreamento. Pode passar por ERP, OMS, hub ou ligação direta com a Admin API/GraphQL da Shopify. Publique estoque vendável — não o físico bruto — por localização, use webhooks para eventos críticos e trate cancelamento, devolução e pedido dividido como fluxos explícitos, não exceções improvisadas.

Como integrar WMS com Shopify?

A Shopify expõe pedidos, produtos, variantes, localizações (locations) e níveis de estoque (inventory_levels) por API REST/GraphQL e webhooks. Um fluxo típico:

1. cadastro sincroniza produto, variante e localização;
2. Shopify envia o pedido pago e liberado (webhook orders/create ou equivalente);
3. o WMS valida, mapeia SKU e reserva estoque elegível;
4. separação, packing e expedição avançam no armazém;
5. a integração cria o fulfillment com transportadora, rastreio e itens expedidos;
6. o WMS republica o nível de estoque por localização.

A decisão sobre qual sistema é dono de cada estado deve ser registrada em um desenho de integração com origem, destino, gatilho, contrato, SLA e responsável. Consulte integrações WMS para a arquitetura completa.

Cadastros e localidades

Mapeie SKU e variante da Shopify ao item do WMS, além de unidade, kit, código de barras e localização (location_id). Uma variante sem correspondência deve ir para fila de erro, não criar um item genérico. Estoques de CD e loja física precisam ser associados às localidades corretas na Shopify para que uma atualização não altere o saldo de outra origem por engano.

Pedidos e fulfillment

Consuma o pedido com identificador estável (order id e order number), itens, endereço, serviço e situação de pagamento. O WMS confirma separação, packing e expedição; a integração cria ou atualiza o fulfillment na Shopify com volumes e código de rastreamento por transportadora. Pedidos divididos em mais de um volume ou parcialmente atendidos exigem confirmação parcial por item e quantidade, não um único evento genérico de "expedido".

Estoque e overselling

Publique estoque vendável na Shopify, não o físico bruto: desconte reservas, bloqueios e buffer de segurança. Webhooks de estoque (inventory_levels/update) aceleram a atualização entre canais; uma rotina de reconciliação periódica corrige eventos perdidos ou atrasados. Idempotência evita duplicar pedidos em reenvios, e controle de versão impede que um saldo antigo sobrescreva um mais recente. Veja também como evitar estoque negativo.

Exceções e testes

Teste cancelamento antes e depois do picking, alteração de endereço, reembolso, devolução, SKU ausente, kit, pedido duplicado, múltiplas localizações e indisponibilidade da API da Shopify. Registre o ID do pedido nos dois sistemas e um correlation ID comum. Monitore atraso de webhook, backlog, rejeições e divergência de estoque por localização.

Passo a passo recomendado

1. Mapeie processos, sistemas e autoridades de dados.
2. Defina contratos, IDs, estados e regras de transformação.
3. Implemente autenticação, idempotência, filas e auditoria.
4. Homologue o fluxo normal e todas as exceções relevantes.
5. Monitore latência, erros, backlog e divergências.
6. Faça reconciliação e ensaie a recuperação antes da produção.

Erros comuns

• Integrar telas ou tabelas sem um contrato estável.
• Atualizar o mesmo dado nos dois lados sem autoridade definida.
• Ignorar limites, versões, reenvios e eventos fora de ordem.
• Não preservar os identificadores de origem.
• Colocar dados pessoais ou segredos em logs.
• Entrar em produção sem painel, alerta e procedimento de replay.

Exemplo prático

Um pedido recebe o mesmo identificador em toda a cadeia. A integração valida o conteúdo e o WMS confirma a aceitação sem confundi-la com expedição. Durante a operação, eventos informam reserva, separação e despacho. Se o destino estiver indisponível, a mensagem permanece em fila. Após a recuperação, o consumidor reconhece a chave idempotente, processa uma única vez e a reconciliação confirma os totais.

Perguntas frequentes

É preciso usar um app do Shopify App Store para integrar?

Não necessariamente. É possível integrar diretamente pela Admin API/GraphQL com um app privado ou customizado, desde que a equipe assuma manutenção, autenticação e monitoramento. Apps prontos podem acelerar, mas ainda exigem validar mapeamento e regras específicas da operação.

O WMS deve controlar todas as localizações da Shopify?

Só as que ele efetivamente executa. Uma loja física com PDV próprio pode manter sua própria baixa; o WMS controla o CD e qualquer localização cujo estoque ele movimenta fisicamente.

O que fazer se o pedido chegar antes do produto estar cadastrado no WMS?

Rejeite ou coloque em fila de erro com motivo claro, em vez de criar um item genérico. Um SKU sem mapeamento correto compromete estoque, picking e fulfillment do pedido inteiro.

Conclusão

Integrar WMS e Shopify exige alinhar processo, autoridade de dados e mecanismos técnicos. Mapeamento de SKU e localização, estoque vendável por webhook, idempotência e testes de exceção mantêm pedido, fulfillment e disponibilidade coerentes entre os dois sistemas.