3.9 Richiesta stato consensi

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.

Ultimo aggiornamento: 06/02/2018