Como Capturar o Endereço Completo de um CEP no Power Query

Capturar o endereço completo de um CEP no Power Query é uma solução inteligente para otimizar processos e economizar tempo na análise de dados.

Em vez de buscar manualmente cada CEP, você pode automatizar essa tarefa e obter informações como logradouro, bairro, cidade, estado e código IBGE diretamente no Power Query.

Neste guia, você aprenderá a criar uma função personalizada que consulta automaticamente o ViaCEP e preenche sua tabela com os dados corretos.

Além disso, apresentaremos alternativas pagas para quem precisa processar um grande volume de CEPs com mais estabilidade e rapidez.

1. Preparando a Tabela de CEPs no Power Query

Antes de tudo, sua base de dados precisa estar carregada no Power Query. Caso os CEPs estejam em um arquivo Excel, CSV ou banco de dados, basta importá-los e garantir que a coluna de CEP esteja no formato Texto, evitando erros na consulta dos dados.

A estrutura da tabela deve seguir este modelo:

Agora, vamos criar a conexão com o ViaCEP para buscar os endereços automaticamente.

2. Criando a Função para Consultar o ViaCEP

O ViaCEP é um serviço gratuito que fornece informações detalhadas sobre um CEP ao acessar um link específico. Por exemplo, se consultarmos: https://viacep.com.br/ws/01001000/json/

Ele retorna um JSON com os seguintes dados:

{
  "cep": "01001-000",
  "logradouro": "Praça da Sé",
  "bairro": "Sé",
  "localidade": "São Paulo",
  "uf": "SP",
  "ibge": "3550308"
}

Agora, vamos ensinar o Power Query a capturar essas informações automaticamente.

Criando a Função no Power Query

1. No Power Query, clique em Nova Fonte > Consulta em Branco.
2. Acesse o Editor Avançado e substitua o código existente pelo seguinte:

(cep as text) =>
let
    Fonte = Json.Document(Web.Contents("https://viacep.com.br/ws/" & cep & "/json/")),
    Resultado = try
        [cep = Fonte[cep], logradouro = Fonte[logradouro], bairro = Fonte[bairro], 
         cidade = Fonte[localidade], estado = Fonte[uf], ibge = Fonte[ibge]]
    otherwise 
        [cep = cep, logradouro = null, bairro = null, cidade = null, estado = null, ibge = null]
in
    Resultado

3. Clique em Concluído.
4. Renomeie essa função para BuscarEnderecoCEP.

Agora temos uma função reutilizável que pode buscar os dados de qualquer CEP automaticamente.

3. Aplicando a Função na Tabela

Agora, precisamos aplicar essa função à nossa tabela de CEPs.

1. Volte para a tabela de CEPs no Power Query.
2. Clique em Adicionar Coluna > Coluna Personalizada.
3. No campo de fórmula, digite: = BuscarEnderecoCEP([CEP])
4. Clique em OK

O Power Query chamará a API do ViaCEP para cada linha da tabela e preencherá as informações automaticamente.

4. Expandindo os Resultados

Os dados agora estão dentro de uma única coluna em formato de registro. Para visualizar cada informação separadamente:

1. Clique no ícone de expansão (↔) ao lado da nova coluna criada.
2. Selecione as colunas desejadas:
   • Logradouro
   • Bairro
   • Cidade
   • Estado
   • IBGE
3. Clique em OK.

Agora sua tabela está completa com todas as informações dos CEPs.

Quando o ViaCEP Não é Suficiente

Embora o ViaCEP seja gratuito e eficiente para pequenas bases, ele possui limitações:

• Restrição de requisições – Muitas consultas simultâneas podem gerar bloqueios.
• Lentidão – O tempo de resposta pode variar conforme a demanda no servidor.
• Dados incompletos – Algumas informações podem estar desatualizadas ou não disponíveis.

Se sua base de CEPs for grande, uma API paga pode ser a melhor opção.

Alternativas Pagas para Consultar CEPs

Para quem precisa capturar o endereço completo de um CEP em alto volume, algumas opções são:

• BrasilAPI (brasilapi.com.br) – Serviço gratuito, porém mais rápido e estável que o ViaCEP.
• CEP Aberto (cepaberto.com) – Exige cadastro, mas oferece boa precisão.
• Correios (SIGEP Web) – API oficial dos Correios, ideal para grandes volumes.
• APIs Privadas (CDS, Speedio, Serpro) – Para empresas que precisam de dados sempre atualizados.

A integração dessas APIs ao Power Query segue o mesmo princípio do ViaCEP, mas pode exigir autenticação com chave de acesso.

Aprenda Mais: Aula no YouTube e Material de Apoio

Quer ver esse processo acontecendo na prática? No nosso canal do YouTube, tem uma aula completa onde mostramos o passo a passo na tela, sem enrolação.

Além disso, preparamos um material de apoio para você baixar e testar diretamente no Power Query.

No final deste artigo, você pode baixar gratuitamente o material de apoio dessa aula

Torne-se um Especialista em Power Query e Automação

Agora imagine o tempo que você pode economizar dominando Power Query, SQL, DAX e Python para automação de dados. Com essas habilidades, você poderá:

• Automatizar processos repetitivos e ganhar produtividade.
• Transformar horas de trabalho manual em segundos.
• Trabalhar com grandes volumes de dados sem sofrimento.

A Formação Power Query 2.0 ensina tudo isso de forma prática e aplicada. Se você quer se destacar no mercado, essa é sua chance.

Acesse agora e comece a transformar sua carreira!

Conclusão

Hoje, você aprendeu como capturar o endereço completo de um CEP no Power Query de forma automática e eficiente.

• Criamos uma função personalizada para buscar os dados no ViaCEP.
• Aplicamos essa função na tabela de CEPs.
• Expandimos os resultados para obter logradouro, bairro, cidade, estado e IBGE.
• Vimos as limitações do ViaCEP para bases grandes.
• Exploramos APIs pagas para maior volume e estabilidade.

Agora você tem uma solução poderosa para enriquecer bases de endereços sem esforço manual. Teste essa técnica e veja o tempo que pode economizar!

E se quiser ir além, conheça a Formação Power Query 2.0 e revolucione sua produtividade!

Forte abraço,