Il protocollo di comunicazione per la richiesta dello stato dei consensi prevede che il sistema richiedente fruisca del servizio disponibile presso il National Gateway offerto dall’INI, indicando il codice fiscale dell’assistito per il quale si intende richiedere lo stato dei consensi. La richiesta da inviare al National Gateway deve contenere l’asserzione di attributo firmata dal sistema regionale richiedente. Di seguito si riporta il dataset della richiesta e della risposta del messaggio.
Il messaggio di richiesta è inviato all’INI quando un assistito si rivolge ad un sistema regionale per l’aggiornamento dei propri consensi. La prima operazione che il sistema regionale deve effettuare è la richiesta dello stato dei consensi dell’assistito, al fine di conoscere lo stato attuale dei consensi che eventualmente saranno aggiornati. L’INI ricevuta la richiesta, provvede all’invio dello stato dei consensi e dei riferimenti alle informative utili per fornire/revocare i consensi da parte dell’assistito (l’informativa eventualmente utilizzata nel momento in cui l’assistito ha espresso i consensi e l’ultima versione dell’informativa).
Messaggio di richiesta Richiesta stato consensi (flussi RDE->INI, RDA->INI)
|
Campo |
Tipologia |
Codifica |
Descrizione |
Obbligatorietà |
Dato SAML (ove applicabile) |
|---|---|---|---|---|---|
|
Identificativo utente |
asserzione attributo |
Formato codifica conforme alla specifiche IHE (ITI TF-3) |
Codice Fiscale dell’utente che fa richiesta del servizio di interoperabilità |
si |
urn:oasis:names:tc:xacml:1.0:subject:subject-id |
|
Identificativo organizzazione |
asserzione attributo |
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 |
|
Descrizione organizzazione |
asserzione attributo |
Descrizione delle regioni/province autonome italiane |
Descrizione del dominio dell’utente |
no |
urn:oasis:names:tc:xspa:1.0:subject:organization |
|
Struttura utente |
asserzione attributo |
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/professionista sanitario (nel caso in cui l’utente coincida con il paziente non deve essere valorizzato) |
si |
urn:oasis:names:tc:xspa:1.0:environment:locality |
|
Ruolo utente |
asserzione attributo |
Vedi Tabella 5.4-1 del documento di Affinity Domain per la codifica ruoli |
Ruolo dell’utente che effettua la richiesta |
si |
urn:oasis:names:tc:xacml:2.0:subject:role |
|
Contesto operativo richiesta |
asserzione attributo |
Vedi tabella 5.4-2 del documento di Affinity Domain Valore: CONSENT |
Contesto operativo della richiesta |
si |
urn:oasis:names:tc:xspa:1.0:subject:purposeofuse |
|
Identificativo assistito/genitore-tutore |
asserzione attributo |
Formato codifica conforme alla specifiche IHE (ITI TF-3) |
Codice Fiscale dell’assistito cui si riferisce la richiesta o del genitore/tutore che ha richiesto l’operazione |
si |
urn:oasis:names:tc:xacml:1.0:resource:resource-id |
|
Presa in carico |
asserzione attributo |
Valore: true |
Indica la volontà del paziente ad aggiornare/conoscere i consensi forniti |
si |
urn:oasis:names:tc:xspa:1.0:resource:patient:consent |
|
Tipo Attività |
asserzione attributo |
Valore: READ |
Descrive il tipo di attività: CREATE, READ, UPDATE, DELETE. |
si |
urn:oasis:names:tc:xacml:1.0:action:action-id |
|
Identificativo assistito |
specifico per messaggio |
Formato codifica conforme alla specifiche IHE (ITI TF-3) |
Codice Fiscale dell’assistito cui si riferisce la richiesta |
si |
|
Messaggio di risposta Richiesta stato dei consensi con successo (flussi INI->RDE, INI->RDA)
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 assistito |
specifico per messaggio |
Formato codifica conforme alla specifiche IHE (ITI TF-3) |
Codice Fiscale dell’assistito cui si riferisce la richiesta |
si |
|
Lista di consensi |
specifico per messaggio |
Vedi tabella Tabella 4.1-1del documento Affinity Domain |
Indica i valori dei consensi. Il valore è true se è stato fornito, false se non è stato mai fornito, ovvero revocato. |
si |
|
Identificativo informativa dei consensi a cui fanno riferimento i consensi espressi dall’assistito |
specifico per messaggio |
Identificativo della informativa sottomessa, codifica come specificato al paragrafo 4.4 del documento di Affinity Domain |
Specifica l’identificativo dell’informativa e modulistica registrata presso INI, l’identificativo è costruito sulla base del codice che identificano la regione e il numero della versione. |
si, se presente |
|
Identificativo informativa corrente |
specifico per messaggio |
Identificativo della informativa corrente, codificata come specificato al paragrafo 4.4 del documento di Affinity Domain [Codifica della regione^numerico sequenziale oppure Codifica della regione^last] |
Specifica l’identificativo dell’informativa e modulistica registrata presso INI, l’identificativo è costruito sulla base del codice che identificano la regione e il numero della versione |
si, se presente |
Messaggio di risposta Richiesta stato dei consensi con fallimento (flussi INI->RDE, INI->RDA)
Il messaggio di risposta di errore è generato dall’INI nel caso in cui l’assistito non è correttamente validato tramite interazione con ANA o nel caso in cui il richiedente non ha il diritto di accesso.
|
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 A8, sono riportati i messaggi di richiesta e risposta del servizio.
Fallimento servizio
Codici di errore
ConsentQueryResponse/Status
|
Elemento |
Tipo di dato |
Valore |
|---|---|---|
|
Status |
String |
Failure |
ConsentQueryResponse/Error
|
Attributo |
Tipo di dato |
Valore |
|---|---|---|
|
codeContext |
String |
Vedi tabella messaggi di errore |
|
errorCode |
String |
[ERROR_CODE] |
ConsentQueryResponse/Error
|
[ERROR_CODE] |
Descrizione |
|---|---|
|
QueryError |
Errore nella richiesta stato consensi |
Gestione errori di verifica delle asserzioni
Gli errori generati da eventuali fallimenti di controllo sulle asserzioni sono descritti nel capitolo 4.