-
CITTADINO: le persone fisiche che abbiano compiuto il diciottesimo anno di età e che abbiano la capacità di agire
-
domicilio digitale: PEC, prevista inclusione dei sistemi di notifica certificati ai sensi del eIDASR
-
eIDASR: regolamento (ue) n. 910/2014 del parlamento europeo e del consiglio
-
LG INAD: LINEE GUIDA dell’Indice nazionale dei domicili digitali delle persone fisiche, dei professionisti e degli altri enti di diritto privato non tenuti all’iscrizione in albi, elenchi o registri professionali o nel registro delle imprese, allo stato le LG adottate da AgID in attuazione dell’articolo 6-quater del CAD nella versione antecedente allo 06/11/2022, è prevista la revisione delle LG per adeguarle all'ultima versione del citato articolo del CAD
-
LG Interoperabilità: Linee Guida sull’interoperabilità tecnica delle Pubbliche Amministrazioni
FR.001
name: tipi domicili digitali
description:
- PEC, type mailbox conforme a rfc5321
for: INAD
FR.002
name: soggetti che posso eleggere domicilio digitale
description:
- (CITTADINI) persone fisiche che abbiano compiuto il diciottesimo anno di età e che abbiano la capacità di agire
- (PROFESSIONISTI) professionisti ai sensi della legge n. 4/2013
- (ENTI) enti di diritto privato non tenuti all’iscrizione nell’INI-PEC"
for: INAD
FR.003
name: dati registrazione CITTADINI
description:
- nome, ottenuti dall'autenticazione
- cognome, ottenuti dall'autenticazione
- codice fiscale, ottenuti dall'autenticazione
- email contatto, dichiarati
for: INAD, ANPR, AppIO
FR.004
name: dati registrazione PROFESSIONISTI
description:
- nome, ottenuti dall'autenticazione
- cognome, ottenuti dall'autenticazione
- codice fiscale, ottenuti dall'autenticazione
- email contatto, dichiarati
- professione 4/2013, dichiarati
CHECK:
- professione 4/2013 <> professioni INI-PEC"
for: INAD
FR.005
name: dati registrazione ENTI
description:
registrazione fatta dal rappresentate legale:
- nome rappresentate legale, ottenuti dall'autenticazione
- cognome rappresentate legale, ottenuti dall'autenticazione
- codice fiscale rappresentate legale, ottenuti dall'autenticazione
- email contatto, dichiarati
- denominazione, dichiarati
- codice fiscale, dichiarati
- dichiarazione sostitutiva qualifica rappresentate legale, dichiarati
registrazione delegato del rappresentate legale:
- nome delegato rappresentate legale, ottenuti dall'autenticazione
- cognome delegato rappresentate legale, ottenuti dall'autenticazione
- codice delegato fiscale rappresentate legale, ottenuti dall'autenticazione
- nome rappresentate legale, dichiarati
- cognome rappresentate legale, dichiarati
- codice fiscale rappresentate legale, dichiarati
- email contatto, dichiarati
- denominazione, dichiarati
- codice fiscale, dichiarati
- dichiarazione sostitutiva delega e qualifica rappresentate legale, dichiarati
CHECK:
- codice fiscale ENTE, with AT
- ENTE not in INI-PEC
- ENTE not in IPA"
for: INAD
FR.006
name: azioni ciclo di vita domicilio digitale
description:
- elezione
- modifica
- cessazione volontaria (not for CITTADINO=Professionista INI-PEC)
- cessazione d'ufficio (domicilio digitale non funzionante)
- cessazione in casi particolari (decesso CITTADINO or PROFESSIONISTA, estinzione ENTE)"
for: INAD, ANPR, AppIO
FR.007
name: fasi richiesta elezione, modifica, cessazione volontaria ciclo di vita domicilio digitale
description:
- richiesta:
- autenticazione
- raccolta_dati
- validazione (CHECK disponibilità del domicilio digitale per il CITTADINO e funzionamento domicilio digitale per elezione e modifica)
- pubblicazione (entro le 1.00 del giorno successivo alla richiesta per elezione/modica/cessazione d'ufficio/cessazione per casi paticolari, entro le 1.00 dopo 90gg dalla richiesta per cessazione volontaria)"
for: INAD, ANPR, AppIO
FR.008
name: stati richiesta CITTADINO in INAD
description:
un CITTADINO in INAD può trovarsi nei seguenti stati:
- citizenNotPresent, il CITTADINO non risulta registrato in INAD
- digitalDomicileNotPresent, il CITTADINO è registrato in INAD ma il domicilio digitale non è stato eletto
- inCharge, il CITTADINO è registrato in INAD e risulta l'avvio di una richiesta
- verify, il CITTADINO è registrato con una richiesta in verifica
- confirmationRequestSent, il CITTADINO è registrato in INAD ed è stata mandata conferma della richiesta alla PEC o email di contatto del CITTADINO
- awaitingPublication, il CITTADINO è registrato con una richiesta in attesa di pubblicazione
- digitalDomicilePresent, il CITTADINO è registrato e il domicilio digitale è stato eletto
for: INAD, ANPR, AppIO
FR.009
name: annullamento richieste
description:
il CITTADINO puo' annullare le richiesta prima dell'avvio della verifica
for: INAD, ANPR, AppIO
FR.010
name: una solo richiesta
description:
per ogni CITTADINO è possibile sottomettere una sola richiesta di azione (elezione, modifica, cancellazione volontaria) per volta in INAD
for: INAD, ANPR, AppIO
FR.011
name: notifica variazioni intervenute da INAD a ANPR/AppIO
description:
alla conclusione della pubblicazione (entro ore 1.00 di ogni giorno) INAD inoltra le variazioni intervenute (insert, modify, deleted) sui domicili digitali dei solo CITTADINI a ANPR e AppIO
for: INAD, ANPR, AppIO
FR.012
name: recupero snapshot domicili digitali eletti
description:
INAD rende disponibile lo snapshot dei domicili digitali eletti dai CITTADINI ad ANPR
for: INAD, ANPR, AppIO
FR.013
name: inoltro richiesta elezione, modifica, cessazione volontaria x PEC
description:
ANPR e AppIO inoltrano richiesta di elezione, modifica, cessazione volontaria di un CITTADINO
ANPR/AppIO sono responsabile della richiesta.autenticazione e richiesta.raccolta_dati
INAD è responsabile della richiesta.validazione e pubblicazione
for: INAD, ANPR, AppIO
FR.014
name: inoltro confema/annullamento richiesta
description:
INAD notifica ad ANPR/AppIO l'avvenuta conferma o annullamento della richiesta di elezione, modifica e cancellazione volontaria di un CITTADINO
for: INAD, ANPR, AppIO
FR.015
name: inoltro esito verifica
description:
INAD notifica ad ANPR/AppIO l'avvenuta conferma o annullamento della richiesta
for: INAD, ANPR, AppIO
FR.018
name: recupero email contatto CITTADINO
description:
INAD rende disponibile il recupero dell'email contatto di un CITTADINO
for: INAD, ANPR, AppIO
FR.019
name: inoltro modifica email contatto
description:
ANPR/AppIO inoltrano il cambio della email contatto
for: INAD, ANPR, AppIO
FR.020
name: inoltro decesso CITTADINO
description:
ANPR inoltra l'evendo di decesso di un CITTADINO ad INAD
for: INAD, ANPR
NFR.001
name: tecnologia servizi
description:
i servizi realizzati da INAD, ANPR e AppIO sono implementati tramite API REST e descritti da OpenAPI 3.0 nel rispetto delle LG Interoperabilità
for: INAD, ANPR, AppIO
NFR.002
name: autenticazione client
description:
l'autenticazione dei client ai servizi di INAD, ANPR e AppIO è realizzatra tramite PDND nel rispetto delle LG PDND
for: INAD, ANPR, AppIO
NFR.003
name: non ripudio delle richieste
description: le request dei client sono firmate attuando il patter sicurezza INTEGRITY_REST_01 delle LG Interoperabilità
for: INAD, ANPR, AppIO
NFR.004
name: non ripudio delle risposte
description: le response dei servizi sono firmate attuando il patter sicurezza INTEGRITY_REST_01 delle LG Interoperabilità
for: INAD, ANPR, AppIO
Il presente use case è di interesse per ANPR e AppIO.
Si assume che ANPR/AppIO abbia dato seguito all'autenticazione del CITTADINO, nel rispetto dell'art. 64 del CAD, e recuperato per lo stesso i seguenti attributi:
- nome, ottenuti dall'autenticazione
- cognome, ottenuti dall'autenticazione
- codice fiscale, ottenuti dall'autenticazione.
Il presente Use Case prevede:
- ANPR/AppIO richiede ad INAD lo stato del CITTADINO utilizzando la API status_check inoltrando il codice fiscale
se lo STATE del CITTADINO è citizenNotPresent allora:
- ANPR/AppIO presenta informativa INAD per registrazione al CITTADINO e gli richiede:
- email di contatto
- PEC da eleggere come domicilio digitale
-
ANPR/AppIO notifica ad INAD la richiesta utilizzando la API request_action inoltrando codice fiscale, nome, cognome, email di contatto e PEC ed ottenendo come risposta il request_code assegnato da INAD e il nuovo stato del CITTADINO uguale a inCharge
-
ANPR/AppIO informa il CITTADINO della circostanza
se lo STATE del CITTADINO è digitalDomicileNotPresent allora:
- ANPR/AppIO richiede al CITTADINO:
- PEC da eleggere come domicilio digitale
-
ANPR/AppIO notifica ad INAD la richiesta utilizzando la API request_action inoltrando codice fiscale e PEC ed ottenendo come risposta il request_code assegnato da INAD e il nuovo stato del CITTADINO uguale a inCharge
-
ANPR/AppIO informa il CITTADINO della circostanza
altrimenti:
- ANPR/AppIO informa il CITTADINO della circostanza
Il sequence-diagram sintetizza il presente Use Case.
Il presente use case è di interesse per ANPR e AppIO.
Si assume che ANPR/AppIO abbia dato seguito all'autenticazione del CITTADINO, nel rispetto dell'art. 64 del CAD, e recuperato per lo stesso i seguenti attributi:
- nome, ottenuti dall'autenticazione
- cognome, ottenuti dall'autenticazione
- codice fiscale, ottenuti dall'autenticazione.
Il presente Use Case prevede:
- ANPR/AppIO richiede ad INAD lo stato del CITTADINO utilizzando la API status_check inoltrando il codice fiscale
se lo STATE del CITTADINO è digitalDomicilePresent OR waitingOfficeCancellation allora:
- ANPR/AppIO richiede al CITTADINO:
- PEC da eleggere come domicilio digitale
-
ANPR/AppIO notifica ad INAD la richiesta utilizzando la API request_action inoltrando codice fiscale e PEC ed ottenendo come risposta il request_code assegnato da INAD e il nuovo stato del CITTADINO uguale a inCharge
-
ANPR/AppIO informa il CITTADINO della circostanza
altrimenti:
- ANPR/AppIO informa il CITTADINO della circostanza
Il sequence-diagram sintetizza il presente Use Case.
Il presente use case è di interesse per ANPR e AppIO.
Si assume che ANPR/AppIO abbia dato seguito all'autenticazione del CITTADINO, nel rispetto dell'art. 64 del CAD, e recuperato per lo stesso i seguenti attributi:
- nome, ottenuti dall'autenticazione
- cognome, ottenuti dall'autenticazione
- codice fiscale, ottenuti dall'autenticazione.
Il presente Use Case prevede:
- ANPR/AppIO richiede ad INAD lo stato del CITTADINO utilizzando la API status_check inoltrando il codice fiscale
se lo STATO del CITTADINO è digitalDomicilePresent allora:
-
ANPR/AppIO richiede al CITTADINO la volontà di cessare il proprio domicilio infomando che l'effetto della stessa richiesta avverrà dopo 90gg
-
ANPR/AppIO notifica ad INAD la richiesta utilizzando la API request_action inoltrando codice fiscale ed ottenendo come risposta il request_code assegnato da INAD e il nuovo stato del CITTADINO uguale a inCharge
-
ANPR/AppIO informa il CITTADINO della circostanza
altrimenti:
- ANPR/AppIO informa il CITTADINO della circostanza
Il sequence-diagram sintetizza il presente Use Case.
Il presente use case è di interesse per ANPR e AppIO.
Si assume che sia avvenuto un cambio di stato di un CITTADINO in INAD.
Il seguente state diagram descrive le variazioni di stato gestiti da INAD.
stateDiagram-v2
citizenNotPresent --> digitalDomicileNotPresent: citizenRegistration
digitalDomicileNotPresent --> inCharge: electionRequest
digitalDomicilePresent --> inCharge: changeRequest
digitalDomicilePresent --> waitingVoluntaryCancellation: voluntaryCancellationRequest
inCharge --> verify: startVerification
verify --> confirmationRequestSent: OKVerificationForElection OR OKVerificationForChange
verify --> digitalDomicileNotPresent: KOVerificationForElection
verify --> digitalDomicilePresent: KOVerificationForChange
confirmationRequestSent --> awaitingPublication: electionConfirmed OR changeConfirmed
confirmationRequestSent --> digitalDomicileNotPresent: electionAbolition
confirmationRequestSent --> digitalDomicilePresent: changeAbolition
waitingVoluntaryCancellation --> awaitingPublication: after90dd
awaitingPublication --> digitalDomicilePresent: electionPubblished OR changePubblished
awaitingPublication --> digitalDomicileNotPresent: voluntaryCancellationPubblished OR officeCancellationPubblished
digitalDomicilePresent --> waitingOfficeCancellation: officeCancellation
waitingOfficeCancellation --> awaitingPublication: after30dd
waitingOfficeCancellation --> awaitingPublication: changeRequest
digitalDomicilePresent --> citizenNotPresent: specialCaseCancellation
digitalDomicileNotPresent --> citizenNotPresent: specialCaseCancellation
-
INAD notifica a ANPR/AppIO il cambio di stato utilizzando la API receive_status_change inoltrando il codice fiscale del CITTADINO interessato, request_code assegnato da INAD, il riferimento a INAD, ANPR o AppIO, il nuovo stato del CITTADINO (vedi vertices dello state diagram precedente) e la motivazione che ha determinato il cambio di stato (vedi edges dello state diagram precedente)
-
ANPR/AppIO informa il CITTADINO della circostanza
N.b. INAD non notifica gli effetti della pubblicazione (awaitingPublication - electionPubblished OR changePubblished -> digitalDomicilePresent e awaitingPublication - voluntaryCancellationPubblished OR officeCancellation -> digitalDomicileNotPresent) in quanto gli le evidenze degli stessi sono ottenute da ANPR e AppIO dall'applicazione del UC0011.
Il sequence-diagram sintetizza il presente Use Case.
Il presente use case è di interesse per ANPR e AppIO.
Si assume che ANPR/AppIO abbia dato seguito all'autenticazione del CITTADINO, nel rispetto dell'art. 64 del CAD, e recuperato per lo stesso i seguenti attributi:
- nome, ottenuti dall'autenticazione
- cognome, ottenuti dall'autenticazione
- codice fiscale, ottenuti dall'autenticazione.
Il presente Use Case prevede:
- ANPR/AppIO richiede ad INAD lo stato del CITTADINO utilizzando la API status_check inoltrando il codice fiscale
se lo STATE del CITTADINO è citizenNotPresent allora:
- ANPR/AppIO informa il CITTADINO della circostanza
altrimenti:
- ANPR/AppIO richiede al CITTADINO:
- email di contatto
-
ANPR/AppIO notifica ad INAD la nuova email di contatto utilizzando la API changed_email inoltrando codice fiscale e email di contatto
-
ANPR/AppIO informa il CITTADINO della circostanza
Il sequence-diagram sintetizza il presente Use Case.
Il presente use case è di interesse per ANPR e AppIO.
Si assume che la email di contatto del CITTADINO sia stata modificata.
Il presente Use Case prevede:
-
INAD notifica ad ANPR/AppIO la nuova email di contatto utilizzando la API changed_email inoltrando codice fiscale e email di contatto
-
ANPR/AppIO informa il CITTADINO della circostanza
N.b. INAD assicura la notifica ad ANPR/AppIO sse la richiesta di variazione della email di contatto del CITTADINO non è stata notifica dallo stesso e, per AppIO, se il CITTADINO ha esegueto almeno un'azione di elezione, modifica cancellazione volontaria tramite AppIO o recuperati dalla stessa AppIO su consenso del CITTADINO.
Il sequence-diagram sintetizza il presente Use Case.
Il presente use case è di interesse per ANPR.
Si assume che il CITTADINO sia deceduto e in ANPR è presente il domicilio digitale dello stesso.
Il presente Use Case prevede:
- ANPR notifica ad INAD la il decesso del CITTADINO utilizzando la API death_notification inoltrando il codice fiscale
Il sequence-diagram sintetizza il presente Use Case.
Il presente use case è di interesse per ANPR e AppIO.
Si assume la conclusione del task di pubblicazione realizzato da INAD entro le ore 1.00 di ogni giorno
Il presente Use Case prevede:
- INAD notifica ad ANPR/AppIO le variazioni dei domicili digitali pubblicati utilizzando la API receive_changed_digital_addresses inoltrando la data di riferimento e l'elenco dei domicili variati (insert, update, deleted)
N.b. INAD assicura inoltro anche in assenza di variazioni
se la notifica ha buon esito
- INAD elimina l'elenco delle variazioni
se la notifica non ha buon esito
-
INAD conserva l'elenco delle variazioni relativamente all'attuale giorno
-
ANPR/AppIO recuperano l'elenco delle variazioni utilizzando la API recovers_changed_digital_addresses (dopo le 2.00 di ogni giorno) per il giorno di interesse
N.b. INAD assicura:
-
l'inoltro ad AppIO dei soli domicili digitali per cui il CITTADINO ha esegueto almeno un'azione di elezione, modifica cancellazione volontaria tramite AppIO o recuperati dalla stessa AppIO su consenso del CITTADINO
-
la disponibilità dell'elenco delle variazioni per 5gg superato il quale ANPR/AppIO applicano UC012.
-
la notifica di una insert o update del domicilio digitale di un CITTADINO comporta l'implicita variazione di stato a digitalDomicilePresent
-
la notifica di una deleted del domicilio digitale di un CITTADINO comporta l'implicita variazione di stato a digitalDomicileNotPresent
Il sequence-diagram sintetizza il presente Use Case.
Il presente use case è di interesse per ANPR
Si assume che ANPR abbia l'esigenza di effettuare il setting dei domicili digitali.
Il presente Use Case prevede:
- ANPR recuperano l'elenco dei domicili digitali eletti utilizzando la API sync_digital_addresses ottenendo l'elenco dei domicili digitali
Il sequence-diagram sintetizza il presente Use Case.
Il presente use case è di interesse per AppIO.
Si assume che AppIO abbia dato seguito all'autenticazione del CITTADINO, nel rispetto dell'art. 64 del CAD, e recuperato per lo stesso i seguenti attributi:
- nome, ottenuti dall'autenticazione
- cognome, ottenuti dall'autenticazione
- codice fiscale, ottenuti dall'autenticazione.
Il presente Use Case prevede:
- AppIO richiede ad INAD lo stato del CITTADINO utilizzando la API status_check inoltrando il codice fiscale
se lo STATE del CITTADINO è digitalDomicilePresent allora:
-
AppIO richiede consenso del CITTADINO per recuperare il proprio domicilio digitale
-
AppIO recupera il domicilio digitale del cittadino utilizzando la API digital_address inoltrando il codice fiscale del cittadino
-
AppIO informa il CITTADINO della circostanza
altrimenti:
- AppIO informa il CITTADINO della circostanza
Il sequence-diagram sintetizza il presente Use Case.
Il presente use case è di interesse per AppIO.
Si assume che un cittadino abbia rinunciato all'utilizzo dell'AppIO.
Il presente Use Case prevede:
- AppIO richiede ad INAD lo stato del CITTADINO utilizzando la API status_check inoltrando il codice fiscale
se lo STATE del CITTADINO è citizenNotPresent allora:
- AppIO informa il CITTADINO della circostanza
altrimenti:
- AppIO notifica la rinuncia del CITTADINO utilizzando appIO_abandonment inoltrando il codice fiscale
Il sequence-diagram sintetizza il presente Use Case.
citizen_status
string
enum
- citizenNotPresent
- digitalDomicileNotPresent
- inCharge
- verify
- confirmationRequestSent
- awaitingPublication
- waitingVoluntaryCancellation
- waitingOfficeCancellation
- digitalDomicilePresent
citizen_change_status_reason
string
enum
- citizenRegistration
- electionRequest
- changeRequest
- voluntaryCancellationRequest
- startVerification
- OKVerificationForElection
- OKVerificationForChange
- KOVerificationForElection
- KOVerificationForChange
- electionConfirmed
- changeConfirmed
- after90dd
- electionAbolition
- changeAbolition
- electionPubblished
- changePubblished
- voluntaryCancellationPubblished
- officeCancellationPubblished
- officeCancellation
- after30dd
- specialCaseCancellation
operation
string
enum
- registration&insert
- insert
- update
- delete
codice_fiscale
string
pattern = /^(?:[A-Z][AEIOU][AEIOUX]|[B-DF-HJ-NP-TV-Z]{2}[A-Z]){2}(?:[\dLMNP-V]{2}(?:A-EHLMPR-T|[DHPS][37PT][0L]|[ACELMRT][37PT][01LM]|[AC-EHLMPR-T][26NS][9V])|(?:[02468LNQSU][048LQU]|[13579MPRTV][26NS])B[26NS][9V])(?:[A-MZ][1-9MNP-V][\dLMNP-V]{2}|[A-M]0L)[A-Z]$/i
name
string
surname
string
string
pattern = ^([a-zA-Z0-9_-.]+)@([a-zA-Z0-9_-.]+).([a-zA-Z]{2,5})$
email_contatto
digital_address
request_code
string
pattern = (ANPR|APPIO)_
list_changed_digital_address
object
- codice_fiscale
- digital_address
- action = (insert|update|delete)
list_digital_address
object
- codice_fiscale
- digital_address
required for UC001, UC002, UC004, UC008, UC013, UC014
citizen_status:status_check (codice_fiscale)
required for UC001
citizen_status=inCharge, request_code :request_action(operation=registration&insert,name, surname, codice_fiscale, email_contatto, digital_address)
required for UC001
citizen_status=inCharge, request_code :request_action(operation=insert,codice_fiscale, digital_address)
required for UC002
citizen_status=inCharge, request_code :request_action(operation=update,codice_fiscale, digital_address)
required for UC004
citizen_status=inCharge, request_code :request_action(operation=delete,codice_fiscale)
required for UC008
ack=changed_email(codice_fiscale,email_contatto)
required for UC010
ack=death_notification(codice_fiscale)
required for UC011
list_changed_digital_address=recovers_changed_digital_addresses(day)
required for UC012
list_digital_address=sync_digital_addresses()
required for UC001, UC002, UC004, UC008, UC013, UC014
citizen_status:status_check (codice_fiscale)
required for UC001
citizen_status=inCharge, request_code :request_action(operation=registration&insert,name, surname, codice_fiscale, email_contatto, digital_address)
required for UC001
citizen_status=inCharge, request_code :request_action(operation=insert,codice_fiscale, digital_address)
required for UC002
citizen_status=inCharge, request_code :request_action(operation=update,codice_fiscale, digital_address)
required for UC004
citizen_status=inCharge, request_code :request_action(operation=delete,codice_fiscale)
required for UC008
ack=changed_email(codice_fiscale,email_contatto)
required for UC011
list_changed_digital_address=recovers_changed_digital_addresses(day)
required for UC013
digital_address=digital_address(codice_fiscale)
required for UC014
ack=appIO_abandonment(codice_fiscale)
required for UC007
ack=receive_status_change(codice_fiscale, request_code, citizen_status, citizen_change_status_reason)
required for UC009
ack=receive_changed_email(codice_fiscale,email_contatto)
required for UC011
ack=receive_changed_digital_addresses(list_changed_digital_address)