Pular para o conteúdo
ISBI
Integrações

Shopify · E-commerce

Dados da Shopify sem depender de app de relatório

A Shopify tem a API mais madura do grupo, e por isso mesmo tem armadilha: o caminho REST é legado e o novo é GraphQL, com cobrança por complexidade de consulta. Fazemos a extração pelo caminho certo.

Onde isso costuma travar

Operação na Shopify normalmente já tem volume, e volume muda o problema. Não é mais "conseguir os dados": é conseguir anos de pedido sem estourar limite, com o custo por cliente calculado e a mídia amarrada à venda. E é onde a escolha técnica pesa, porque o caminho que a maioria dos tutoriais ensina está sendo desativado.

O que é específico do Shopify

Cada sistema tem os seus próprios pontos cegos, e generalizar aqui não ajuda ninguém. Estes são os do Shopify.

    01

    O caminho REST é legado desde 2024

    A API REST de administração passou a legado em 1º de outubro de 2024, e desde 1º de abril de 2025 todo aplicativo público novo precisa ser construído apenas com a API GraphQL. Integração escrita hoje em REST nasce com prazo de validade, e essa é a decisão técnica que mais aparece errada em projeto de dados de Shopify.

    02

    O limite é por custo de consulta, não por chamada

    No GraphQL cada consulta tem um custo calculado pela complexidade, descontado de um saldo que se recompõe com o tempo e que nos planos padrão vale cem pontos por segundo. Contar requisições não ajuda: uma consulta mal desenhada gasta o saldo inteiro, e outra bem desenhada traz o mesmo dado por uma fração.

    03

    Carga histórica pede operação em lote

    Puxar anos de pedido em consultas normais esbarra no custo máximo. O caminho é a operação em lote, que roda de forma assíncrona e escapa do limite de custo. Quem não usa isso acaba escrevendo um script que leva dias e falha no meio.

    04

    Margem real continua fora da plataforma

    Custo do produto, taxa de pagamento, frete real e gasto de mídia não moram na Shopify. O painel nativo é excelente em faturamento e não tem como fechar a conta de rentabilidade sozinho.

Como tiramos o dado de lá

Leitura programada, sem exportação manual

    01

    GraphQL Admin API, o caminho vigente

    A extração é feita pela API GraphQL de administração, que é o caminho suportado. Isso evita reescrever a integração quando o REST for desativado de vez.

    02

    Consulta desenhada para o custo, não para o volume

    Cada campo tem custo próprio, e a consulta é escrita pedindo só o necessário. Dá para inspecionar o custo real de cada chamada e ajustar antes de rodar em produção, em vez de descobrir com erro 429.

    03

    Histórico por operação em lote

    A carga inicial usa operação em lote, que processa volume alto de forma assíncrona sem o teto de custo das consultas normais. Depois dela, só o incremento diário.

O que trazemos

  • Pedidos, itens e descontos
  • Produtos, variantes e custo
  • Clientes e histórico de compra
  • Transações e taxa de pagamento
  • Frete e cumprimento do pedido
  • Devoluções e reembolsos

Costuma vir junto com

Sistema de origem sozinho responde pouco. A pergunta de gestão quase sempre exige cruzar dois ou três, e é esse cruzamento que não existe pronto em nenhum deles.

Conferido na documentação oficial

O que muda

As perguntas que passam a ter resposta

    Qual a margem por produto depois de taxa, frete e mídia

    Qual o valor de um cliente ao longo do tempo, por canal de origem

    Que campanha traz cliente que recompra

    Quanto a devolução custou no trimestre

    Como o resultado deste ano compara ao anterior, por linha

Perguntas frequentes

Já pago um app de analytics na Shopify. Preciso disso?+

Depende do que falta. App de analytics é bom no que está dentro da loja. Se a pergunta envolve custo do produto no ERP, gasto de mídia ou comparação com outro canal de venda, o dado necessário está fora da Shopify e nenhum app dentro dela alcança.

A extração pode derrubar ou atrasar minha loja?+

Não. A leitura acontece pela API de administração, separada da vitrine que o cliente acessa. A carga histórica usa operação em lote, desenhada pela própria Shopify para volume alto sem impacto.

Minha integração atual usa REST. Isso é problema?+

É um risco com data. REST virou legado em 1º de outubro de 2024, e desde 1º de abril de 2025 aplicativo público novo já precisa de GraphQL. Continuar em REST funciona hoje e vai exigir reescrita. Se vamos construir agora, construímos no caminho que fica.

Quanto histórico dá para trazer?+

Em geral todo o que a loja tem. A operação em lote foi feita para isso. O que limita não é a API, é a qualidade do dado antigo, e isso a gente avalia no diagnóstico.

Usa Shopify? Vamos ver o que dá para extrair dele

Seis perguntas, cerca de dois minutos. Roda no seu navegador e não pede e-mail para mostrar o resultado.