Como Ler Dados do Via Kondado no Google Sheets usando IMPORTDATA

Guia passo a passo para importar dados automatizados direto no Google Sheets com a função nativa IMPORTDATA

O que é o Via Kondado?

O Via Kondado é um destino da plataforma Kondado que permite acessar seus dados integrados e modelados através de uma API simples. Com ele, você pode:

• Acessar 80+ fontes de dados conectadas à Kondado
• Obter dados em formato CSV via links de API
• Automatizar atualizações no Google Sheets sem exportações manuais
• Criar planilhas e relatórios dinâmicos que se atualizam automaticamente

Caso de uso ideal: Conecte seu ERP (Tiny, Bling!, Omie), e-commerce (VTEX, Shopify) ou ferramentas de marketing (Meta Ads, Google Ads) diretamente ao Google Sheets e mantenha suas planilhas sempre atualizadas — sem instalar nada, usando apenas uma fórmula.

O que você precisa

Antes de começar, verifique se você tem:

1. Conta ativa na Kondado com integrações configuradas
2. Uma conta Google com acesso ao Google Sheets
3. Destino Via Kondado criado na plataforma Kondado
4. Token de acesso ao seu destino Via Kondado

Passo 1: Obter o Link de Acesso na Kondado

Para conectar o Google Sheets aos seus dados, você primeiro precisa obter o link de acesso da API:

1.1 Acesse sua Integração

1. Faça login na plataforma Kondado
2. Clique em Integrações no menu lateral
3. Selecione a integração que deseja conectar ao Google Sheets

1.2 Copie o Link de Acesso

1. Dentro da integração, clique no botão Visualizar Dados
2. Na janela modal, clique na opção Outros (o link gerado é o mesmo para qualquer ferramenta, incluindo o Google Sheets)
3. Escolha o separador decimal: vírgula (para planilhas em Português-Brasil) ou ponto
4. Selecione a tabela desejada
5. Clique no ícone de copiar ao lado da URL

A URL terá o seguinte formato:

https://hub.kondado.io/data/nome_da_tabela?token=seu_token_aqui&decimal_sep=comma

Guarde essa URL — você a usará dentro da fórmula no Google Sheets.

Passo 2: Usar a Função IMPORTDATA no Google Sheets

O Google Sheets tem uma função nativa chamada IMPORTDATA que importa um arquivo CSV (como o que o Via Kondado disponibiliza) diretamente para a planilha — sem instalar complementos.

1. Abra uma planilha no Google Sheets
2. Clique na célula onde os dados devem começar (ex.: A1)
3. Digite a fórmula abaixo, substituindo a URL pela que você copiou da Kondado:

=IMPORTDATA("https://hub.kondado.io/data/bling_categorias_produtos?token=xxxxxx&decimal_sep=comma")

4. Pressione Enter

O Google Sheets vai baixar o CSV e preencher automaticamente as células a partir da posição da fórmula, criando uma tabela com todas as linhas e colunas da sua integração.

Dica: deixe as células à direita e abaixo da fórmula vazias. O IMPORTDATA precisa desse espaço para expandir o resultado. Se houver dados no caminho, o Sheets exibe o erro "O resultado da matriz não foi expandido...".

Passo 3: Primeira Vez — Autorizar o Acesso a Dados Externos

Na primeira vez que você usa uma função de importação (como o IMPORTDATA) em uma planilha, o Google Sheets exibe um aviso de segurança no topo da planilha, avisando que a fórmula está tentando se conectar a um serviço externo:

Após clicar em Permitir acesso, os dados do Via Kondado aparecem imediatamente na planilha.

Passo 4: Atualização Automática dos Dados

A grande vantagem do IMPORTDATA é que ele reprocessa os dados automaticamente. Você não precisa reimportar manualmente.

Atualização Automática (padrão)

• O Google Sheets recalcula as funções de importação aproximadamente a cada 1 hora e também sempre que a planilha é aberta.
• Ou seja: os números da sua planilha acompanham a última versão dos dados replicados pela Kondado, de forma transparente.

Forçar Atualização Manual

Se você quiser buscar os dados mais recentes na hora, sem esperar o ciclo automático:

1. Recarregue a página da planilha (F5) — ao reabrir, o IMPORTDATA é reprocessado; ou
2. Clique na célula com a fórmula, apague o = do início, pressione Enter e digite o = de volta — isso reexecuta a fórmula; ou
3. Ajuste a frequência de recálculo em Arquivo → Configurações → Cálculo e escolha "Ao alterar e a cada minuto" ou "Ao alterar e a cada hora".

Dica: o Google armazena em cache o resultado do IMPORTDATA por um curto período. Se você acabou de rodar a integração na Kondado e a planilha ainda mostra dados antigos, aguarde alguns minutos e recarregue.

Segurança do Token

• Para compartilhar apenas os resultados, copie os dados e cole como valores (Colar especial → Somente valores) em outra planilha, ou exporte como PDF.
• Se suspeitar que o token foi exposto, troque o token do seu destino Via Kondado na Kondado — o token antigo deixa de funcionar imediatamente.
• Proteja o acesso à sua conta Kondado com autenticação de dois fatores.

Resolução de Problemas

"O aviso de permissão não aparece / os dados não carregam"

• Confirme que você clicou em Permitir acesso na barra amarela no topo da planilha.
• Se você cancelou o aviso, apague e digite a fórmula novamente para que ele reapareça.

"#N/A — O resultado da matriz não foi expandido"

• Há dados ocupando as células onde o IMPORTDATA precisa expandir. Limpe as células à direita e abaixo da fórmula, ou mova a fórmula para uma aba vazia.

"Números aparecem como texto (alinhados à esquerda)"

• O separador decimal da URL não bate com o idioma da planilha. Para planilhas em Português (Brasil), use decimal_sep=comma; para idiomas que usam ponto, use decimal_sep=dot (ou omita o parâmetro).
• Confira o idioma da planilha em Arquivo → Configurações → Local.

"Erro de importação / não foi possível carregar a URL"

• Verifique se a URL está completa (incluindo o token).
• Confirme que o destino Via Kondado está ativo na Kondado.
• Cole a URL no navegador para testar — ela deve baixar um arquivo CSV.

"Caracteres especiais não aparecem"

• O Via Kondado normaliza acentos e caracteres especiais para garantir compatibilidade universal com CSV. Isso é esperado.

Próximos Passos

Agora que seus dados estão no Google Sheets, você pode:

1. Criar gráficos e dashboards que se atualizam junto com os dados
2. Combinar múltiplas tabelas — use um IMPORTDATA por aba e cruze com QUERY, VLOOKUP ou XLOOKUP
3. Aplicar filtros e tabelas dinâmicas sobre os dados importados
4. Compartilhar insights com sua equipe (colando como valores para não expor o token)

Recursos Adicionais

• Documentação completa do Via Kondado
• Como conectar o Via Kondado ao Excel (Power Query)
• Criar conta na Kondado — teste gratuito de 14 dias

Tem dúvidas? Entre em contato com nosso suporte em português através da página de contato.