Errori di formato ATCUD e come correggerli

Il codice di validazione da 8 caratteri, il trattino, la sequenza — cosa richiede l'AT dal 2023 e i pattern che falliscono.

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: esattamente 8 caratteri alfanumerici maiuscoli (A–Z, 0–9). L'AT lo emette quando si registra una serie di documenti.
Numero di sequenza: un intero positivo, senza zeri iniziali, a partire da 1.

Esempi validi:

AAJFK4DH-1
BCDEF123-99
1234ABCD-1000000

Esempi che falliscono:

aaaaaaaa-1       (codice di validazione minuscolo)
AAJFK4DH1        (trattino mancante)
AAJFK4DH-0       (la sequenza non può essere 0)
AAJFK4DH-001     (zero iniziale)
SHORTCD-1        (codice di validazione con meno di 8 caratteri)

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.

La regex applicata dall'AT

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

Se il tuo ERP produce valori che non corrispondono esattamente, l'invio del SAF-T fallisce. Alcuni ERP legacy esportano il codice di validazione in minuscolo, altri tagliano gli zeri iniziali in modo scorretto, altri concatenano senza trattino.

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 per una convalida al giorno per IP.