# 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. Endereço: https://cep.wortic.com/guias/preencher-endereco Fonte dos dados: Correios (eDNE), pela Wortic. Wortic CEP (/) / Guias (/guias/) 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. 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 (/docs). ## 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 (/guias/) · Documentação com exemplos em 10 linguagens (/docs) · openapi.json (/openapi.json) · Versão para IA (/llms.txt)