SDIInterop — Integrazione fatturazione elettronica
Uno strato di integrazione riusabile per la fatturazione elettronica verso l'Agenzia delle Entrate: generazione XML, validazione a schema, ritentativi e coda di scarto.
Lavoro su commessa — sorgente non pubblico
- Tipo
- Integrazione
- Periodo
- 2023
- Stato
- In produzione
- Ruolo
- Software Engineer
Il problema
Le imprese italiane devono scambiare le fatture elettronicamente attraverso il Sistema di Interscambio dell’Agenzia delle Entrate. Non è facoltativo, il formato è rigido, e il modo in cui fallisce è burocratico: non viene rifiutato niente al momento dell’invio — torna indietro più tardi una ricevuta con un codice. Una fattura che non arriva in silenzio è un problema di conformità, non un ticket di supporto.
Cosa ho costruito
Un modulo riutilizzabile invece di un’integrazione riscritta dentro ogni prodotto: invio, ricezione delle ricevute e tracciamento dello stato, dietro un’interfaccia che l’applicazione ospite implementa sul proprio modello di fattura.
Il passaggio che porta quasi tutto il valore è la validazione di ogni documento contro gli schemi ufficiali in locale, prima che parta: trasforma uno scarto che arriverebbe giorni dopo in un errore immediato, con il numero di riga. Tutto ciò che non si riesce a consegnare finisce in un posto dove qualcuno guarderà, perché in un obbligo di legge l’esito inaccettabile non è il fallimento, è il silenzio.
A che punto è
Ha girato in produzione su fatture elettroniche reali, togliendo l’invio manuale e gli errori di trascrizione che si portava dietro. Un cambio normativo oggi è una correzione sola invece di diverse.
Cosa ho fatto
- Progettato uno strato di integrazione modulare per invio, ricezione delle notifiche e tracciamento dello stato
- Implementato generazione e validazione XML contro gli schemi ufficiali prima di qualunque invio
- Costruito ritentativi con backoff e una coda di scarto, così un rifiuto è visibile invece che perso
- Reso il modulo riusabile su più applicazioni invece di reintegrarlo ogni volta
Impatto
- Ha gestito fatture elettroniche reali in produzione
- Eliminato l'invio manuale e gli errori di trascrizione che si portava dietro
Stack
- .NET
- XML
- REST
- Retry e DLQ
- Compliance