Wortic

Wortic CEP / 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.

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