Errori di formato ATCUD e come correggerli

Cos'è l'ATCUD

L'ATCUD (Código Único de Documento) è un codice univoco di documento che l'AT richiede su ogni fattura, ricevuta, documento di trasporto e voce del SAF-T dal 1° gennaio 2023. Ogni documento porta un ATCUD che lo collega a una serie registrata presso l'AT e a una posizione sequenziale all'interno di quella serie.

Il formato che l'AT si aspetta

Un ATCUD ha due parti unite da un trattino:

<CODICE-VALIDAZIONE>-<NUMERO-SEQUENZA>

• Codice di validazione: almeno 8 lettere maiuscole e cifre (A–Z, 0–9), senza lunghezza massima. L'AT lo emette quando si registra una serie di documenti.
• Numero di sequenza: il numero del documento all'interno della serie, cioè le cifre dopo la / nel numero del documento (FT A/123 → 123).

Esempi validi:

AAJFK4DH-1
BCDEF123-99
1234ABCD-1000000
AAJFK4DHX9-12
AAJFK4DH-0001

Esempi che falliscono:

aaaaaaaa-1       (codice di validazione minuscolo)
AAJFK4DH1        (trattino mancante)
AAJFK4DH-0       (la sequenza non può essere 0)
SHORTCD-1        (codice di validazione con meno di 8 caratteri)
ATCUD:AAJFK4DH-1 (l'etichetta va sulla fattura stampata, non nel SAF-T)

Il valore letterale 0 è accettato come sentinella per documenti la cui serie è precedente all'obbligo ATCUD — ma non dovresti emettere nuovi documenti con questa sentinella nel 2026.

Cosa dicono le regole

La Portaria n.º 195/2020 (articolo 3) definisce il formato: il codice di validazione della serie assegnato dall'AT, di almeno 8 caratteri, un trattino e il numero sequenziale del documento, cioè le cifre dopo la barra nel numero del documento. La FAQ 4333 dell'AT aggiunge che il codice di validazione non ha lunghezza massima. Come regex:

/^[A-Z0-9]{8,}-(?!0+$)\d+$/

Se il tuo ERP produce valori che non corrispondono, l'AT rifiuta il file. Cause comuni: il codice di validazione esportato in minuscolo, il trattino mancante o l'etichetta ATCUD: copiata nel campo del SAF-T.

Dove trovare gli errori in fretta

SAFTCheck analizza ogni elemento <ATCUD> nel tuo file ed elenca quelli che non corrispondono. Ottieni il valore problematico e la regola che è scattata, così puoi cercarlo a ritroso fino al documento di origine nel tuo ERP e riemetterlo.

Convalida il tuo file SAF-T. È gratis: 3 controlli al giorno senza account, 5 dopo l'accesso.