Erros de formato ATCUD e como corrigi-los

O que é o ATCUD

O ATCUD (Código Único de Documento) é um código único de documento que a AT exige em cada fatura, recibo, documento de transporte e entrada do SAF-T desde 1 de janeiro de 2023. Cada documento transporta um ATCUD que o liga a uma série registada na AT e a uma posição sequencial dentro dessa série.

O formato que a AT espera

Um ATCUD tem duas partes unidas por um hífen:

<CÓDIGO-VALIDAÇÃO>-<NÚMERO-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.
• Número de sequência: um inteiro positivo, sem zeros à esquerda, a começar em 1.

Exemplos que passam:

AAJFK4DH-1
BCDEF123-99
1234ABCD-1000000

Exemplos que falham:

aaaaaaaa-1       (código de validação em minúsculas)
AAJFK4DH1        (hífen em falta)
AAJFK4DH-0       (a sequência não pode ser 0)
AAJFK4DH-001     (zero à esquerda)
SHORTCD-1        (código de validação com menos de 8 caracteres)

O valor literal 0 também é aceite como sentinela para documentos cuja série é anterior às obrigações ATCUD — mas não deveria estar a emitir novos documentos com esta sentinela em 2026.

A regex que a AT aplica

/^[A-Z0-9]{8,8}-[1-9]\d{0,9}$/

Se o seu ERP estiver a produzir valores que não correspondem exatamente a isto, a submissão SAF-T falha. Alguns ERPs antigos exportam o código de validação em minúsculas, outros cortam zeros à esquerda incorretamente, outros concatenam sem o hífen.

Onde encontrar os erros depressa

O SAFTCheck analisa cada elemento <ATCUD> do seu ficheiro e lista todos os que não correspondem. Recebe o valor problemático e a regra que disparou, para que possa fazer grep ao documento de origem no seu ERP e voltar a emitir.

Valide o seu ficheiro SAF-T — é grátis para uma validação por IP por dia.