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
- Validazione: verifica completezza dati fattura
- Generazione XML: tramite
InvXmlService - Invio al driver: il driver configurato invia al SDI
- Salvataggio risposta: UUID e stato vengono salvati
Risposta del SDI
La risposta viene salvata in InvSdiResponseDto:
uuid: identificativo univoco dal providerstatus: stato iniziale (tipicamenteINV)sdi_id: identificativo assegnato dal SDIlog: 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
- Autorizzazione della richiesta tramite
authorizeWebhook() - Parsing del payload tramite il driver
- Aggiornamento stato fattura
- 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 SDIsdi_id: identificativo SDI assegnatometadata: storico completo delle comunicazioni
Stati possibili
| Stato | Descrizione |
|---|---|
| DI | Da inviare |
| INV | Inviata al provider |
| RC | Ricevuta consegna |
| MC | Mancata consegna |
| NS | Notifica di scarto |