atcud.format
Formato ATCUD — VALIDACIÓN-SECUENCIA desde 2023
Código único de documento obligatorio: 8 caracteres alfanuméricos en mayúsculas, guion, secuencia ≥ 1.
Qué es el ATCUD
El ATCUD (Código Único de Documento) es un código único de documento que la AT exige en cada factura, recibo, documento de transporte y entrada del SAF-T desde el 1 de enero de 2023. Vincula el documento a una serie registrada en la AT y a una posición secuencial dentro de esa serie.
El formato
El ATCUD tiene dos partes unidas por un único guion:
<CÓDIGO-VALIDACIÓN>-<SECUENCIA>- Código de validación: exactamente 8 caracteres alfanuméricos en mayúsculas (A–Z, 0–9). La AT lo emite al registrar una serie de documentos.
- Secuencia: un entero positivo empezando por 1, sin ceros a la izquierda.
SAFTCheck aplica la regex:
/^[A-Z0-9]{8}-[1-9]\d{0,9}$/Ejemplos
| Valor | Veredicto | Por qué |
|---|---|---|
AAJFK4DH-1 | ✓ | 8 mayúsculas + guion + 1 |
BCDEF123-99 | ✓ | 8 mayúsculas + guion + 99 |
1234ABCD-1000000 | ✓ | Mezcla de dígitos y letras OK |
0 | ✓ (centinela) | Permitido para documentos cuya serie es anterior a la obligación ATCUD |
aaaaaaaa-1 | ✗ | Código de validación en minúsculas |
AAJFK4DH1 | ✗ | Falta el guion |
AAJFK4DH-0 | ✗ | La secuencia debe ser ≥ 1 |
AAJFK4DH-001 | ✗ | Cero a la izquierda |
SHORTCD-1 | ✗ | El código de validación debe tener exactamente 8 caracteres |
Cómo corregir
Revisa el documento problemático en tu ERP y el registro de la serie en el portal de la AT:
- Confirma el código de validación de la serie con la AT (Portal das Finanças → Faturação → Comunicação de séries).
- Asegúrate de que el ERP guarde el código de validación en mayúsculas exactamente como lo emitió la AT.
- Vuelve a emitir el documento con el ATCUD corregido — o usa el editor en línea para corregir esta ocurrencia en sitio. El editor incluye un botón MAYÚSCULAS de un solo clic para el caso habitual de código de validación en minúsculas.
Relacionado
- NIF Mod-11 — el identificador a nivel de entidad, separado del ATCUD.
- Editor en línea — corrige un ATCUD sin volver a emitir el documento.
- Guía: errores de formato ATCUD y cómo corregirlos