Diccionario de errores de la AEAT
Cada rechazo con su causa real, el ejemplo que falla al lado del que funciona y quién tiene que corregirlo. Son los que ya nos hemos comido nosotros integrando de verdad.
¿Por qué rechaza la AEAT un registro de VeriFactu?
Los rechazos más frecuentes son de datos censales: el error 4104 (la razón social del emisor no coincide con el censo), el 1110 (el productor del software no consta) y el 1177 (el identificador del sistema informático supera dos caracteres).
Ninguno de los tres se arregla reintentando: son rechazos de contenido y darán el mismo error cada vez. Los fallos de red o de servicio sí se reintentan, con espera creciente.
Fuente: Orden HAC/1177/2024, de 17 de octubre · Agencia Tributaria — Preguntas frecuentes sobre VERI*FACTU
El productor del software no consta en el censo
La AEAT no reconoce al fabricante del software: contrasta el NIF y la razón social del productor juntos c…
1177El identificador del sistema informático es incorrecto
El campo IdSistemaInformatico admite dos caracteres como máximo. Con uno más, la AEAT rechaza el envío en…
4102Los datos fiscales del emisor no cuadran con Hacienda
El NIF del obligado a expedir la factura no es válido o no está identificado en el censo de la AEAT.…
4104El nombre del emisor no coincide con el censo
El NIF está bien, pero la razón social no. La AEAT comprueba NIF y nombre juntos, y si el par no existe e…
4105Problema con el certificado del representante
El certificado con el que se remite el envío no está autorizado para presentar en nombre de ese obligado …
Los tres fallos que la AEAT no te rechaza, pero te arruinan igual.
El formato de los importes
«12» y «12.00» dan huellas distintas. Si tu huella se calcula con un formato y el XML escribe otro, la AEAT recalcula desde el XML, no le cuadra y marca el registro como aceptado con errores. Factura a factura, sin que salte ninguna alarma. Qué es «aceptado con errores» · cómo se calcula la huella.
La cadena bifurcada
Dos facturas simultáneas del mismo emisor pueden leer el mismo «registro anterior» y encadenarse las dos a él. La AEAT las acepta. Y la huella es irreversible: eso ya no se arregla, habría que rehacer el histórico entero. Cómo se bifurca una cadena.
El QR de preproducción en producción
La factura sale bien, se imprime bien y el QR es válido: lleva al validador de pruebas, donde la factura del cliente «no consta». El QR, en detalle.
El control de flujo ignorado
La AEAT indica cuántos segundos esperar antes del siguiente envío. Ignorarlo no da un error que explique nada: te deja sin servicio en hora punta, que es cuando más facturas hay. Y en desarrollo, con poco volumen, no se manifiesta nunca. TiempoEsperaEnvio.
¿Un registro rechazado rompe mi numeración?
No. Un registro rechazado no entra en la cadena de huellas: el siguiente se encadena al último aceptado. Lo que sí hay que resolver es el dato que falla, porque va a fallar igual en el reintento.
¿Merece la pena reintentar un rechazo?
Solo si es transitorio (red, servicio caído, timeout). Un rechazo de contenido —un NIF que no cuadra, una razón social equivocada— dará exactamente el mismo error las veces que lo mandes.
¿Qué es «aceptado con errores»?
Que la AEAT se ha quedado el registro pero ha detectado algo que no cuadra, típicamente que la huella que recalcula desde el XML no coincide con la que declaraste. No bloquea, y por eso es peligroso: se acumula factura a factura sin que nadie mire.
¿Dónde veo el mensaje literal de la AEAT?
En el campo error.aeat de la respuesta, siempre. Nuestra explicación se añade, no sustituye: para un código no catalogado el texto literal es lo único fiable.
Última revisión normativa: Especificaciones de huella AEAT v0.1.2 Revisado por el equipo técnico de verifactu.co