Nella fatturazione elettronica, l’invio di una fattura allo SDI è solo una parte del processo.
Ogni documento attraversa un ciclo di vita che comprende notifiche ed esiti restituiti dal Sistema di Interscambio.
Per software gestionali ed ERP, la gestione delle notifiche SDI è un aspetto strutturale dell’integrazione, perché determina lo stato fiscale e operativo delle fatture.
In questo articolo vediamo quali notifiche restituisce lo SDI e come gestirle correttamente tramite API, in particolare in contesti software e multi-cliente.
Il ruolo delle notifiche nel ciclo di vita della fattura
Quando una fattura viene trasmessa allo SDI, l’esito non è immediato né univoco.
Il Sistema di Interscambio comunica l’evoluzione del documento attraverso notifiche asincrone, che devono essere correttamente interpretate e tracciate.
Le notifiche servono a:
-
determinare se la fattura è stata accettata o scartata
-
stabilire se è stata recapitata al destinatario
-
attestare eventi con rilevanza fiscale
-
mantenere uno stato coerente del documento nel tempo
Un’integrazione che non gestisce correttamente le notifiche non può considerarsi completa.
Le principali notifiche restituite dallo SDI
Ricevuta di consegna
Indica che la fattura:
-
è stata accettata dallo SDI
-
è stata recapitata correttamente al destinatario
È l’esito che conferma il completamento del processo di invio.
Notifica di mancata consegna
La fattura:
-
è formalmente valida
-
è correttamente acquisita dallo SDI
-
non può essere recapitata al destinatario (ad esempio per indisponibilità del canale)
Dal punto di vista fiscale la fattura è correttamente emessa, ma l’evento deve essere registrato e reso visibile nel gestionale.
Notifica di scarto
La fattura viene rifiutata dallo SDI a causa di:
-
errori formali
-
incongruenze nei dati
-
violazioni delle regole FatturaPA
In caso di scarto:
-
la fattura si considera non emessa
-
è necessario correggere il documento
-
è richiesto un nuovo invio
La gestione dello scarto è uno degli aspetti più delicati dell’integrazione.
Accettazione, Rifiuto e Decorrenza dei termini
Per le fatture elettroniche inviate alla Pubblica Amministrazione, dopo la notifica di consegna, arriverà uno di questi tre tipi di notifica:
-
Accettazione
-
L’ufficio dell’Ente destinatario ha formalmente accettato la fattura, che verrà quindi messa in pagamento
-
-
Rifiuto
-
L’ufficio dell’Ente destinatario ha espressamente rifiutato la fattura, per una o più ragioni, che verranno indicate nel messaggio allegato. La fattura andrà quindi presumibilmente, stornata, corretta e reinviata.
-
-
Decorrenza termini
-
L’Ente non ha espresso alcun parere entro il termine previsto (15 giorni). In questo caso servirà contattare l’Ente per informazioni su come procedere.
-
Anche queste notifiche hanno rilevanza fiscale e devono essere correttamente tracciate.
Gestione delle notifiche tramite API
In un’architettura software, le notifiche SDI devono essere:
-
ricevute in modo affidabile
-
associate alla fattura corretta
-
persistite
-
rese disponibili al gestionale
Fattura-Elettronica-API si occupa di:
-
interfacciarsi con lo SDI
-
ricevere le notifiche
-
interpretarne il contenuto
-
esporle in modo coerente al software integrato
Il gestionale non dialoga direttamente con lo SDI, ma utilizza l’API come punto di accesso unico allo stato delle fatture.
Notifiche in formato strutturato
Per i software gestionali è fondamentale poter lavorare con dati strutturati.
Fattura-Elettronica-API consente di ottenere le notifiche:
-
come eventi strutturati
-
in formato facilmente integrabile (JSON)
-
senza dover interpretare direttamente l’XML SDI
Le informazioni esposte includono:
-
esito
-
codici di errore
-
descrizioni leggibili
-
riferimenti temporali
Questo permette al gestionale di mantenere una logica applicativa chiara e consistente.
Notifiche e ambienti multi-cliente
In contesti multi-tenant, la gestione delle notifiche richiede particolare attenzione.
L’API deve:
-
distinguere correttamente i soggetti emittenti
-
associare ogni notifica al cliente finale corretto
-
garantire isolamento dei dati
-
mantenere tracciabilità completa
Il gestionale può così:
-
gestire più aziende con un’unica integrazione
-
aggiornare correttamente gli stati
-
evitare ambiguità o contaminazioni tra clienti
Best practice di integrazione
Alcune pratiche fondamentali per una gestione corretta delle notifiche SDI:
-
non considerare concluso l’invio senza un esito SDI
-
distinguere chiaramente tra consegna e mancata consegna
-
trattare lo scarto come evento bloccante
-
storicizzare tutte le notifiche
-
rendere lo stato sempre accessibile al gestionale
Un’API ben progettata consente di adottare queste pratiche senza aumentare la complessità del codice applicativo.
Conclusione
Le notifiche SDI sono una componente essenziale della fatturazione elettronica e determinano lo stato reale delle fatture.
Gestirle correttamente tramite API consente di:
-
garantire conformità normativa
-
mantenere coerenza applicativa
-
supportare architetture multi-cliente
-
offrire un’esperienza affidabile agli utenti finali
Per software gestionali ed ERP, la gestione strutturata delle notifiche è ciò che rende l’integrazione con lo SDI realmente solida.