atcud.format
Formato ATCUD — VALIDAÇÃO-SEQUÊNCIA desde 2023
Código único de documento obrigatório: 8 caracteres alfanuméricos maiúsculos, hífen, sequência ≥ 1.
O que é o ATCUD
O ATCUD (Código Único de Documento) é um código único de documento que a AT impõe em cada fatura, recibo, documento de transporte e entrada do SAF-T desde 1 de janeiro de 2023. Liga o documento a uma série registada na AT e a uma posição sequencial dentro dessa série.
O formato
O ATCUD tem duas partes unidas por um único hífen:
<CÓDIGO-VALIDAÇÃO>-<SEQUÊNCIA>- Código de validação: exatamente 8 caracteres alfanuméricos maiúsculos (A–Z, 0–9). A AT emite-o quando se regista uma série de documentos.
- Sequência: um inteiro positivo a começar em 1, sem zeros à esquerda.
O SAFTCheck aplica a regex:
/^[A-Z0-9]{8}-[1-9]\d{0,9}$/Exemplos
| Valor | Veredicto | Porquê |
|---|---|---|
AAJFK4DH-1 | ✓ | 8 maiúsculas + hífen + 1 |
BCDEF123-99 | ✓ | 8 maiúsculas + hífen + 99 |
1234ABCD-1000000 | ✓ | Mistura de dígitos e letras OK |
0 | ✓ (sentinela) | Permitido para documentos cuja série é anterior às obrigações ATCUD |
aaaaaaaa-1 | ✗ | Código de validação em minúsculas |
AAJFK4DH1 | ✗ | Hífen em falta |
AAJFK4DH-0 | ✗ | A sequência tem de ser ≥ 1 |
AAJFK4DH-001 | ✗ | Zero à esquerda |
SHORTCD-1 | ✗ | O código de validação tem de ter exatamente 8 caracteres |
Como corrigir
Veja o documento problemático no ERP e o registo da série no portal da AT:
- Confirme o código de validação da série com a AT (Portal das Finanças → Faturação → Comunicação de séries).
- Garanta que o ERP guarda o código de validação em maiúsculas, exatamente como a AT o emitiu.
- Volte a emitir o documento com o ATCUD corrigido — ou use o editor inline para corrigir esta ocorrência no lugar. O editor inclui um botão MAIÚSCULO de um clique para o caso comum de código de validação em minúsculas.
Relacionado
- NIF Mod-11 — o identificador ao nível da entidade, separado do ATCUD.
- Editor inline — corrija um ATCUD sem voltar a emitir o documento.
- Passo a passo: erros de formato ATCUD e como corrigi-los