atcud.format
Formato ATCUD — VALIDAZIONE-SEQUENZA dal 2023
Codice univoco di documento obbligatorio: 8 caratteri alfanumerici maiuscoli, trattino, sequenza ≥ 1.
Cos'è 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: esattamente 8 caratteri alfanumerici maiuscoli (A–Z, 0–9). L'AT lo emette quando si registra una serie di documenti.
- Sequenza: un intero positivo a partire da 1, senza zeri iniziali.
SAFTCheck applica la regex:
/^[A-Z0-9]{8}-[1-9]\d{0,9}$/Esempi
| Valore | Verdetto | Perché |
|---|---|---|
AAJFK4DH-1 | ✓ | 8 maiuscoli + trattino + 1 |
BCDEF123-99 | ✓ | 8 maiuscoli + trattino + 99 |
1234ABCD-1000000 | ✓ | Mix di cifre e lettere OK |
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 | ✗ | Zero iniziale |
SHORTCD-1 | ✗ | Il codice di validazione deve essere esattamente di 8 caratteri |
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