Obtenha dados de ShipStation em Planilhas Google
Importe dados em tempo real da sua conta ShipStation para o Google Sheets e atualize-os quando quiser. Sem uploads de CSV, sem Apps Script, sem copiar e colar. Leva cerca de dez minutos na primeira vez, e o plano gratuito cobre isso.
O resultado final será o que você obterá.
Uma planilha do Google que exibe os resultados em tempo real de uma consulta SQL em sua conta do ShipStation, com um botão que busca as linhas mais recentes sempre que os dados forem alterados. Assim:
Vendas Salvo no Drive| 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 |
Direto do ShipStationO ShipStation armazena seus dados por trás de sua API. Para importá-los para o Google Sheets, 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 complemento do Google Sheets solicita as linhas desejadas. Somente os resultados são transmitidos por meio de uma conexão criptografada, e o Google Sheets pode ser acessado de qualquer lugar: em qualquer navegador e em qualquer dispositivo.
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 Google Sheets 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.
Qual computador receberá o Agente? Qualquer dispositivo que esteja sempre ligado e que já consiga acessar sua conta do ShipStation. O Google Sheets pode estar em qualquer lugar.Ele é executado no seu navegador.
Conecte-o em cinco etapas
-
Crie sua conta
Vá para my.querystreams.com e inscreva-se. Escolha o Gratuito plano. É 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 Google Sheets.
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.
-
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
- 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.
- 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.
- 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.
- 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".
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
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.
-
Adicionar fluxos de consulta ao Google Sheets
Abra qualquer planilha do Google e acesse Extensões → Complementos → Obter complementos, procurar Fluxos de consultae clique InstalarOu instale-o diretamente de Consultar fluxos no Google Workspace MarketplaceO Google pedirá que você permita o complemento; isso é normal.
Depois disso, estará presente em todas as Planilhas Google que você abrir: um ícone do Query Streams no painel lateral à direita, também listado em ExtensõesNão há necessidade de fazer login separadamente. O sistema reconhece a conta do Google que você já utiliza, portanto, o e-mail precisa ser o mesmo cadastrado na sua conta do Query Streams.
-
Puxe sua primeira mesa.
Clique no ícone "Consultar Fluxos" no painel lateral à direita da planilha (ou encontre-o em "Acessar Fluxos"). Extensões). Escolher Fluxo de consulta e 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 · SQLSELECT shipment_id, shipment_status, ship_date, carrier_id FROM shipstation.shipments ORDER BY created_at DESC LIMIT 100;
Sob Folha de Destino Selecione a aba onde as linhas devem ser exibidas e clique em Executar consultaAs linhas aparecem nessa aba em um ou dois segundos. Clique em "Executar consulta" novamente sempre que os dados forem alterados e a aba 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 complemento, 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 Google Sheets ou do Excel.
- 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
A minha conta ShipStation precisa estar no mesmo computador em que uso o Sheets?
Não. Apenas o agente precisa estar no mesmo local que sua conta do ShipStation. O Google Sheets funciona no seu navegador em qualquer dispositivo. Abra o complemento com a mesma conta do Google 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.
A planilha atualiza sozinha?
Clique em Executar Consulta novamente sempre que desejar as linhas mais recentes. Para uma planilha que seja atualizada automaticamente, sem que ninguém precise fazer nada, configure uma Automação no portal do Query Streams (Streams → Automação). Ela está disponível em todos os planos.
Guias relacionados
Todos os guias para ShipStation
Excel
Claude (MCP)
REST API- Sincronizar com Google Sheets
Sincronizar com Airtable
Sincronizar com Smartsheet
Sincronizar com Baserow
Sincronizar com SeaTable
Sincronizar com Anvil.works
Setup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish