Vai al contenuto
Torna ai lavori

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

Riconosci uno di questi problemi?

Se qualcosa di tutto ciò somiglia al sistema con cui convivi, di solito è un buon punto da cui partire.