Preciso de um plano Shopify Plus para usar o Query Streams?

Não. O Query Streams funciona com qualquer plano do Shopify, incluindo Basic, Shopify e Advanced. As lojas Plus se beneficiam de limites de taxa de API mais altos, mas o Query Streams lida com a limitação de taxa automaticamente em todos os planos.

Por que o Query Streams precisa de um aplicativo personalizado em vez de um aplicativo privado?

A Shopify descontinuou os aplicativos privados em favor dos aplicativos personalizados para a API de administração. Os aplicativos personalizados fornecem o mesmo acesso somente leitura, mas usam credenciais de cliente OAuth — uma abordagem de autenticação mais segura e padrão, compatível com todos os planos da Shopify.

Posso conectar várias lojas Shopify?

Sim. Adicione um conector separado para cada loja — cada um com suas próprias credenciais de aplicativo personalizado. Todas as lojas aparecem como fontes de dados distintas no construtor de consultas, então você pode até mesmo unir dados entre lojas em uma única consulta SQL.

Como os valores do Shopify são tratados? O Stripe usa centavos — o Shopify também?

Diferentemente do Stripe, o Shopify retorna os valores como decimais (por exemplo, 99,99 em vez de 9999), portanto, nenhuma conversão é necessária em suas consultas SQL. Valores em múltiplas moedas estão disponíveis na coluna JSON raw_data.

Conecte o Shopify ao Excel - Consulte dados de comércio eletrônico com SQL

Conectar o Shopify ao Excel

Obtenha dados de Shopify em Excel

Importe dados em tempo real da sua conta Shopify para o Excel e atualize-os quando quiser. Sem driver ODBC, sem exportações, sem macros. Leva cerca de dez minutos na primeira vez, e o plano gratuito cobre esse custo.

Cerca de 10 minutos Não é necessário programar As credenciais permanecem com você. Excel em qualquer lugar, até mesmo na web.

Teve alguma dúvida? É só perguntar. Aberto Suporte Em Fluxos de Consulta (menu no canto superior direito → Suporte) e envie-nos uma mensagem. Pessoas reais leem as mensagens, e "Não sei o que esta tela está pedindo" é uma pergunta perfeitamente válida.

O resultado final será o que você obterá.

Uma planilha que exibe os resultados em tempo real de uma consulta SQL em sua conta Shopify, com um botão que busca as linhas mais recentes sempre que os dados forem alterados. Assim:

Vendas.xlsx — Excel

InícioInserirDadosFluxos de consulta

	A	B	C	D	E
1	ID do cliente	primeiro nome	sobrenome	país	total
2	1042	Maria	Álvarez	EUA	1,284.50
3	1043	Daniel	Okafor	EUA	612.00
4	1047	Priya	Nair	EUA	2,090.75
5	1051	Thomas	Berg	EUA	338.20
6	1056	Lúcia	Ferreira	EUA	1,455.00
7	1060	Kenji	Sato	EUA	874.10
8

Folha1

Direto da Shopify

A Shopify armazena seus dados por trás de sua API. Para importá-los para o Excel, geralmente é necessário exportar um arquivo CSV do painel da Shopify sempre que precisar de novos números. O Query Streams elimina essa necessidade: um pequeno programa auxiliar, chamado Agente, executa a consulta no local onde seus dados estão armazenados, e um suplemento do Excel solicita as linhas desejadas. Somente os resultados são transmitidos por meio de uma conexão criptografada, e o Excel pode ser acessado de qualquer lugar: seu laptop em casa, o computador de um colega em outra cidade ou o Excel na web.

O Agente trabalha em conjunto com seus dados. O Excel não precisa. Abra a planilha em qualquer lugar e as linhas aparecerão automaticamente.

O que você vai precisar

Uma conta do Query Streams

O plano gratuito é suficiente para este guia. Cadastre-se em my.querystreams.com.

O Agente em qualquer computador sempre ligado

Um pequeno programa que roda em segundo plano e acessa o Shopify quando o Excel solicita. Ele só precisa de acesso à internet.

Seu login do Shopify

Você fará login no Shopify uma única vez e concederá acesso de leitura. Nenhuma senha é digitada nos Fluxos de Consulta.

Qual computador receberá o Agente? Qualquer dispositivo que esteja sempre ligado e que já consiga acessar sua conta Shopify. O Excel pode estar em qualquer lugar., incluindo o Excel na web.

