E-INVOICE - Come verificare lo stato di una fattura elettronica?

Quando si crea un Record di fattura (TRANSACTION::INVOICE), viene creato contestualmente anche un Record di trasmissione (E_INVOICE::TRANSMISSION) per tracciare la consegna della fattura elettronica. 

Passaggio 1: recupero del Record TRANSACTION::INVOICE

Alla creazione di un TRANSACTION::INVOICE, salvare l'id del record dalla risposta dell'API. Recuperarlo poi tramite:

GET /records/{{record_id}}

Nella risposta, controllare il campo content.logs:

• Se contiene voci con "severity": "ERROR", la fattura non ha superato la validazione prima che venisse tentata la trasmissione. Per risolvere il problema, esaminare il messaggio di errore, correggere di conseguenza il payload della richiesta e creare un nuovo Record TRANSACTION::INVOICE con una nuova chiave di idempotenza.
• Se content.logs è vuoto, la validazione è stata superata e la fattura elettronica è stata inviata per la trasmissione. Procedere con il Passaggio 2.

Passaggio 2: recupero del Record E_INVOICE::TRANSMISSION

Nella risposta del TRANSACTION::INVOICE ottenuta al Passaggio 1, individuare il campo content.used_in.id. Questo è l'ID del Record E_INVOICE::TRANSMISSION. Recuperarlo tramite:

GET /records/{{content.used_in.id}}

Controllare il campo content.logs:

• Se contiene voci ERROR, la fattura elettronica non è stata consegnata sulla rete di fatturazione elettronica. Il campo message descrive il problema riscontrato. Per risolvere il problema, esaminare il messaggio di errore, correggere di conseguenza il payload della richiesta e creare un nuovo Record TRANSACTION::INVOICE con una nuova chiave di idempotenza. 
  Se l'errore indica un problema di rete o di infrastruttura, riprovare dopo una breve attesa. 
  Se il problema persiste, contattare il supporto fiskaly.

   

• Se content.logs è vuoto su entrambi i Record, la trasmissione potrebbe essere ancora in corso. La consegna della fattura elettronica viene gestita in modo asincrono e si completa in genere entro pochi secondi o minuti. 
  Se i log restano vuoti dopo diversi minuti, contattare il supporto fiskaly.

Lettura di una voce di log

Ogni voce di log contiene i seguenti campi:

Esempio

[
  {
    "$": "Log@v1",
    "date": "2026-05-13T08:32:18.214995449Z",
    "message": "invalid Belgian VAT ID length '12'",
    "severity": "ERROR"
  },
  {
    "$": "Log@v1",
    "date": "2026-05-13T08:32:18.30059009Z",
    "message": "e_invoicing failed: code: invalid format.",
    "severity": "ERROR"
  }
]