Este documento exemplifica o uso do Pack , que te permite obter os dados de um endereço a partir de um CEP informado. Este pack utiliza a API para obter os dados. Ao informar um número de CEP, o pack retorna as seguintes informações: Logradouro (rua, avenida, etc) GIA (Guia de Informação e Apuração do ICMS, válido apenas para o estado de SP) Código do município no SIAFI (Sistema Integrado de Administração Financeira do Governo Federal)
Como instalar o Pack?
No menu do canto superior direito do seu documento, clique em Insert > Packs ou digite /pack em qualquer lugar do seu documento para abrir o painel de instalação e, em seguida, pesquise por “CEP”.
Ao encontrar o Pack Pesquisa CEP, adicione ao documento e você já terá acesso à fórmula PesquisaCEP().
A fórmula pode ser usada em qualquer lugar do documento, tanto no canvas quanto em tabelas.
Exemplos de uso
Digite um cep válido (apenas números) e veja o resultado:
(passe o cursor do mouse sobre o nome da rua para ver todos os dados)
Para acessar os parâmetros, utilize a notação padrão do Coda (dot notation).
Logradouro ([objeto].logradouro): Complemento ([objeto].complemento): Bairro ([objeto].bairro): Localidade ([objeto].localidade): Código IBGE ([objeto].ibge): Código GIA ([objeto].gia): Código SIAFI ([objeto].siafi): Uso em tabelas
A fim de otimizar a performance do documento, é recomendável realizar a pesquisa em uma coluna apenas (que pode ficar oculta) e extrair cada um dos elementos do endereço a partir dessa coluna, como no exemplo acima.
Dica extra – garanta que seu CEP terá apenas números
A API exige que o CEP informado contenha apenas números, contudo, os usuários estão acostumados a digitar o CEP com um traço separando os últimos três dígitos (01001-000), ou até mesmo um ponto separando os dois primeiros (01.001-000).
Para garantir que o CEP informado terá apenas caracteres numéricos, passe o parâmetro do número do CEP por uma fórmula RegexReplace() e elimine caracteres não numéricos.
RegexReplace([seu cep],"\D","")
O que este código faz é substituir todos os caracteres não numéricos (representado por \D) por nada, o que os elimina.
Exemplo: