Wortic

Wortic CEP / Guias

Validar o CEP antes de consultar

Um CEP tem 8 números. Conferir isso no seu sistema evita gastar consulta com número digitado pela metade.

Publicado em .

Fontes oficiais: o CEP nos Correios e os códigos de município do IBGE.

Diferente do CNPJ, o CEP não tem dígito verificador. A conferência possível antes de consultar é o formato: 8 números.

O código

export function limparCep(texto) {
  return String(texto).replace(/\D/g, "");
}

export function cepValido(texto) {
  const so = String(texto).trim();
  return /^\d{5}-?\d{3}$/.test(so) || /^\d{2}\.\d{3}-\d{3}$/.test(so);
}

Conferido contra a API

EntradacepValidoResposta da API
01001000true200, Praça da Sé
01001-000true200, o mesmo endereço
01.001-000trueconsulte com limparCep
1234false400 cep_invalido
99999999true404 nao_encontrado

A função recusa letras e números soltos, mas aceita o CEP escrito do jeito que as pessoas costumam escrever, com traço ou com ponto.

Perguntas e respostas

Quais formatos de CEP a API aceita?

8 números, com ou sem traço: 01001000 e 01001-000 dão a mesma resposta.

O que acontece se eu mandar um CEP com menos números?

A API responde 400 com o código cep_invalido, e a consulta conta no seu limite de 60 por minuto.

Um CEP com 8 números sempre existe?

Não. Se ele não está na base dos Correios, a resposta é 404 com o código nao_encontrado.

Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA