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. 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
    Formulário Criar um app no Dev Dashboard, com a URL do app preenchida
  2. 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
    Escopos read_fulfillments e read_orders e a versão da API de webhooks em 2026-10
  3. 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
    Visão geral do app com o cartão Instalações e o botão App de teste
  4. 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
    Configurações do app com ID do cliente e Chave secreta do cliente
  5. 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. 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

Caminho no painel: Dashboard → Integrações.

atualizadoEm
superficie
dashboard
owner
Technical Writer
printsGeradosEm