Salta al contingut principal
VeriFactu

Errors de VeriFactu a Odoo: com llegir el que diu l'AEAT i el que el teu sistema atura abans

Un error de VeriFactu pot venir de dos llocs: l'AEAT, que respon cada enviament amb un estat i un codi, o el teu propi sistema, que bloqueja la factura abans d'enviar-la si falta alguna cosa, com el certificat o un NIF vàlid. Distingir-los estalvia temps, perquè s'arreglen en llocs diferents. Aquí tens els dos grups.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 3 de novembre de 2026

L'essencial

Mòdul
VeriFactu
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del mòdul, versió 20.0 · a les fonts enllaçades al final
Lectura
3 min

El que respon l'AEAT

Cada enviament porta entre 1 i 1.000 registres. La resposta inclou un estat per a tot l'enviament (Correcto, ParcialmenteCorrecto o Incorrecto), un estat per registre (Correcto, AceptadoConErrores o Incorrecto) i el temps d'espera fins al següent enviament.

L'AEAT publica el seu catàleg oficial d'errors, amb 247 codis, en tres famílies:

FamíliaQuè vol dirQuè cal fer
4xxx: enviament sencer rebutjatNo s'ha registrat res d'aquest enviament.Corregeix la causa i torna a enviar tot l'enviament.
Registre rebutjatAquest registre no s'accepta; la resta de l'enviament sí.Corregeix aquest registre i torna a enviar només aquest.
2xxx: acceptat amb errorsEl registre queda registrat, però s'ha de corregir alguna cosa.No el tornis a enviar com a nou: corregeix el que diu el codi.

Val la pena reconèixer de seguida dos casos concrets. El codi 3000 indica un registre duplicat: si ja consta com a correcte o acceptat amb errors, no cal tornar-lo a enviar. I l'empremta (huella), un SHA-256 encadenat amb el registre anterior, la recalcula l'AEAT: si no coincideix, el registre s'accepta amb un error que s'ha de corregir.

Llista d'errors retornats per l'AEAT dins d'Odoo
Errors de l'AEAT, registre per registre i agrupats per codi, dins d'Odoo. Captura d'Odoo amb dades de demostració; les respostes de l'AEAT són simulades.

Abans d'arribar a l'AEAT: el certificat

L'AEAT identifica l'emissor pel certificat que es presenta en connectar. Sense certificat, el seu servei redirigeix a la pàgina d'error 4033, «no s'ha detectat cap certificat». Amb un certificat que no valida, a la 4011. A Odoo, aquests casos s'aturen abans:

  • No active certificate for company …: l'empresa no té cap certificat actiu. Puja'l a Configuration › Certificates.
  • The certificate … of company … has expired.: ha caducat. Hi ha un avís diari de caducitat perquè no arribis fins aquí.

El que el teu sistema bloqueja abans d'enviar

MissatgeQuè faltaSolució
Company … has no NIF for Veri*Factu.L'empresa no té NIF.Omple'l a les dades de l'empresa.
Invalid NIF length: "…" (must be 9 chars)El NIF del client no té 9 caràcters.Revisa el NIF al contacte.
Invalid NIF digits: "…"El NIF conté caràcters no vàlids.Corregeix-lo al contacte.
Cannot post invoice: invalid counterparty identifier.L'identificador del client no és vàlid.Corregeix l'identificador abans de publicar.
Record … has no tax breakdown (Desglose) to declare.La factura no té desglossament d'impostos.Revisa els impostos de les línies.
Record … is chained to a previous record that does not exist.La cadena de registres està trencada.No la toquis a mà: revisa l'estat de la cadena i escriu-nos.
The AEAT accepts at most 1000 records per request.Un enviament amb més registres dels permesos.La cua els divideix; si veus això, avisa'ns.
Catàleg d'errors de l'AEAT carregat a Odoo
El catàleg d'errors de l'AEAT dins d'Odoo, amb els seus 247 codis, per llegir cadascun sense sortir del sistema. Captura d'Odoo amb dades de demostració.

On mirar a Odoo

La cua d'enviaments es processa cada minut i és a AEAT Submission › Submission Queue. Els errors retornats per l'AEAT tenen la seva pròpia llista a AEAT Errors, i el catàleg complet de codis, a AEAT Error Catalogue. Aquestes tres pantalles resolen la majoria de casos sense obrir el document tècnic de l'AEAT, tot i que te l'enllacem a sota per si el necessites.

Cua d'enviaments a l'AEAT a Odoo
La cua d'enviaments: què està pendent, què s'ha enviat i què ha fallat. Captura d'Odoo amb dades de demostració; les respostes de l'AEAT són simulades.

El mòdul està publicat per a Odoo 17, 18, 19 i 20. Si un codi no és al catàleg, envia'ns el text exacte de la resposta: el trobarem al document oficial de validacions.

Continua llegint

VeriFactu: els terminis del 2027, la previsió del 2028 i què fer mentrestant a OdooEl calendari de VeriFactu al novembre de 2026: terminis del RDL 15/2025, previsió del Ministeri d'endarrerir-lo a l'octubre de 2028 i què preparar ara a Odoo.VeriFactu: mites i realitats per a empreses que facturen amb OdooCreences habituals sobre VeriFactu contrastades amb l'AEAT i amb el mateix sistema: empremta, errors acceptats, anul·lacions, migracions, terminis i el mòdul d'Odoo.
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades

Fonts