Vai al contenuto principale
VeriFactu

Errori VeriFactu in Odoo: come leggere cosa dice l'AEAT e cosa blocca prima il tuo sistema

Un errore VeriFactu può arrivare da due parti: dall'AEAT, l'agenzia delle entrate spagnola, che risponde a ogni invio con uno stato e un codice, o dal tuo stesso sistema, che blocca la fattura prima di inviarla se manca qualcosa, come il certificato o un NIF valido. Distinguerli fa risparmiare tempo, perché si correggono in posti diversi. Ecco i due gruppi.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 3 novembre 2026

In breve

Modulo
VeriFactu
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del modulo, versione 20.0 · nelle fonti collegate in fondo
Lettura
3 min

Cosa risponde l'AEAT

Ogni invio contiene tra 1 e 1.000 record. La risposta riporta uno stato per l'intero invio (Correcto, ParcialmenteCorrecto o Incorrecto), uno stato per record (Correcto, AceptadoConErrores o Incorrecto) e il tempo di attesa fino all'invio successivo.

L'AEAT pubblica il suo catalogo ufficiale degli errori, con 247 codici, in tre famiglie:

FamigliaCosa significaCosa fare
4xxx: invio intero rifiutatoNiente di quell'invio è stato registrato.Correggi la causa e reinvia l'invio completo.
Record rifiutatoQuel record non è accettato; il resto dell'invio sì.Correggi quel record e reinvia solo quello.
2xxx: accettato con erroriIl record è registrato, ma c'è qualcosa da correggere.Non reinviarlo come nuovo: correggi ciò che indica il codice.

Due casi conviene riconoscerli subito. Il codice 3000 segnala un record duplicato: se risulta già corretto o accettato con errori, non serve reinviarlo. E l'impronta, uno SHA-256 concatenato al record precedente, viene ricalcolata dall'AEAT: se non coincide, il record viene accettato con un errore da correggere.

Elenco degli errori restituiti dall'AEAT dentro Odoo
Errori dell'AEAT, record per record e raggruppati per codice, dentro Odoo. Schermata di Odoo con dati dimostrativi; le risposte dell'AEAT sono simulate.

Prima di arrivare all'AEAT: il certificato

L'AEAT identifica l'emittente dal certificato presentato al momento della connessione. Senza certificato, il suo servizio reindirizza alla pagina di errore 4033, «nessun certificato rilevato». Con un certificato che non si convalida, alla 4011. In Odoo questi casi si fermano prima:

  • No active certificate for company …: l'azienda non ha un certificato attivo. Caricalo in Configuration › Certificates.
  • The certificate … of company … has expired.: è scaduto. C'è un avviso quotidiano di scadenza proprio per non arrivare a questo punto.

Cosa blocca il tuo sistema prima dell'invio

MessaggioCosa mancaSoluzione
Company … has no NIF for Veri*Factu.L'azienda non ha il NIF.Compilalo nei dati dell'azienda.
Invalid NIF length: "…" (must be 9 chars)Il NIF del cliente non ha 9 caratteri.Controlla il NIF nel contatto.
Invalid NIF digits: "…"Il NIF contiene caratteri non validi.Correggilo nel contatto.
Cannot post invoice: invalid counterparty identifier.L'identificativo del cliente non è valido.Correggi l'identificativo prima di registrare.
Record … has no tax breakdown (Desglose) to declare.La fattura non ha il dettaglio delle imposte.Controlla le imposte nelle righe.
Record … is chained to a previous record that does not exist.La catena dei record è interrotta.Non toccarla a mano: controlla lo stato della catena e scrivici.
The AEAT accepts at most 1000 records per request.Un invio con più record del consentito.La coda li divide; se vedi questo messaggio, avvisaci.
Catalogo degli errori dell'AEAT caricato in Odoo
Il catalogo degli errori dell'AEAT dentro Odoo, con i suoi 247 codici, per leggerli senza uscire dal sistema. Schermata di Odoo con dati dimostrativi.

Dove guardare in Odoo

La coda di invio si elabora ogni minuto e si trova in AEAT Submission › Submission Queue. Gli errori restituiti dall'AEAT hanno il loro elenco in AEAT Errors, e il catalogo completo dei codici in AEAT Error Catalogue. Queste tre schermate risolvono la maggior parte dei casi senza aprire il documento tecnico dell'AEAT, anche se è linkato qui sotto nel caso ti serva.

Coda di invio all'AEAT in Odoo
La coda di invio: cosa è in attesa, cosa è stato inviato e cosa è fallito. Schermata di Odoo con dati dimostrativi; le risposte dell'AEAT sono simulate.

Il modulo è pubblicato per Odoo 17, 18, 19 e 20. Se un codice non è nel catalogo, mandaci il testo esatto della risposta: lo cercheremo nel documento ufficiale delle validazioni.

Continua a leggere

VeriFactu: le scadenze del 2027, la previsione per il 2028 e cosa fare intanto in OdooIl calendario VeriFactu a novembre 2026: scadenze del RDL 15/2025, previsione del Ministero di un rinvio a ottobre 2028 e cosa preparare subito in Odoo.VeriFactu: miti e realtà per le aziende che fatturano con OdooConvinzioni diffuse su VeriFactu confrontate con l'AEAT e con il sistema stesso: impronta, errori accettati, annullamenti, migrazioni, scadenze e il modulo di Odoo.
Verificato nel codice del modulo (versione 20.0) e nelle fonti collegate

Fonti