Preencher o endereço pelo CEP
A pessoa digita o CEP e o formulário completa rua, bairro, cidade e estado, com o código IBGE da cidade. Ela só digita o número da casa.
Publicado em .
Fontes oficiais: o CEP nos Correios e os códigos de município do IBGE.
Formulário de entrega, de cadastro ou de nota fiscal começa pelo CEP. Com uma consulta, o resto do endereço vem pronto, igual ao dos Correios.
Da resposta para o formulário
export function camposDoEndereco(e) {
return {
cep: e.cep_formatado, logradouro: e.logradouro, complemento: e.complemento, bairro: e.bairro,
cidade: e.cidade, uf: e.uf, cidade_ibge: e.cidade_ibge,
};
}
export async function enderecoPeloCep(texto) {
if (!cepValido(texto)) return { erro: "cep_invalido" }; // guia "Validar o CEP"
const r = await fetch(`https://cep.wortic.com/cep/${limparCep(texto)}`);
const j = await r.json();
return r.status === 200 ? camposDoEndereco(j) : { erro: j.erro?.codigo || String(r.status) };
}
No formulário
const campo = document.querySelector("#cep");
campo.addEventListener("input", async () => {
if (limparCep(campo.value).length !== 8) return;
const dados = await enderecoPeloCep(campo.value);
if (dados.erro) return; // 404: deixe a pessoa digitar à mão
for (const [nome, valor] of Object.entries(dados)) {
const entrada = document.querySelector(`[name="${nome}"]`);
if (entrada && !entrada.value) entrada.value = valor ?? ""; // não apaga o que a pessoa já digitou
}
document.querySelector('[name="numero"]')?.focus(); // falta só o número
});
O que sai para o CEP 01001-000
{
"cep": "01001-000",
"logradouro": "Praça da Sé",
"complemento": "",
"bairro": "Sé",
"cidade": "São Paulo",
"uf": "SP",
"cidade_ibge": 3550308
}
Quando a base traz um complemento, ele diz o trecho ou o número que o CEP cobre. No CEP 04717-914, por exemplo, o complemento é "1562" e a unidade é "Edifício Paures": esse CEP é de um prédio só.
O exemplo de consulta em dez linguagens está na documentação.
Perguntas e respostas
Quais campos a API preenche a partir do CEP?
Logradouro, complemento, bairro, cidade, estado e o código IBGE da cidade, como estão na base dos Correios.
A API traz o número da casa?
Não. Um CEP de rua cobre um trecho dela, então o número vem de quem informa o endereço. Deixe esse campo para a pessoa.
Quando chamar a API no formulário?
Quando o CEP tiver 8 números, uma vez só. Não chame a cada tecla.
Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA