atcud.format
Formato do ATCUD: verificador grátis e regras desde 2023
Código único de documento obrigatório: código de validação com pelo menos 8 caracteres, hífen e número do documento. Inclui um verificador de ATCUD grátis.
Verificar um ATCUD
Esta verificação confirma apenas o formato. Não confirma que a AT atribuiu o código à sua série.
A verificar ATCUDs um a um? O SAFTCheck verifica de uma vez todos os ATCUDs do seu ficheiro SAF-T, e ainda os NIFs, as datas e a codificação.
Validar o seu SAF-T, grátisO 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: pelo menos 8 letras maiúsculas e algarismos (A–Z, 0–9), sem comprimento máximo. A AT emite-o quando se regista uma série de documentos.
- Sequência: o número do documento dentro da série (os algarismos depois da
/no número do documento, p. ex.FT A/123→123).
O SAFTCheck aplica a regex:
/^[A-Z0-9]{8,}-(?!0+$)\d+$/Fonte: Portaria n.º 195/2020, artigo 3.º, e FAQ 4333 da AT ("não existe um tamanho máximo para o código de validação de série").
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 |
AAJFK4DHX9-12 | ✓ | Códigos com mais de 8 caracteres são válidos |
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 | ✓ | Zeros à esquerda são aceites: o número vem do número do documento (FT A/001) |
SHORTCD-1 | ✗ | O código de validação tem de ter pelo menos 8 caracteres |
ATCUD:AAJFK4DH-1 | ✗ | O rótulo ATCUD: pertence à fatura impressa, não ao SAF-T |
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