Conecte-o em cinco etapas

Crie sua conta

Vá para my.querystreams.com e inscreva-se. Escolha o Gratuito É um plano real, não uma versão de teste, e inclui a conexão da sua conta Shopify e a execução de consultas a partir do Excel.
Instale o Agente em qualquer computador que esteja sempre ligado.
Faça login e abra DownloadInstale o Agente em qualquer computador ou servidor que esteja sempre ligado e com acesso à internet. Leva apenas um minuto e, a partir daí, ele inicia automaticamente.
Por que um programa pequeno em vez de um driver? O Agente é um único instalador para Windows, Mac ou Linux (cerca de 85 MB no Windows, um pouco mais de 100 MB no Mac e Linux) que funciona silenciosamente em segundo plano. Ele estabelece uma única conexão de saída criptografada com o Query Streams, da mesma forma que um navegador, portanto, você não precisa abrir nenhuma porta de firewall nem configurar uma VPN. Suas chaves permanecem nessa máquina e as linhas são enviadas para onde você estiver, pela internet, se necessário. A única coisa do seu lado é o complemento.
A página de download mostra Sua chave de acessoCole o código no Agente quando solicitado e aguarde até que o crachá exiba a mensagem. Conectado a fluxos de consultaEssa é a única coisa que você faz no próprio Agente.
Guias completos, se você quiser: Janelas, Mac, Linux.

Aponte para sua conta Shopify.

