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.
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.
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.
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.
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
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.
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.
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.
O trabalho por trás disso
Pipelines de dados
Os dados param de ser copiados e colados à mão. Conectamos ERP, planilhas, e-commerce e CRM num fluxo que roda sozinho todo dia e entrega tudo no mesmo lugar, já pronto para uso.
ETL/ELT
Quando um número parecer estranho, você vai saber de onde ele veio. Cada passo entre a fonte bruta e os dados finais é automatizado, testado e versionado, então dá para rastrear exatamente onde e por que algo mudou.
Modelagem (DW)
Dois relatórios nunca mais mostram números diferentes para a mesma pergunta. As regras de negócio ficam escritas e versionadas num lugar só, em vez de espalhadas por fórmulas de planilha que ninguém lembra quem fez.
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.
