3.10 Comunicazione consensi

Il protocollo di comunicazione per la comunicazione dei consensi prevede che il sistema richiedente fruisca del servizio disponibile presso il National Gateway offerto dall’INI, indicando il codice fiscale dell’assistito e la lista dei consensi caratterizzata dalla tipologia dei consensi e dai relativi valori. La lista di consensi deve contenere sempre: i) il valore del consenso all’alimentazione (anche se non viene modificato); ii) il valore del consenso alla consultazione (anche se non viene modificato). Il valore del consenso al pregresso è opzionale. 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, letta l’informativa e espressi i consensi, comunica al sistema regionale i nuovi valori dei consensi. Il sistema regionale provvederà all’invio verso l’INI del messaggio di richiesta comunicazione consensi. L’INI ricevuta la richiesta, provvederà all’aggiornamento dei consensi espressi dall’assistito.

Messaggio di richiesta Comunicazione dei 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, il valore deve essere: 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

Possibili valori: UPDATE

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

 

Identificativo genitore/tutore

specifico per messaggio

Formato codifica  conforme alla specifiche IHE (ITI TF-3)

Codifice Fiscale del richiedente (tutore-genitore oppure assistito)

si

 

Lista di consensi

specifico per messaggio

Vedi tabella Tabella 4.1-1del documento Affinity Domain

specificano i consensi forniti o revocati.

si

 

Identificativo informativa

specifico per messaggio

Identificativo della informativa, [Codifica della regione^numerico sequenziale]

Rappresenta l’identificativo della informativa fornita al paziente (genitore o tutore) per la sottomissione o revoca dei consensi

si

 

Identificativo utente

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Codice Fiscale dell’utente che fa richiesta del servizio di interoperabilità

si

 

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

 

Messaggio di risposta Comunicazione 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

Obbligatorio

Stato risposta

specifico per messaggio

“Success”

Successo/
Fallimento

si

Regione di assistenza

specifico per messaggio

Codifica secondo la  Tabella 5.4-3 del documento di Affinity Domain

Indica la regione di assistenza del paziente

si

 

Messaggio di risposta Comunicazione dei consensi con fallimento (flussi INI->RDE, INI->RDA)

Il messaggio di risposta di errore è generato dall’INI e specifica il tipo di fallimento che si è verificato. Possibili errori sono: i) l’identificativo dell’assistito non è stato correttamente validato mediante l’interazione con l’ANA; ii) il ruolo dell’utente non ha il diritto di modificare il consenso dell’assistito.
 

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 A9, sono riportati i messaggi di richiesta e risposta del servizio.

Fallimento servizio

Codici di errore

RegisterConsentSetResponse/Status
 

Elemento

Tipo di dato

Valore

Status

String

Failure


RegisterConsentSetResponse/Error

Attributo

Tipo di dato

Valore

codeContext

String

Vedi tabella messaggi di errore

errorCode

String

[ERROR_CODE]


RegisterConsentSetResponse/Error

[ERROR_CODE]

Descrizione

RegisterConsentSetError

Errore nella registrazione 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