INAD - Indice Nazionale dei Domicili Digitali¶
Panoramica¶
L'integrazione INAD consente di recuperare i domicili digitali (PEC/PEO) dei destinatari dei verbali. Viene utilizzata per determinare il canale di notifica appropriato: digitale (PEC) o tradizionale (raccomandata).
Architettura¶
sequenceDiagram
participant ELB as ElaborazioneService
participant CONN as ConnessioneService
participant INAD as INAD (AgID)
ELB->>CONN: Richiesta domicilio digitale (CF)
CONN->>INAD: GET /domicilio-digitale/{cf}
INAD-->>CONN: Domicilio digitale (PEC/PEO)
CONN-->>ELB: Risultato lookup
alt Domicilio trovato
ELB->>ELB: Notifica via PEC/PND
else Domicilio non trovato
ELB->>ELB: Notifica via raccomandata
end
Classi di Implementazione¶
ConnessioneService¶
| Classe | Package | Descrizione |
|---|---|---|
InadConnRestService |
it.mdatasystem.connessioni.inad.rest |
Endpoint REST per INAD |
InadController |
it.mdatasystem.connessioni.inad.rest |
Logica di controllo INAD |
UtilityInad |
it.mdatasystem.connessioni.inad.rest |
Metodi utility |
Model/DTO¶
| Classe | Descrizione |
|---|---|
DomicilioDigitale |
Indirizzo PEC/PEO del soggetto |
RecuperoDomicilioDigitaleResponse |
Risposta singolo domicilio |
RecuperoElencoDomiciliDigitaliResponse |
Risposta elenco domicili |
RichiestaElencoDomiciliDigitali |
Richiesta elenco domicili |
VerificaDomicilioDigitaleResponse |
Risposta verifica domicilio |
StatusResponse |
Risposta stato servizio |
Status |
Stato operazione |
InfoUtilizzo |
Info sull'utilizzo del domicilio |
Protocollo¶
- Tipo: REST over HTTPS
- Autenticazione: OAuth2 + certificati client
- Formato dati: JSON
- Operazioni principali:
- Recupero domicilio digitale per CF
- Recupero elenco domicili digitali (batch)
- Verifica validita domicilio
Configurazione¶
I parametri di connessione sono configurati nelle entita VpWsPar e VpExtservicePar.
Riferimenti¶
- INAD: https://domiciliodigitale.gov.it/
- Documentazione API: https://www.agid.gov.it/it/piattaforme/domicilio-digitale