Skip to main content

Invio al Sistema di Interscambio

Questa sezione descrive le funzionalità di invio fatture al SDI.


📤 Invio singola fattura

L'invio avviene tramite il servizio InvSdiService.

Processo di invio

  1. Validazione: verifica completezza dati fattura
  2. Generazione XML: tramite InvXmlService
  3. Invio al driver: il driver configurato invia al SDI
  4. Salvataggio risposta: UUID e stato vengono salvati

Risposta del SDI

La risposta viene salvata in InvSdiResponseDto:

  • uuid: identificativo univoco dal provider
  • status: stato iniziale (tipicamente INV)
  • sdi_id: identificativo assegnato dal SDI
  • log: dettagli dell'operazione

📤 Invio massivo

È possibile inviare più fatture contemporaneamente.

Caratteristiche

  • Selezione multipla dall'elenco fatture
  • Invio in batch con gestione errori individuali
  • Report finale con esiti per ogni fattura

🔔 Gestione Webhook

Il sistema riceve notifiche dal SDI tramite webhook.

Eventi gestiti

  • RC (Ricevuta Consegna): fattura consegnata al destinatario
  • MC (Mancata Consegna): problemi nella consegna
  • NS (Notifica di Scarto): fattura rifiutata dal SDI

Processo webhook

  1. Autorizzazione della richiesta tramite authorizeWebhook()
  2. Parsing del payload tramite il driver
  3. Aggiornamento stato fattura
  4. Salvataggio log nel campo metadata

📊 Monitoraggio stato

Lo stato di ogni fattura è tracciato in inv_sdi_driver_identifiers.

Campi tracciati

  • sdi_status: stato corrente nel SDI
  • sdi_id: identificativo SDI assegnato
  • metadata: storico completo delle comunicazioni

Stati possibili

StatoDescrizione
DIDa inviare
INVInviata al provider
RCRicevuta consegna
MCMancata consegna
NSNotifica di scarto