Saltar al contenido principal
VeriFactu

Errores de VeriFactu en Odoo: cómo leer lo que dice la AEAT y lo que para antes tu sistema

Un error de VeriFactu puede venir de dos sitios: de la AEAT, que responde a cada envío con un estado y un código, o de tu propio sistema, que bloquea la factura antes de mandarla si falta algo, como el certificado o un NIF válido. Distinguirlos ahorra tiempo, porque se arreglan en sitios distintos. Aquí tienes los dos grupos.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 3 de noviembre de 2026

Lo esencial

Módulo
VeriFactu
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del módulo, versión 20.0 · en las fuentes enlazadas al final
Lectura
3 min

Lo que responde la AEAT

Cada envío lleva entre 1 y 1.000 registros. La respuesta trae un estado del envío completo (Correcto, ParcialmenteCorrecto o Incorrecto), un estado por registro (Correcto, AceptadoConErrores o Incorrecto) y el tiempo de espera hasta el siguiente envío.

La AEAT publica su catálogo oficial de errores, con 247 códigos, en tres familias:

FamiliaQué significaQué hacer
4xxx: rechazo del envío completoNo se ha registrado nada de ese envío.Corregir la causa y volver a enviar el envío entero.
Rechazo del registroEse registro no entra; los demás del envío sí.Corregir ese registro y reenviarlo solo a él.
2xxx: aceptado con erroresEl registro queda registrado, pero hay que subsanar algo.No reenviar como nuevo: subsanar lo que indica el código.

Dos casos concretos conviene reconocerlos a la primera. El código 3000 indica un registro duplicado: si ya consta como correcto o aceptado con errores, no hay que reenviarlo. Y la huella, un SHA-256 encadenado con el registro anterior, la recalcula la AEAT: si no casa, acepta el registro con un error que hay que subsanar.

Lista de errores devueltos por la AEAT dentro de Odoo
Los errores de la AEAT, registro a registro y agrupados por código, dentro de Odoo. Captura de Odoo con datos de demostración; las respuestas de la AEAT son simuladas.

Antes de llegar a la AEAT: el certificado

La AEAT identifica al emisor por el certificado que se presenta al conectar. Sin certificado, su servicio redirige a la página de error 4033, «no se detecta certificado». Con un certificado que no valida, a la 4011. En Odoo, estos casos se paran antes:

  • No active certificate for company …: la empresa no tiene un certificado activo. Súbelo en Configuration › Certificates.
  • The certificate … of company … has expired.: está caducado. Hay un aviso diario de caducidad para que no llegues a esto.

Lo que bloquea tu sistema antes de enviar

MensajeQué faltaArreglo
Company … has no NIF for Veri*Factu.La empresa no tiene NIF.Rellénalo en los datos de la empresa.
Invalid NIF length: "…" (must be 9 chars)El NIF del cliente no tiene 9 caracteres.Revisa el NIF en el contacto.
Invalid NIF digits: "…"El NIF tiene caracteres no válidos.Corrígelo en el contacto.
Cannot post invoice: invalid counterparty identifier.El identificador del cliente no es válido.Corrige el identificador antes de publicar.
Record … has no tax breakdown (Desglose) to declare.La factura no tiene desglose de impuestos.Revisa los impuestos de las líneas.
Record … is chained to a previous record that does not exist.La cadena de registros está rota.No lo toques a mano: revisa el estado de la cadena y escríbenos.
The AEAT accepts at most 1000 records per request.Un envío con más registros de los permitidos.La cola los parte; si lo ves, avísanos.
Catálogo de errores de la AEAT cargado en Odoo
El catálogo de errores de la AEAT dentro de Odoo, con sus 247 códigos, para leer cada uno sin salir del sistema. Captura de Odoo con datos de demostración.

Dónde mirar en Odoo

La cola de envío se procesa cada minuto y está en AEAT Submission › Submission Queue. Los errores devueltos por la AEAT tienen su lista propia en AEAT Errors, y el catálogo completo de códigos en AEAT Error Catalogue. Con esas tres pantallas se resuelve la mayoría de los casos sin abrir el documento técnico de la AEAT, aunque está enlazado abajo por si lo necesitas.

Cola de envío a la AEAT en Odoo
La cola de envío: lo que está pendiente, lo enviado y lo que falló. Captura de Odoo con datos de demostración; las respuestas de la AEAT son simuladas.

El módulo está publicado para Odoo 17, 18, 19 y 20. Si un código no aparece en el catálogo, envíanos el texto exacto de la respuesta: lo localizamos en el documento oficial de validaciones.

Sigue leyendo

VeriFactu: los plazos de 2027, la previsión de 2028 y qué hacer en Odoo mientras tantoCalendario de VeriFactu a noviembre de 2026: plazos del RDL 15/2025, la previsión de Hacienda de aplazar a octubre de 2028 y qué preparar ya en Odoo.VeriFactu: mitos y realidades para empresas que facturan con OdooLo que se suele creer de VeriFactu y lo que dicen la AEAT y el propio sistema: huella, errores aceptados, anulaciones, migraciones, plazos y el módulo nativo de Odoo.
Comprobado en el código del módulo (versión 20.0) y en las fuentes enlazadas

Fuentes