Conectar a loja Shopify
O app é da sua loja. Você cria no Dev Dashboard da Shopify, instala na própria loja e cola aqui o ID do cliente e a chave secreta.
Quando usar
Use esta conexão quando a loja vende na Shopify e você quer que os pedidos (com código de rastreio, quando houver) apareçam em Pedidos e Rastreios sem cadastro manual.
Quem pode fazer
Dono ou admin do time no SeuRastreio, e alguém com permissão de desenvolver apps na loja Shopify. Não há um app nosso para autorizar: cada loja usa o app que ela mesma cria.
Pré-requisitos
- Uma empresa (time) já criada no SeuRastreio.
- Acesso de dono da loja, ou permissão para desenvolver apps nela.
- O domínio .myshopify.com da loja (no admin: Configurações → Domínios). Não use o domínio da vitrine.
Passo a passo
As telas abaixo são do Dev Dashboard em outubro de 2026. O painel está em português. Abra dev.shopify.com com a conta da loja. Se preferir sair do admin: Configurações → Apps → Develop apps → Build apps in Dev Dashboard.
1. Crie o app. No menu, abra Apps e clique em Criar app, depois em Criar app manualmente. Dê um nome que você reconheça, por exemplo SeuRastreio. Em URL do app, use https://shopify.dev/apps/default-app-home — o app não abre dentro do admin. Deixe Incorporar app ao admin da Shopify desmarcado e não marque Usar fluxo de instalação legado.

Formulário Criar um app no Dev Dashboard, com a URL do app preenchida 2. Informe as permissões e crie. Em Escopos, cole exatamente read_orders,read_fulfillments. Não acrescente read_all_orders: o formulário recusa esse nome. Em Versão da API de webhooks, deixe a mais recente da lista (em outubro de 2026, 2026-10). Clique em Criar app. Essa ação já publica a primeira versão.

Escopos read_fulfillments e read_orders e a versão da API de webhooks em 2026-10 3. Instale na sua loja. Na visão geral do app, no cartão Instalações, clique em App de teste. Escolha a loja (o endereço .myshopify.com) e confirme a instalação. O app e a loja precisam estar na mesma organização do Dev Dashboard — crie o app a partir da conta dessa loja.

Visão geral do app com o cartão Instalações e o botão App de teste 4. Copie o ID do cliente e a chave secreta. No menu do app, abra Configurações. Em Credenciais, copie ID do cliente (é o app id) e Chave secreta do cliente. Use o olho para revelar a chave e copie sem espaço no começo ou no fim.

Configurações do app com ID do cliente e Chave secreta do cliente 5. Cole no SeuRastreio. No SeuRastreio, abra Integrações e, no card Shopify, Conectar Shopify. Informe o domínio .myshopify.com, o ID do cliente e a chave secreta. Conectar loja confere o app na Shopify antes de salvar. Nenhum pedido entra nesse momento.
6. Importe os pedidos. O card volta com o selo Conectado e o nome da loja. Em Pedidos, use Sincronizar (dono ou admin) para trazer o que a Shopify já entregou. A leitura cobre os pedidos dos últimos 60 dias.
Resultado esperado
A Shopify aparece como conectada. Os pedidos importados ficam em Pedidos. O rastreio, quando o pedido já tem código, segue em Rastreios.
Erros comuns
- Domínio da vitrine. Use o endereço .myshopify.com, não o domínio personalizado da loja.
- App e loja em organizações diferentes. O app precisa nascer na mesma conta da loja. Crie de novo a partir do admin dessa loja.
- App ainda não instalado. Sem a instalação, a Shopify não entrega pedidos. Volte em Instalações e confirme a loja.
- Escopo recusado ou faltando. O campo Escopos aceita read_orders,read_fulfillments. Se faltar um dos dois, abra Versões → Criar versão, inclua o escopo, publique e instale de novo.
- Chave com espaço. Cole de novo a chave secreta, sem espaço no fim.
- Sem permissão no time. Peça a um dono ou admin para conectar. Membros não veem o botão.
- Limite de pedidos do plano. A sincronização para quando a cota mensal enche. Ajuste o plano em Plano e cobrança.
Relacionados
- Consultar pedidos importados
- Acompanhar rastreios
- API: criar ou atualizar pedido
- Loja Integrada
- Nuvemshop
- LiveXa
- Bling
Caminho no painel: Dashboard → Integrações.
- atualizadoEm
- superficie
- dashboard
- owner
- Technical Writer
- printsGeradosEm