Gerador de Código Postal de Portugal (fake)

Código Postal de Portugal: formato e história

O sistema de códigos postais de Portugal é administrado pelos CTT — Correios de Portugal, o operador postal nacional. O formato atual é NNNN-NNN — quatro dígitos, hífen e mais três dígitos — totalizando sete dígitos. O primeiro bloco (4 dígitos) identifica uma área ampla de distribuição postal, enquanto o segundo bloco (3 dígitos) refina a localização para um trecho de rua, edifício ou até um lote específico. Existem cerca de 200 mil códigos postais válidos cobrindo todo o país, incluindo as regiões autónomas da Madeira e dos Açores.

O sistema original, introduzido em 1978, usava apenas quatro dígitos e cobria distritos postais. Em 1998, os CTT expandiram para o atual formato 4+3 para suportar roteamento ao nível de endereço e triagem automatizada. Isso o torna mais preciso que sistemas como o francês (cinco dígitos), e aproximadamente comparável ao código outward+inward do Reino Unido (ex.: SW1A 1AA), embora a versão britânica seja alfanumérica.

Prefixos regionais

O primeiro dígito do bloco de quatro identifica aproximadamente a região de Portugal continental e das ilhas:

• 1xxx — Área metropolitana de Lisboa (ex.: 1000 Lisboa centro)
• 2xxx — Distritos de Setúbal e Santarém
• 3xxx — Região Centro (ex.: 3000 Coimbra)
• 4xxx — Porto e Norte (ex.: 4000 Porto centro)
• 5xxx — Trás-os-Montes e Alto Douro
• 6xxx — Beira Interior
• 7xxx — Alentejo
• 8xxx — Algarve (ex.: 8000 Faro)
• 9xxx — Madeira e Açores (ex.: 9000 Funchal, 9500 Ponta Delgada)

Código Postal PT vs CEP brasileiro

Ambos os países usam códigos postais com hífen, mas a estrutura difere. O CEP brasileiro tem 8 dígitos no formato NNNNN-NNN (5+3), enquanto o Código Postal português tem 7 dígitos no formato NNNN-NNN (4+3). Validar um formulário internacional que aceite ambos exige duas regex — nunca assuma que o código postal de um cliente lusófono tem 8 dígitos.

Casos de uso para códigos gerados

Códigos gerados são valiosos para pipelines de QA que exercitam formulários de endereço internacional, para semear bases de dados mock de e-commerce que vendem para Portugal, para validar parsers regex (^\d{4}-\d{3}$) e para distinguir clientes portugueses de outros mercados lusófonos — o Brasil usa 8 dígitos, Angola e Moçambique usam códigos de 4 dígitos sem hífen.

Perguntas frequentes

Posso usar um código postal gerado para enviar uma encomenda real para Portugal? Não. A ferramenta produz códigos sintaticamente válidos (formato e prefixo regional plausíveis), mas não garante correspondência com um endereço real. Para envios reais, pesquise o código do destinatário no site dos CTT ou no Google Maps.

O gerador cobre Açores e Madeira? Sim. Códigos começando com 9 estão reservados para as regiões autónomas — 9000-9499 para a Madeira e 9500-9999 para os Açores.

Como descobrir o código postal correto de um endereço português? Use o serviço de pesquisa dos CTT (endpoint pesquisaCodigoPostal), o Google Maps PT ou o livro oficial em papel — todos mapeiam trechos de rua para o código exato de 7 dígitos.

Para que isto serve? Mock data para lojas e-commerce expandindo para Portugal, testes automatizados de formulários de endereço internacional, distinção de clientes lusófonos (PT vs BR vs Angola/Moçambique, que usam códigos de 4 dígitos) e teste de carga em integrações logísticas com APIs estilo CTT.