Errores de formato ATCUD y cómo corregirlos

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. Cada documento lleva un ATCUD que lo vincula a una serie registrada en la AT y a una posición secuencial dentro de esa serie.

El formato que espera la AT

Un ATCUD tiene dos partes unidas por un guion:

<CÓDIGO-VALIDACIÓN>-<NÚMERO-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.
• Número de secuencia: el número del documento dentro de la serie, es decir, los dígitos después de la / en el número del documento (FT A/123 → 123).

Ejemplos válidos:

AAJFK4DH-1
BCDEF123-99
1234ABCD-1000000
AAJFK4DHX9-12
AAJFK4DH-0001

Ejemplos que fallan:

aaaaaaaa-1       (código de validación en minúsculas)
AAJFK4DH1        (falta el guion)
AAJFK4DH-0       (la secuencia no puede ser 0)
SHORTCD-1        (código de validación con menos de 8 caracteres)
ATCUD:AAJFK4DH-1 (la etiqueta va en la factura impresa, no en el SAF-T)

El valor literal 0 también se acepta como centinela para documentos cuya serie es anterior a la obligación ATCUD — pero no deberías estar emitiendo documentos nuevos con este centinela en 2026.

Lo que dicen las reglas

La Portaria n.º 195/2020 (artículo 3) define el formato: el código de validación de la serie asignado por la AT, con al menos 8 caracteres, un guion y el número secuencial del documento, que son los dígitos después de la barra en el número del documento. La FAQ 4333 de la AT añade que el código de validación no tiene longitud máxima. Como regex:

/^[A-Z0-9]{8,}-(?!0+$)\d+$/

Si tu ERP produce valores que no encajan, la AT rechaza el fichero. Causas habituales: el código de validación exportado en minúsculas, el guion ausente o la etiqueta ATCUD: copiada en el campo del SAF-T.

Dónde encontrar los errores rápido

SAFTCheck recorre cada elemento <ATCUD> de tu fichero y lista todos los que no encajan. Obtienes el valor problemático y la regla que disparó, para poder localizarlo en tu ERP y volver a emitirlo.

Valida tu fichero SAF-T. Es gratis: 3 comprobaciones al día sin cuenta, 5 con la sesión iniciada.