De volta ao seu navegador, abra Agentes de dados (sob Dados (no menu superior). Seu agente está listado lá. Clique Adicionar conector e escolha Shopify. Need your Shopify credentials first? Open the walkthrough, then fill in:

Create your Shopify credentials (about 10 minutes)

Follow this with Shopify open in another tab. Query Streams keeps what you create here so your Agent can use it, and only ever reads from Shopify.

Who can do this: Store owner, or a staff account with the App development > Develop permission (collaborator accounts can’t use the Dev Dashboard)
Recomendado: Dev Dashboard app (custom app) in your store’s own Shopify organization: Client ID + Client secret, read-only scopes

Antes de começar

Your Shopify store’s admin login: the store owner, or a staff account with the App development > Develop permission. Store owners have it automatically.
The Query Streams wizard open in another tab: Data Agents → Add connector → Shopify, with your Agent online.
No coding. Shopify no longer lets you copy a ready-made access token for a new app; Query Streams turns the app’s Client ID and Client secret into a short-lived token itself.

Steps

Open your store’s app settings
Sign in to your Shopify admin. Click Settings (bottom-left), then Apps.
On some stores this menu item reads Apps and sales channels. Use the admin of the exact store you want to connect.
Click Develop apps
On the Apps settings page, click Develop apps.
No Develop apps button? Your staff account lacks the App development > Develop permission. Ask the store owner to grant it, or to do these steps.
Open the Dev Dashboard
Click Build apps in Dev Dashboard. The Dev Dashboard opens, usually in a new tab.
Open it this way, from your store’s admin, rather than signing in to dev.shopify.com separately. The app must be in the same Shopify organization as the store, or Query Streams can’t connect.
Click Create app
Check that Apps is selected in the left menu, then click Create app in the top-right corner.
Choose Start from Dev Dashboard
Select Start from Dev Dashboard (not Start with Shopify CLI).
Name the app
Type a name you will recognise, for example Query Streams, and click Create. The page for the app’s first version opens.
The name is only for you. Query Streams doesn’t need a particular name.
Keep the default App URL
In the URLs section, leave App URL as https://shopify.dev/apps/default-app-home (type it in if the box is empty). If you see an Embed app in Shopify admin option, leave it off.
Query Streams doesn’t open inside your Shopify admin, so Shopify’s default address is the right one.
Pick a Webhooks API version
In Webhooks API version, select the newest version in the list.
Query Streams doesn’t use webhooks, so any version works.
Add the read scopes
In the Access section, find Scopes. Paste this list, or click Select scopes and tick each one: read_orders, read_draft_orders, read_customers, read_products, read_inventory, read_locations, read_discounts, read_gift_cards, read_shipping, read_merchant_managed_fulfillment_orders, read_assigned_fulfillment_orders, read_third_party_fulfillment_orders, read_content, read_themes, read_legal_policies, read_shopify_payments_accounts, read_shopify_payments_payouts, read_shopify_payments_disputes. Leave Optional scopes empty.
Choose only read_ scopes: Query Streams never changes anything in your store. Do not add read_all_orders. Shopify rejects it for these apps with “Contains invalid scopes” (see Limits). read_payouts and read_shopify_payments are not valid names either. Keep the three Shopify Payments scopes even if you don’t use Shopify Payments; those tables just stay empty.
Click Release
Scroll to the bottom of the page and click Release. A dialog opens with an optional version name and message.
You can leave both boxes empty.
Confirm the release
Click Release in the dialog. On the app’s Versions page the new version now has an Active badge.
Click Install app
Open the app’s home page (click the app’s name, or Home in the app’s menu). In the Installs card, click Install app. A new tab opens.
The same action is in the ⋯ menu on the app’s row in the Apps list.
Choose your store
If you have more than one store, select the store you want to connect.
Pick the store whose admin you started from in step 1.
Clique em Instalar
Shopify shows an Install app screen listing the store data the app can view. Check it and click Install.
Back in the Dev Dashboard, the Installs card now shows 1 install. Refresh the page if it still shows 0.
Open the app’s Settings
In the Dev Dashboard, open your app and click Settings (App settings on some screens). Find the Credentials card.
Copy the Client ID
Next to Client ID, click the copy (clipboard) icon. Paste it into Client ID in the Query Streams wizard.
It is 32 letters and digits, for example a8ed94aa0680bc6580eea34486dcaa6b. It never changes.
Copy the Client secret
Next to Client secret (labelled Secret on some screens), click the eye icon to show it, then the copy icon. Paste it into Client secret in the Query Streams wizard.
It starts with shpss_. Shopify keeps showing it on this page, so you can come back for it later. Don’t click Rotate unless you mean to replace it.
Copy your store address
In your Shopify admin, go to Settings → Domains and copy the address that ends in .myshopify.com, for example your-store.myshopify.com. Paste it into Store address in the Query Streams wizard.
Your own domain (such as www.yourbrand.com) won’t work. The address in your browser bar while you’re in the admin, admin.shopify.com/store/your-store, is also accepted.
Test the connection
In the Query Streams wizard, click Test connection. It says Connected.
If it shows a message instead, find it under Common problems.

Permissions to grant

Resource	Acesso	Used for
leitura_de_pedidos	Ler	orders, order_line_items, transactions, refunds, fulfillments, order_risks and abandoned_checkouts tables (last 60 days, see Limits)
read_draft_orders	Ler	draft_orders table
ler_clientes	Ler	customers and customer_addresses tables
ler_produtos	Ler	products, variants, collections, smart_collections and custom_collections tables
ler_inventário	Ler	inventory_levels and inventory_items tables
localizações_lidas	Ler	locations table, and the per-location rows in inventory_levels
ler_descontos	Ler	price_rules and discount_codes tables
read_gift_cards	Ler	gift_cards table
read_shipping	Ler	shipping_zones and carrier_services tables
read_merchant_managed_fulfillment_orders	Ler	fulfillment_orders table: orders you fulfil from your own locations
read_assigned_fulfillment_orders	Ler	fulfillment_orders table (any one of the three fulfillment-order scopes turns the table on; all three give the complete list)
read_third_party_fulfillment_orders	Ler	fulfillment_orders table: orders fulfilled by third-party fulfilment services
read_content	Ler	blogs, articles and pages tables
read_themes	Ler	themes table
read_legal_policies	Ler	policies table
read_shopify_payments_accounts	Ler	needed together with the next two for the payouts and disputes tables (Shopify Payments stores only)
read_shopify_payments_payouts	Ler	payouts table
read_shopify_payments_disputes	Ler	disputes table

Paste into Query Streams

Store address: The .myshopify.com address from step 18 (or the admin.shopify.com/store/… address from your browser bar)
ID do cliente: The Client ID you copied in step 16
Client secret: The Client secret you copied in step 17 (starts with shpss_)

Common problems

Test connection says “The app and the store must belong to the same Shopify organization.”

Why: The app was created in a different Shopify organization from the store, for example after signing in to dev.shopify.com with another account or choosing another organization. Owning the store is not enough.

Fix: Start again from the store’s own admin: Settings → Apps → Develop apps → Build apps in Dev Dashboard, and create the app there (steps 1 to 17). If you belong to several organizations, the organization ID is in the Dev Dashboard address (dev.shopify.com/dashboard/<org-id>); the app and the store must be under the same one.

Test connection says “Client ID or Client secret is wrong, or the app isn’t installed on this store.”

Why: A value was copied incompletely or with a space, Client ID and Client secret were swapped, the secret was rotated, or the app isn’t installed on this store (or was uninstalled).

Fix: Copy both values again with the copy icons on the app’s Settings page; the secret starts with shpss_. Check that the app’s Installs card lists your store, and click Install app if it doesn’t. If someone clicked Rotate, use the secret marked New. Then click Test connection again.

Test connection rejects the store address (“Use your .myshopify.com address (Settings → Domains) or the admin.shopify.com/store/… URL. Custom domains can’t be used for the API.”) or says “Store not found. Check the store address.”

Why: Your own domain (such as www.yourbrand.com) was entered, or the store handle has a typo.

Fix: Copy the .myshopify.com address from Settings → Domains in your Shopify admin, or the admin.shopify.com/store/… address from your browser bar.

Test connection says “The token was accepted but has no scopes”, or some tables are switched off with a missing scope named (for example payouts needs read_shopify_payments_payouts).

Why: The scope isn’t on the app’s active version, or a new version was released but the store hasn’t approved it yet.

Fix: In the Dev Dashboard open your app → Versions → Create version, add the missing read_ scope and click Release. Then open the app and, in the Installs card, click Install app for your store again to approve the change: in our own test the store kept the old scopes until this was done. Click Test connection again.

Clicking Release shows “Contains invalid scopes”.

Why: read_all_orders was added (Shopify must approve it, and Dev Dashboard apps can’t request it), or a scope name is misspelt, such as read_payouts or read_shopify_payments.

Fix: Remove it and use exactly the names in step 9.

Orders older than about 60 days never appear.

Why: Shopify serves only the last 60 days of orders to apps without read_all_orders (see Limits).

Fix: Nothing to change in the app or in Query Streams today. Orders already loaded stay in your Query Streams cache, so your history builds up from the day you connect.

The payouts and disputes tables stay empty with the note “Shopify Payments isn’t enabled on this store, so there is nothing to load for this table.”

Why: The store takes payments through another provider, so Shopify has no payouts or disputes to share.

Fix: Nothing to fix. The other tables are not affected.

Customer names, emails, phone numbers or addresses are empty while the other columns load.

Why: Shopify treats these fields as protected customer data. Its help center says a store on the Basic plan can’t use custom apps that read them; the Grow plan or higher is needed.

Fix: Check which Shopify plan the store is on. On Basic, these columns stay empty until the store moves to Grow or higher; nothing in Query Streams changes this.

There is no Develop apps button, or the Dev Dashboard won’t open for you.

Why: Your staff account doesn’t have the App development > Develop permission, or you are signed in with a collaborator account, which can’t use the Dev Dashboard.

Fix: Ask the store owner to grant your staff account App development > Develop, or to follow these steps themselves.

Limits to know

Orders: Shopify gives apps only the orders created in the last 60 days. Older orders need the read_all_orders scope, which Shopify must approve, and the Dev Dashboard rejects it for these apps (“Contains invalid scopes: read_all_orders”, checked 2026-09-29). This covers the orders table and the tables built from it (order_line_items, transactions, refunds, fulfillments, order_risks) plus abandoned_checkouts. Products, customers, inventory and draft orders are not limited.
Access tokens last 24 hours. The Agent requests a fresh one from the Client ID and Client secret automatically; you never copy or renew a token.
Shopify limits API reading by store plan: 100 cost points per second on standard plans, 200 on Advanced, 1,000 on Shopify Plus and 2,000 on Shopify for enterprise; one request can’t cost more than 1,000 points. The first full load of a large store can take a while; when Shopify throttles, the Agent waits and continues.
payouts and disputes have rows only if the store uses Shopify Payments.

Steps verified 8 October 2026. Sources: shopify.dev/docs/apps/build/dev-dashboard/create-apps-usi…, shopify.dev/docs/apps/build/authentication-authorization/…, shopify.dev/docs/apps/build/authentication-authorization/…, shopify.dev/docs/apps/build/authentication-authorization/…, shopify.dev/docs/api/usage/access-scopes, shopify.dev/docs/apps/build/apis/graphql-admin/rate-limits, shopify.dev/docs/apps/launch/protected-customer-data, help.shopify.com/en/manual/apps/install-setup-apps, help.shopify.com/en/manual/apps/about-apps, help.shopify.com/en/manual/domains, changelog.shopify.com/posts/legacy-custom-apps-can-t-be-c…, kb.wolfandbadger.com/creating-your-custom-shopify-app-usi…, docs.mydbsync.com/cloud-workflow/connectors/shopify/steps…, help.sarasanalytics.com/pulse-shopify-/shopify-app-creati….

Nome da conexão: Qualquer nome que você reconheça mais tarde, como Banco de Dados de Vendas.
URL da loja: O endereço da sua loja Shopify, como sua-loja.minhashopify.com.
ID do cliente: O ID do cliente do aplicativo personalizado que você criou para sua loja na Shopify.
Segredo do Cliente: O Segredo do Cliente desse mesmo aplicativo da Shopify.

Clique em Teste de conexãoQuando lê Conectado, clique SalvarA conexão chega ao seu agente em poucos segundos.

Agentes de Dados Abertos

O teste falhou? Usually a missing permission, or a credential from the wrong Shopify account. The walkthrough above lists the common problems and their fixes.

Adicionar fluxos de consulta ao Excel

No Excel, acesse Inserir → Obter suplementos, procurar Fluxos de consultae clique AdicionarOu abra-o diretamente de Consultar fluxos no Microsoft AppSourceUm botão "Consultar fluxos" aparece na faixa de opções. Faça login com a mesma conta.

Funciona no Excel para Microsoft 365 no Windows e no Mac, e no Excel na Web.
Puxe sua primeira mesa.

Clique no botão Consultar fluxos e escolha Transmita uma consultaE selecione a conexão que você acabou de fazer.

Digite a consulta que deseja executar. Esta consulta extrai algumas colunas de uma tabela. shopify.orders mesa:
Exemplo · SQL
```
SELECT name, financial_status, total_price, created_at FROM shopify.orders ORDER BY created_at DESC LIMIT 100;
```
Sob Folha de Destino escolher Criar uma nova planilhaEm seguida, pressione o botão de reprodução (a seta ▶). As linhas serão exibidas no Excel em um ou dois segundos. Pressione-o novamente sempre que os dados forem alterados e a planilha será atualizada automaticamente.

Não conhece SQL? Em vez disso, crie a consulta no portal Query Streams. Construtor de consultas Exibe suas tabelas e colunas para que você possa apontar e clicar. Nos planos Business, você também pode usar o Nova em linguagem natural ("mostre-me os clientes nos EUA") e ele gera o SQL para você. Salve a consulta e ela estará a um clique de distância no portal e na lista de Consultas Salvas do suplemento, a partir do plano Personal Core.

É isso. Seus dados estão na planilha e permanecem atualizados com um clique. Nada saiu da sua rede, exceto as linhas que você solicitou.

Boas próximas jogadas

Salvar consulta no portal, para que você possa executá-lo novamente com um clique, a partir do Excel ou do Google Sheets.
Adicionar um filtro como um intervalo de datas, para que a mesma consulta possa responder "este mês" sem precisar editar.
Compartilhe os resultados Com um colega. Eles veem as fileiras, não suas credenciais.

Perguntas que as pessoas fazem

O Excel precisa estar instalado no mesmo computador que sua conta Shopify?

Não. Apenas o Agente precisa estar no mesmo local que sua conta Shopify. O Excel pode ser executado em qualquer computador com conexão à internet, incluindo o Excel na Web e o Excel no Mac. Faça login no suplemento com sua conta e suas conexões estarão lá.

Meus dados são copiados para o Query Streams?

Não. O agente executa a consulta no local onde seus dados estão armazenados e envia apenas as linhas retornadas. Nada é sincronizado ou armazenado nesse meio tempo.

O plano gratuito realmente cobre isso?

Sim. A versão gratuita é um plano permanente, não um período de teste com prazo de validade. Veja exatamente o que está incluído no plano. página de preços.

Funciona com o Excel para Mac?

Sim. Excel para Microsoft 365 no Mac e no Windows, e Excel na Web.

Ainda com dificuldades? Aberto Suporte Em Fluxos de Consulta, informe-nos em qual etapa você está e o que você vê. Nós o conectaremos.

Crie sua conta do plano gratuito.Veja o que está incluído na versão gratuita.