Como conectar o ShipStation ao Excel - Consultar dados de remessa com SQL

Conectar o ShipStation ao Excel

Obtenha dados de ShipStation em Excel

Importe dados em tempo real da sua conta ShipStation 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 isso.

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

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

Uma planilha que exibe os resultados em tempo real de uma consulta SQL em sua conta ShipStation, com um botão que busca as linhas mais recentes sempre que os dados são 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 do ShipStation

O ShipStation armazena seus dados por meio de sua API. Para importá-los para o Excel, geralmente é necessário exportar um arquivo CSV do painel do ShipStation 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 estar em qualquer lugar: no seu laptop em casa, no computador de um colega em outra cidade ou na web.

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 chama o ShipStation quando o Excel solicita. Ele só precisa de acesso à internet.

Seu login do ShipStation

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

Conecte-o em cinco etapas

1. 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 abrange a conexão da sua conta ShipStation e a execução de consultas a partir do Excel.

2. 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.

3. Aponte para sua conta ShipStation.

   De volta ao seu navegador, abra Agentes de dados (sob Dados (no menu superior). Seu agente está listado lá. Clique Adicionar conector e escolha ShipStationPrecisa das suas credenciais do ShipStation primeiro? Abra o guia passo a passo e preencha os campos:

   Crie suas credenciais do ShipStation (cerca de 5 minutos)

   Em seguida, abra o ShipStation em outra aba. O Query Streams armazena o que você cria aqui para que seu agente possa usar, e lê apenas do ShipStation.

   Quem pode fazer isso?

   Proprietário da conta (o ShipStation permite que apenas o proprietário da conta gere chaves de API)

   Recomendado

   Chave de API ShipStation V2 (Chave de Produção)

   Antes de começar

   • Um plano ShipStation com acesso à API: Standard, Accelerate, Premium ou superior. Os planos Free e Starter não incluem acesso à API.
   • O login do proprietário da conta no ShipStation e o acesso à caixa de entrada de e-mail do proprietário (na primeira vez, o ShipStation envia um link de verificação por e-mail antes de criar uma chave).
   • Se sua empresa usa a API do ShipStation (o produto para desenvolvedores anteriormente chamado ShipEngine) em vez do aplicativo web do ShipStation, sua chave está no painel da API do ShipStation em https://api-portal.shipstation.com/: mude para o ambiente de Produção, copie uma chave de produção e siga diretamente para o assistente. Chaves que começam com TEST_ são chaves de ambiente de teste (sandbox).
   • O assistente de fluxos de consulta é aberto em outra guia: Agentes de dados → Adicionar conector → ShipStation.

   Passos

   1. Inicie sessão no ShipStation como proprietário da conta.

      Abra o ShipStation em uma nova aba e faça login com as credenciais do proprietário da conta. Somente o proprietário da conta pode gerar chaves de API, e o ShipStation exibe uma nova chave apenas uma vez, e somente para a pessoa que a gerou.

      Não é o proprietário? Peça ao proprietário para executar os passos de 1 a 11 e colar a chave no assistente de Consulta de Fluxos ou enviá-la para você por meio de um gerenciador de senhas. Se você não tiver certeza de quem é o proprietário, o suporte do ShipStation ([email protected]) poderá ajudá-lo.

   2. Abra as configurações

      Clique no ícone de engrenagem (Configurações) na barra de ferramentas escura no canto superior direito da tela, entre o ícone da impressora e o ícone de ponto de interrogação.

      Algumas contas também acessam a mesma área de configurações através do ícone de pessoa → Meu Perfil.

   3. Configurações da API aberta

      Na barra lateral esquerda, expanda "Conta" (se estiver recolhida) e clique em "Configurações da API". O título da página é "Configurações da API", com uma caixa "Chaves da API" abaixo. Depois de fazer login, o link abrirá esta página diretamente.

      Se a página indicar que seu plano não oferece suporte ao acesso à API, significa que sua conta é gratuita ou inicial. Primeiro, atualize para o plano Standard ou superior em Conta → Pagamento e Assinatura.

   4. Escolha a API V2.

      Na lista suspensa Selecionar versão da API, escolha API V2.

      O menu suspenso pode ser aberto na API V1. O Query Streams usa a API V2 do ShipStation. Uma chave V1 é fornecida como uma chave de API mais uma chave secreta e falha no teste de conexão com a mensagem "Chave de API inválida".

   5. Verifique se já existe uma chave V2.

      Se a caixa exibir um botão "Gerar chave de API", vá para a etapa 6. Se, em vez disso, exibir uma linha "Chave de produção" com uma chave oculta, um ícone de cópia e um ícone de lixeira, a conta já possui sua única chave V2 permitida.

      Se a chave existente estiver salva em um local seguro (um gerenciador de senhas ou a configuração de outra ferramenta da qual você possa copiar), use-a e prossiga diretamente para o assistente. Caso contrário, clique no ícone da lixeira e, em seguida, em "Excluir chave" na janela pop-up "Excluir chave da API". A exclusão é irreversível e qualquer outra ferramenta que utilize a chave antiga deixará de funcionar até que você forneça a nova.

   6. Clique em Gerar chave de API

      Clique em Gerar chave de API à direita da caixa. Se uma janela pop-up intitulada Gerar chave de API for exibida, pule para a etapa 9. Se, em vez disso, aparecer um aviso azul (“Verificação de e-mail necessária. Clique no link de verificação que enviamos para o seu endereço de e-mail e tente novamente.”), siga as etapas 7 e 8.

      O ShipStation solicita essa verificação de e-mail antes da primeira chave da conta. Novas contas precisam verificar seu e-mail antes de poderem gerar chaves.

   7. Clique no link de verificação no seu e-mail.

      Abra o e-mail que a ShipStation enviou para o endereço do proprietário da conta e clique no link de verificação contido nele.

      Não recebeu o e-mail em alguns minutos? Verifique as pastas de spam e promoções.

   8. Clique em Gerar chave de API novamente

      Volte à aba Configurações da API, verifique se a opção Selecionar versão da API ainda mostra API V2 e clique em Gerar chave da API novamente.

      O botão reinicia após a verificação do e-mail. Se o aviso azul ainda estiver visível, recarregue a página e selecione a API V2 novamente.

   9. Selecione uma data de expiração e clique em Gerar.

      Na janela pop-up "Gerar chave de API", em "Definir expiração da chave", escolha 12 meses, 6 meses ou 3 meses e clique em "Gerar".

      A chave deixa de funcionar nessa data e a sincronização do ShipStation também para. Selecione 12 meses e adicione um lembrete ao seu calendário; o ShipStation também envia um lembrete por e-mail antes do vencimento da chave.

   10. Copie a chave da API.

       Uma janela pop-up intitulada "Chave de API criada" será exibida com um aviso de que esta é a única vez que a chave estará visível. Clique no ícone de copiar (dois quadrados sobrepostos) à direita de "Chave de API".

       Cole a chave diretamente no assistente de Fluxos de Consulta (ou em um gerenciador de senhas), não em um e-mail ou chat. Se a janela pop-up também mostrar uma linha "Chave Secreta", você criou uma chave V1: clique em "Concluído", volte para a etapa 4 e escolha a API V2.

   11. Clique em Concluído

       Clique em Concluído. De volta às Configurações da API, a chave agora aparece oculta. O ShipStation não a revelará novamente; se você a perder, exclua-a e gere uma nova.

   Permissões a conceder

   Recurso	Acesso	Usado para
   Chave de API V2 (Selecione a versão da API → API V2)	Acesso total à conta. O ShipStation não possui chaves somente leitura ou com acesso limitado.	Todas as tabelas do shipstation.*: remessas, etiquetas e entregas (ativadas por padrão), além de transportadoras, serviços de transportadoras, armazéns, produtos, lotes, manifestos, coletas, tags, usuários e webhooks. O Query Streams envia apenas solicitações de leitura.
   Plano: Standard, Accelerate, Premium ou superior	Obrigatório	Sem isso, o ShipStation responde com um código 402 e não há sincronização de tabelas. Os planos gratuito e Starter não têm acesso à API.
   API de Inventário (Configurações → Complementos)	Incluído nos planos Standard e superiores; um adicional nos planos inferiores.	As tabelas inventory e inventory_locations. Uma chave que possui apenas o complemento (plano abaixo do Standard) ainda falha no teste de conexão, porque o teste lê os envios.
   Proprietário da conta	Necessário para gerar a chave.	Não há tabela. O ShipStation permite que apenas o proprietário da conta crie chaves de API.

   Colar em Fluxos de Consulta

   Chave da API do ShipStation

   A chave de API que você copiou na etapa 10: um único valor, sem segredo. Uma chave que começa com TEST_ é uma chave de sandbox e exibe apenas dados de sandbox. O Query Streams armazena a chave do seu agente e só lê dados com ela.

   Problemas comuns

   O teste de conexão mostra um resultado em vermelho: Chave de API inválida.

   Por que: Uma chave V1 ou sua chave secreta foi colada, o valor passou a conter espaços extras, a chave foi excluída ou expirou.

   Consertar: Gere uma chave V2 (passos 4 a 11) e cole apenas o valor da chave da API. Clique em Testar conexão até que a mensagem "Conectado" seja exibida.

   O teste de conexão mostra o erro de API: PaymentRequired.

   Por que: A ShipStation respondeu ao erro 402: a conta está em um plano inferior ao Standard (Gratuito ou Inicial) ou possui apenas o complemento API de Inventário.

   Consertar: Atualize para o plano Standard ou superior em Conta → Pagamento e Assinatura e clique em Testar novamente com a mesma chave.

   Não é possível gerar uma chave: a opção "Gerar chave de API" continua exibindo a mensagem "Verificação de e-mail necessária" ou "A pessoa que está configurando não tem permissão para criar chaves".

   Por que: Somente o proprietário da conta pode gerar chaves, e somente após verificar seu endereço de e-mail.

   Consertar: Faça login como proprietário da conta, clique no link no e-mail de verificação do ShipStation e, em seguida, clique em Gerar chave de API novamente.

   A conexão funcionou durante meses, depois a sincronização do ShipStation parou e o teste de conexão indica "Chave de API inválida".

   Por que: A chave expirou após 3, 6 ou 12 meses, ou alguém a excluiu para criar uma nova chave para outra ferramenta (a conta só pode conter uma chave V2).

   Consertar: Gere uma nova chave V2 e, em seguida, no Data Agents, edite a conexão do ShipStation, cole a nova chave no campo Chave de API do ShipStation e clique em Testar conexão. Atribua a mesma nova chave a qualquer outra ferramenta que utilizava a chave antiga.

   As tabelas estão vazias ou mostram apenas remessas de teste, e as sincronizações estão lentas.

   Por que: Foi utilizada uma chave de ambiente de teste (começa com TEST_) do painel da API do ShipStation. Os dados do ambiente de teste são separados dos seus envios reais, e as chaves de ambiente de teste são limitadas a 20 solicitações por minuto.

   Consertar: Cole uma chave de produção (sem o prefixo TEST_) e clique em Testar conexão.

   Algumas tabelas do ShipStation estão atrasadas e o log do agente mostra TooManyRequests.

   Por que: O ShipStation permite 200 solicitações por minuto por conta, compartilhadas por todos os aplicativos conectados a ela. Outra integração está consumindo a maior parte desse orçamento.

   Consertar: Nada a alterar em Fluxos de Consulta: a tabela tentará novamente na próxima sincronização agendada. Se isso ocorrer todos os dias, solicite um limite maior à ShipStation pelo e-mail [email protected].

   Limites do conhecimento

   • Por padrão, cada conta ShipStation tem um limite de 200 requisições por minuto, compartilhadas por todos os aplicativos e integrações que utilizam a conta. Acima desse limite, o ShipStation responde com o erro 429 "Too Many Requests" (Muitas Requisições). O agente ajusta seu processamento para uma pequena parcela desse volume. Para limites maiores, envie um e-mail para [email protected].
   • Chaves de teste (prefixo TEST_, somente para clientes da API ShipStation): 20 requisições por minuto, apenas dados de teste. Contas do aplicativo web (plataforma) ShipStation não possuem ambiente de teste, portanto, todas as chaves leem dados reais.
   • As chaves de API expiram após 3, 6 ou 12 meses, conforme escolhido no momento da geração. O ShipStation envia um lembrete por e-mail antes do vencimento.
   • Uma chave V2 por conta de cada vez; a mesma chave pode ser usada por vários aplicativos.
   • Sem acesso à API nos planos Gratuito e Inicial. Abaixo do plano Standard, as chaves V2 retornam o código 402, exceto para os endpoints de inventário do complemento API de Inventário.
   • A API V1 (legada, obsoleta) usa um par de chave de API e chave secreta em um endereço diferente, limitado a 40 solicitações por minuto por par. O recurso Query Streams não usa a V1.

   Etapas verificadas em 8 de outubro de 2026. Fontes: help.shipstation.com/hc/en-us/articles/360025856212-ShipS…, docs.shipstation.com/autenticação, docs.shipstation.com/getting-started, docs.shipstation.com/limites-de-taxa, docs.shipstation.com/sandbox, docs.shipstation.com/products-and-plans, docs.shipstation.com/plans/shipstation-free-starter, docs.shipstation.com/plans/shipstation-standard-premium, docs.shipstation.com/apis/shipengine/docs/guides/auth, docs.shipstation.com/apis/shipengine/docs/guides/rate-limits, docs.shipstation.com/apis/shipstation-v1/docs/start-here/…, nango.dev/docs/integrations/all/shipstation-v2/connect.

   Nome da conexão

   Qualquer nome que você reconheça mais tarde, como Banco de Dados de Vendas.

   Chave da API do ShipStation

   Sua chave de API do ShipStation, encontrada no ShipStation em Configurações, Conta, Configurações de API.

   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? Geralmente, trata-se de uma permissão ausente ou de uma credencial de uma conta ShipStation incorreta. O passo a passo acima lista as problemas comuns e suas correções.

4. See your data in Query Builder Opcional

   You can look at your ShipStation account before Excel is involved at all. Open Construtor de consultas in the portal and pick the connection you just made. The Esquema tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click Executar and the rows appear under Resultados. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-in’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. 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.

6. 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. shipstation.envios mesa:

   Exemplo · SQL

   SELECT shipment_id, shipment_status, ship_date, carrier_id FROM shipstation.shipments 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? Build it in Construtor de consultas first and paste it here, or pick it from Saved Queries if you saved it.

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

Guias relacionados

• ShipStation para o Google Sheets
• Stripe para Microsoft Excel
• HubSpot para Microsoft Excel
• Do Shopify ao Microsoft Excel
• Executando SQL no Excel
• Todos os guias