Conectar a Shopify: receber pedidos e enviar fulfillment
Crie um app personalizado no Shopify Admin, cole o token no Integration, teste, mapeie e ative.
O conector da Shopify traz pedidos para o OMS e devolve estoque e fulfillment à Shopify. Uma conexão por loja.
Pré-requisitos#
- Uma loja Shopify em qualquer plano, com acesso de administrador.
- Permissão para criar apps personalizados nessa loja.
- Use primeiro uma loja de teste ou desenvolvimento; nunca teste o mapping numa loja em produção.
Obter credenciais — modelo novo (recomendado)#
- Vá ao Shopify Dev Dashboard (dev.shopify.com) → seu app → credenciais de API.
- Copie o Client ID e o Client Secret. O secret é exibido uma única vez.
- Certifique-se de que o app tenha os escopos: read_orders, read_products, read_inventory, write_inventory, read_fulfillments, write_fulfillments.
Obter credenciais — modelo antigo (token de app personalizado)#
- No Shopify Admin: Configurações → Apps → Develop apps → Criar app.
- Em Admin API integration, conceda os escopos: read_orders, read_products, read_inventory, write_inventory, read_fulfillments, write_fulfillments.
- Instale o app e copie o Admin API access token. Começa com shpat_.
Preencher no Integration#
- Abra Integration → Marketplace → Shopify → Nova conexão.
- Domínio da loja: por exemplo your-store.myshopify.com.
- Credenciais: escolha um dos dois modelos. Novo (recomendado): Client ID + Client Secret do Dev Dashboard; o sistema os troca por um token de 24h automaticamente. Antigo: Admin API access token (shpat_) de um app personalizado. Ambos criptografados, nunca exibidos.
Testar a conexão#
O teste tem dois níveis: conectividade e prévia de um pedido real.
Mapping / escolher modelo#
Escolha o modelo padrão da Shopify. Revise bundles e propriedades personalizadas na prévia.
Ativar#
Após ativar, o Integration traz pedidos na frequência definida, devolve estoque e reporta fulfillment com rastreio.
Perguntas frequentes#
O teste falha com 401
O token está incorreto, expirado ou sem um escopo necessário.
Reinstale o app, copie o token de novo e revise os escopos da etapa de credenciais.
Nenhum pedido é importado
A conexão está bem: a loja simplesmente não tem pedidos novos.
Crie um pedido de teste na loja e execute uma extração manual.
SKUs aparecem como não mapeados
O SKU do canal ainda não está vinculado a um produto no OMS.
Abra a aba de pendentes em Product Mapping e vincule cada SKU do canal a um produto do OMS.