Validador de Código Postal de Portugal

Codigos postais de Portugal: o sistema CTT de 7 digitos

Em Portugal o codigo postal e gerido pelos CTT — Correios de Portugal, operador postal historico privatizado em 2013 mas ainda a autoridade oficial em enderecamento. O formato atual e de sete digitos na mascara NNNN-NNN: quatro digitos, hifen e tres digitos. Os quatro primeiros identificam uma zona regional; os tres ultimos descem ate o segmento de rua, predio ou grande cliente.

O sistema foi introduzido em 1978 com apenas quatro digitos e um designador textual (por exemplo 1000 Lisboa). Em 1998 os CTT migraram para o esquema completo 4+3 para suportar triagem automatica e roteamento porta a porta. Hoje existem mais de 200.000 codigos postais ativos cobrindo Portugal continental, Acores e Madeira.

Distribuicao geografica do primeiro digito

• 1xxx area metropolitana de Lisboa (1000-1099 cobre o centro de Lisboa).
• 2xxx Setubal, Santarem, Sintra e Oeste.
• 3xxx Centro — Coimbra, Leiria, Aveiro.
• 4xxx Porto e Norte (4000-4099 e o centro do Porto).
• 5xxx Tras-os-Montes, Vila Real, Braganca.
• 6xxx Beira Interior — Castelo Branco, Guarda, Covilha.
• 7xxx Alentejo — Evora, Beja, Portalegre.
• 8xxx Algarve — Faro, Portimao, Albufeira.
• 9xxx arquipelagos dos Acores e da Madeira.

Codigos com proposito especial

Algumas faixas sao reservadas para grandes receptores de correspondencia (apartados dos CTT, organismos publicos, grandes empresas). Os tres ultimos digitos nem sempre correspondem a uma rua publica: podem identificar uma portaria ou uma chave interna de triagem.

Onde o codigo postal e necessario

• Entrega em e-commerce: checkouts em Shopify, WooCommerce e Magento validam a mascara 4+3 antes de cotar CTT, DPD ou DHL.
• Faturas eletronicas: o sistema e-Fatura da Autoridade Tributaria exige o codigo postal em toda fatura acima de €1000.
• CRM e KYC: bancos, seguradoras e telecoms cruzam codigo postal com IBAN e comprovativo de morada.
• Vendedores brasileiros transfronteira: marketplaces como Mercado Livre PT, OLX PT e Amazon.es enviando para PT precisam validar a mascara para evitar Devolvido ao Remetente.

APIs e fontes oficiais

Os CTT publicam a consulta oficial em ctt.pt/pesquisa-codigo-postal. Existe licenca paga para o lote completo da Base de Dados Nacional de Codigos Postais. APIs de terceiros gratuitas como codigo-postal.pt e geoapi.pt redistribuem os dados com limites de taxa. Para custos reais de envio, integre a CTT API REST ou endpoints UPS/DHL EU.

Codigo postal PT versus CEP brasileiro e outros padroes europeus

O CEP brasileiro tem 8 digitos na mascara NNNNN-NNN (5+3). O codigo portugues tem 7 digitos na mascara NNNN-NNN (4+3). Outras referencias europeias:

• Espanha: 5 digitos (NNNNN).
• Franca: 5 digitos.
• Reino Unido: alfanumerico, formato misto SW1A 1AA.
• Alemanha: 5 digitos.
• Paises Baixos: 4 digitos + 2 letras (1011 AB).

Para brasileiros que enviam mercadorias para Portugal via Correios Internacionais, o campo CEP de destino espera o formato PT de 7 digitos. Documentos brasileiros apresentados em Portugal (certidao de nascimento, diploma) devem portar a Apostila da Convencao da Haia emitida por tabeliao brasileiro.

FAQ

Posso usar um codigo gerado para um envio real?

Nao. Esta ferramenta apenas confirma que a string segue a mascara sintatica NNNN-NNN. Para entrega real o codigo precisa existir na base dos CTT e resolver para um endereco fisico. Use a consulta oficial antes de imprimir a etiqueta.

Acores e Madeira estao incluidos?

Sim. Ambos os arquipelagos ficam na faixa 9xxx (Madeira concentrada em 9000-9399, Acores em 9500-9990).

Como o codigo PT difere do CEP brasileiro?

PT usa 4+3 digitos com hifen; BR usa 5+3 digitos com hifen. Validadores de formato nao podem ser reutilizados — um regex de CEP brasileiro rejeita todo codigo portugues e vice-versa.

A consulta e gratuita?

Os CTT oferecem busca gratuita por codigo no site publico. Dados em massa e a base completa exigem licenca comercial. Geoapi.pt e proxies semelhantes sao gratuitos para baixo volume.

Este validador envia meus dados para algum servidor?

Nao. A verificacao de mascara roda localmente no navegador. Nada e transmitido a servidor e nenhum log e gravado.