API do cartaregistada.pt
Envia cartas registadas com aviso de receção (AR) em Portugal diretamente a partir do teu software. Tu fazes um POST com o PDF e as moradas; nós imprimimos, enviamos pelos CTT em até 2 dias úteis e o comprovativo fica associado ao envio. Faturação mensal única na conta de empresa.
Acesso: a API está disponível para contas de empresa. Pede a tua chave em ola@cartaregistada.pt ou através da página de empresas — resposta no próprio dia.
Autenticação
Header Authorization: Bearer A_TUA_CHAVE em todos os pedidos.
Enviar uma carta
POST https://www.cartaregistada.pt/api/v1/enviar
Content-Type: application/json
Authorization: Bearer A_TUA_CHAVE
{
"pdf_base64": "<conteúdo do PDF em base64>",
"nome_ficheiro": "interpelacao-cliente-42.pdf",
"referencia": "FAT-2026-0042",
"email_notificacao": "financeiro@tuaempresa.pt",
"destinatario": {
"nome": "Maria Santos",
"morada": "Rua das Flores 12, 2.º Esq",
"codigo_postal": "1200-192",
"localidade": "Lisboa"
},
"remetente": {
"nome": "A Tua Empresa, Lda",
"morada": "Av. da República 45",
"codigo_postal": "1050-187",
"localidade": "Lisboa"
}
}
Resposta
201 Created
{
"id": "recXXXXXXXXXXXXXX",
"estado": "recebido",
"servico": "carta registada com aviso de rececao",
"faturacao": "conta mensal da empresa",
"envio_previsto": "entregue aos CTT em ate 2 dias uteis"
}
Campos
| Campo | Obrigatório | Notas |
|---|---|---|
pdf_base64 | sim | PDF (ou JPG/PNG) em base64, até ~10 MB |
destinatario.nome / morada / codigo_postal | sim | CP no formato 1234-567 |
remetente.nome / morada / codigo_postal | sim | É para esta morada que os CTT devolvem o AR assinado |
localidade | recomendado | Em ambos |
nome_ficheiro, referencia, email_notificacao | não | A referência aparece na fatura mensal |
Erros
| Código | Significado |
|---|---|
| 400 | Validação falhou — o campo detalhes lista o que corrigir |
| 401 | Chave inválida ou em falta |
| 429 | Limite de 30 pedidos/minuto excedido |
Preço e prazos
Cartas registadas com AR ao preço da tua conta de empresa (fatura mensal única com NIF). Entregamos aos CTT em até 2 dias úteis; a entrega ao destinatário segue o prazo dos CTT, normalmente 1 a 7 dias, não garantido. O AR assinado é devolvido em papel à morada do remetente.