Il protocollo di comunicazione per la richiesta di comunicazione dell’informativa e della modulistica prevede che il sistema richiedente fruisca del servizio disponibile presso il National Gateway offerto dall’INI, indicando la regione alla quale fa riferimento l’informativa. La richiesta da inviare al National Gateway deve contenere l’asserzione di informativa firmata dal sistema regionale richiedente e i documenti in formato Base64 relativi all’informativa e ai moduli per l’acquisizione dei consensi e delle revoche.
Il messaggio di richiesta è inviato all’INI quando una regione ha necessità di aggiornare la propria informativa regionale e/o i moduli di acquisizione dei consensi e revoche. L’INI provvederà alla memorizzazione e gestione di tali documenti.
Messaggio di richiesta Comunicazione della informativa e della modulistica (flusso regione->INI)
|
Campo |
Tipologia |
Codifica |
Descrizione |
Obbligatorietà |
Dato SAML (ove applicabile) |
|---|---|---|---|---|---|
|
Identificativo utente |
asserzione di informativa |
Formato codifica conforme alla specifiche IHE (ITI TF-3) |
Codice Fiscale dell’utente che fa richiesta di comunicazione informativa |
si |
urn:oasis:names:tc:xacml:1.0:subject:subject-id |
|
Identificativo organizzazione |
asserzione di informativa |
Codifica secondo la Tabella 5.4-3 del documento di Affinity Domain |
Identificativo del dominio dell’utente |
si |
urn:oasis:names:tc:xspa:1.0:subject:organization-id |
|
Struttura utente |
asserzione di informativa |
Codifica HSP.11 - HSP.11bis - STS.11 - RIA.11, ovvero codifica ISTAT della Azienda (ASL) o codifica Tabella 5.4-3 del documento di Affinity Domain |
Identificativo della struttura dell’operatore informativa |
si |
urn:oasis:names:tc:xspa:1.0:environment:locality |
|
Ruolo utente |
asserzione di informativa |
Vedi Tabella 5.4-1 del documento di Affinity Domain per la codifica ruoli. Il ruolo per questa operazione deve essere OPI (Operatore di Informativa) |
Ruolo dell’utente che effettua la richiesta |
si |
urn:oasis:names:tc:xacml:2.0:subject:role |
|
Tipo Attività |
asserzione di informativa |
Valore: CREATE |
Descrive il tipo di attività |
si |
urn:oasis:names:tc:xacml:1.0:action:action-id |
|
Identificativo regione |
specifico per messaggio |
Codifica secondo la Tabella 5.4-3 del documento di Affinity Domain |
Identificativo del dominio per il quale si vuole sottomettere informativa e modulistica |
si |
|
|
Informativa dei consensi |
specifico per messaggio |
Base64 (può essere trasmesso anche attraverso MTOM/XOP). Questo elemento nel messaggio SOAP contiene due sottoelementi: i) “MimeType”, che indica il formato del documento inviato; ii) “DocumentType”, che indica il tipo del documento |
Rappresenta l’informativa regionale per i consensi |
si |
|
|
Modulo di acquisizione consensi e revoche |
specifico per messaggio |
Base64 (può essere trasmesso anche attraverso MTOM/XOP). Questo elemento nel messaggio SOAP contiene due sottoelementi: i) “MimeType”, che indica il formato del documento inviato; ii) “DocumentType”, che indica il tipo del documento |
Rappresenta il modulo di acquisizione consensi e revoche. |
si |
|
Messaggio di risposta Comunicazione della informativa e della modulistica con successo (flusso INI->regione)
Il messaggio di risposta, in caso di successo, è strutturato come indicato nella tabella successiva.
|
Campo |
Tipologia |
Codifica |
Descrizione |
Obbligatorietà |
|---|---|---|---|---|
|
Stato risposta |
specifico per messaggio |
“Success” |
Successo |
si |
|
Identificativo regione |
specifico per messaggio |
Codifica secondo la Tabella 5.4-3 del documento di Affinity Domain |
Identificativo del dominio per il quale si è sottomessa l’ informativa e la modulistica |
si |
|
Identificativo informativa sottomessa |
specifico per messaggio |
Identificativo della informativa sottomessa, come specificato al paragrafo 4.4 del documento di Affinity Domain |
Specifica l’indentificativoo dell’informativa e modulistica registrata presso INI, l’identificativo è costruito sulla base del codice che identificano la regione e il numero della versione |
si |
Messaggio di risposta Comunicazione della informativa e della modulistica con fallimento
Il messaggio di risposta di errore è generato dall’INI nel caso in cui l’operatore non è autorizzato a sottomettere la richiesta o nel caso in cui la regione a cui è associata l’informativa e la modulistica non è compatibile con la regione dell’operatore.
|
Campo |
Tipologia |
Codifica |
Descrizione |
Obbligatorio |
|---|---|---|---|---|
|
Stato risposta |
specifico per messaggio |
“Failure” |
Fallimento |
si |
|
Codice errore |
specifico per messaggio |
Codifica interna |
Vedi tabella codici errore |
si |
A titolo esemplificativo, in appendice A11, sono riportati i messaggi di richiesta e risposta del servizio.