atcud.format
Formato del ATCUD: comprobador gratuito y reglas desde 2023
Código único de documento obligatorio: código de validación de al menos 8 caracteres, guion y número del documento. Incluye un comprobador de ATCUD gratuito.
Comprobar un ATCUD
Esta comprobación solo verifica el formato. No confirma que la AT haya asignado el código a tu serie.
¿Compruebas ATCUDs uno a uno? SAFTCheck comprueba a la vez todos los ATCUD de tu fichero SAF-T, además de los NIF, las fechas y la codificación.
Valida tu SAF-T gratisQué 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: al menos 8 letras mayúsculas y dígitos (A–Z, 0–9), sin longitud máxima. La AT lo emite al registrar una serie de documentos.
- Secuencia: el número del documento dentro de la serie (los dígitos después de la
/en el número del documento, p. ej.FT A/123→123).
SAFTCheck aplica la regex:
/^[A-Z0-9]{8,}-(?!0+$)\d+$/Fuente: Portaria n.º 195/2020, artículo 3, y FAQ 4333 de la AT ("no existe un tamaño máximo para el código de validación de la serie").
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 |
AAJFK4DHX9-12 | ✓ | Los códigos de más de 8 caracteres son válidos |
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 | ✓ | Los ceros a la izquierda se aceptan: el número viene del número del documento (FT A/001) |
SHORTCD-1 | ✗ | El código de validación debe tener al menos 8 caracteres |
ATCUD:AAJFK4DH-1 | ✗ | La etiqueta ATCUD: va en la factura impresa, no en el SAF-T |
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