Valide o formato de CEP por país

Códigos postais são curtos, mas seus formatos variam muito entre países. Esta capacidade recebe um CEP ou código postal e um código de país de duas letras, então verifica o valor pelo padrão estrutural correspondente. O resultado é determinístico e não exige consulta de rede, geocodificação nem base de endereços. Use-o para encontrar letras trocadas, dígitos ausentes e separadores incorretos antes que os dados cheguem ao checkout, à expedição, ao faturamento ou ao cadastro de clientes. Um país não reconhecido gera um erro de entrada claro.

Valide o formato no contexto nacional correto

Não é possível avaliar um código postal com segurança sem saber o país. Cinco dígitos são normais nos Estados Unidos, na França, na Alemanha e na Espanha, mas não bastam para Índia, China ou Singapura. O Canadá alterna letras e números, a Polônia exige hífen e o Reino Unido possui diferentes arranjos alfanuméricos.

Esta capacidade separa essas regras e seleciona exatamente um padrão pelo código de país de duas letras. Ela remove espaços externos inofensivos e aceita o país em maiúsculas ou minúsculas, mas não transforma silenciosamente o código postal em outro valor. A resposta informa o país normalizado, o código recortado, o formato esperado e um resultado booleano.

Assim, o sistema pode decidir pelo booleano e o formulário pode orientar sobre o formato correto quando o valor for inválido. Se o país não constar na tabela, a solicitação falha claramente, em vez de considerar inválido qualquer valor desconhecido. Essa distinção impede que uma cobertura incompleta produza uma orientação enganosa sobre a qualidade dos seus dados.

Entenda o alcance da verificação de formato

O algoritmo verifica estrutura, não existência nem possibilidade de entrega. Um resultado válido significa que caracteres, comprimento e separadores seguem o padrão representado para o país. Ele não confirma que a autoridade postal atribuiu o código, que uma rua pertence à região ou que uma transportadora atende o destino.

Essas conclusões mais fortes exigem dados externos atualizados e geralmente um endereço completo. Essa fronteira precisa ficar clara: a validação determinística é rápida, privada e repetível, enquanto a confirmação de entrega é outro serviço. O validador preserva zeros à esquerda porque códigos postais são identificadores, não números.

Envie-os como texto para manter intactos códigos franceses, italianos ou de regiões dos Estados Unidos. Letras não diferenciam maiúsculas de minúsculas quando o sistema nacional as utiliza, e espaços opcionais só são aceitos onde essa variação é habitual. A pontuação não é removida de modo geral, pois um separador pode ser obrigatório em um país e incorreto em outro.

A indicação de formato explica a estrutura esperada sem afirmar que toda combinação possível foi realmente atribuída.

Valide no primeiro ponto de entrada dos dados

O melhor momento para conferir é logo depois que a pessoa escolhe o país e informa o código postal. Um checkout pode validar antes de criar o pedido, um cadastro pode sinalizar um provável erro antes de salvar o perfil e uma importação pode testar cada registro antes de incorporá-lo à base de clientes. Em formulários interativos, mantenha o valor original visível e use o formato retornado como orientação, sem substituir o texto inesperadamente.

Em lotes, registre o booleano e o país junto da linha para separar códigos malformados de falhas causadas por países sem suporte. A função é determinística e não possui rede, aleatoriedade, relógio nem estado mutável; portanto, a mesma entrada sempre gera a mesma resposta. Trate um resultado falso como pedido de correção, não como prova de fraude ou endereço inexistente.

Um erro de país desconhecido representa uma questão de configuração ou cobertura que exige uma decisão explícita.