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/ |
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 .