atcud.format
Formato dell'ATCUD: controllo gratuito e regole dal 2023
Codice univoco di documento obbligatorio: codice di validazione di almeno 8 caratteri, trattino e numero del documento. Include un controllo ATCUD gratuito.
Verifica un ATCUD
Questo controllo verifica solo il formato. Non conferma che l'AT abbia assegnato il codice alla tua serie.
Controlli gli ATCUD uno alla volta? SAFTCheck controlla in una volta tutti gli ATCUD del tuo file SAF-T, insieme a NIF, date e codifica.
Valida il tuo SAF-T gratisCos'è l'ATCUD
L'ATCUD (Código Único de Documento) è un codice univoco di documento che l'AT impone su ogni fattura, ricevuta, documento di trasporto e voce del SAF-T dal 1° gennaio 2023. Collega il documento a una serie registrata presso l'AT e a una posizione sequenziale all'interno di quella serie.
Il formato
L'ATCUD ha due parti unite da un singolo trattino:
<CODICE-VALIDAZIONE>-<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.
- Sequenza: il numero del documento all'interno della serie (le cifre dopo la
/nel numero del documento, ad es.FT A/123→123).
SAFTCheck applica la regex:
/^[A-Z0-9]{8,}-(?!0+$)\d+$/Fonte: Portaria n.º 195/2020, articolo 3, e FAQ 4333 dell'AT ("non esiste una lunghezza massima per il codice di validazione della serie").
Esempi
| Valore | Verdetto | Perché |
|---|---|---|
AAJFK4DH-1 | ✓ | 8 maiuscoli + trattino + 1 |
BCDEF123-99 | ✓ | 8 maiuscoli + trattino + 99 |
1234ABCD-1000000 | ✓ | Mix di cifre e lettere OK |
AAJFK4DHX9-12 | ✓ | I codici più lunghi di 8 caratteri sono validi |
0 | ✓ (sentinella) | Ammesso per documenti la cui serie precede l'obbligo ATCUD |
aaaaaaaa-1 | ✗ | Codice di validazione minuscolo |
AAJFK4DH1 | ✗ | Trattino mancante |
AAJFK4DH-0 | ✗ | La sequenza deve essere ≥ 1 |
AAJFK4DH-001 | ✓ | Gli zeri iniziali sono ammessi: il numero deriva dal numero del documento (FT A/001) |
SHORTCD-1 | ✗ | Il codice di validazione deve avere almeno 8 caratteri |
ATCUD:AAJFK4DH-1 | ✗ | L'etichetta ATCUD: va sulla fattura stampata, non nel SAF-T |
Come correggere
Esamina il documento problematico nel tuo ERP e la registrazione della serie sul portale AT:
- Conferma il codice di validazione della serie con l'AT (Portal das Finanças → Faturação → Comunicação de séries).
- Assicurati che l'ERP memorizzi il codice di validazione in maiuscolo esattamente come l'AT l'ha emesso.
- Riemetti il documento con l'ATCUD corretto — oppure usa l'editor inline per correggere questa occorrenza sul posto. L'editor include un pulsante MAIUSCOLO di un clic per il caso comune del codice di validazione in minuscolo.
Correlato
- NIF Mod-11 — l'identificativo a livello di entità, separato dall'ATCUD.
- Editor inline — correggi un ATCUD senza riemettere il documento.
- Guida: errori di formato ATCUD e come correggerli