3.2 Recupero documento e notifica recupero documento

Il protocollo di comunicazione da utilizzare per il servizio di recupero documento deve essere conforme alla transazione IHE [ITI-43] Retieve Document Set[1], che, secondo la terminologia IHE, prevede l’invio di una richiesta di recupero documenti da un XDS Document Consumer (in questo caso il nodo regionale della RDE) ad un attore XDS Document Repository (in questo caso il nodo regionale della RCD), in maniera mediata dall’attore National Gateway. Pertanto, l’attore XDS Document Consumer effettua una richiesta al National Gateway che si occupa di inoltrare il messaggio all’attore XDS Document Repository. 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 di recupero documento. Nel caso in cui il recupero è effettuato da una regione diversa dalla RDA, allora il National Gateway invia un messaggio di notifica di avvenuto recupero documento all’attore Audit Repository della RDA secondo un protocollo opportunamente definito.

Il National Gateway verifica inoltre che la richiesta di recupero documento pervenga unicamente a fronte di una richiesta di ricerca documenti ricevuta in un intervallo temporale di non oltre 20 minuti prima della richiesta di recupero e l’identificativo del documento presente nella richiesta di recupero, effettuata dal professionista, deve essere presente nella risposta alla ricerca documenti fornita allo stesso professionista (la risposta alla query è preparata dalla RDA che applica le politiche di accesso ai documenti ricercati).

Messaggio di richiesta Recupero documento (flussi RDE->INI, RDA->INI, INI->RCD)
 

Campo

Tipologia

Codifica

Descrizione

Obbligatorietà

Dato SAML/XDS (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 codifica contesto operativo, Tabella 5.4-2 nel documento Affinity Domain

Contesto operativo della richiesta

si

urn:oasis:names:tc:xspa:1.0:subject:purposeofuse

Tipo documento

asserzione attributo

Codifica LOINC

Tipo di documento da richiedere

no

urn:oasis:names:tc:xspa:1.0:resource:hl7:type

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

Possibili valori: true/false

Indica la presa in carico del paziente

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

Elenco Identificativi

assistito

asserzione di identificazione

 

Lista dei codici fiscali  ssociati all’assistito, di cui uno è quello valido

si (solo per il flusso INIàRCD e per assistiti con più codici fiscali)

 

Identificativo organizzazione

specifico per messaggio

Codifica OID nazionale delle regioni/province autonome, come specificato al paragrafo 2.9 del documento di Affinity Domanin.

Identificativo dominio regionale/provincia autonoma che svolge il ruolo di RDA

no

HomeCommunityId

Identificativo repository

specifico per messaggio

Codificato con OID, come specificato al paragrafo 2.14 del documento Affinity Domain

Identificativo del repository che custodisce il documento

si

RepositoryUniqueId

Identificativo documento

specifico per messaggio

Codificato con OID

Identificativo del documento da recuperare

si

UniqueId


 

Messaggio di risposta Recupero documento con successo (flussi RCD->INI, INI->RDE, INI->RDA)

 

Campo

Tipologia

Codifica

Descrizione

Obbligatorietà

Dato XDS (ove applicabile)

Stato risposta

specifico per messaggio

Come da specifiche IHE

Successo/Fallimento

si

RegistryResponse.status

Documento

specifico per messaggio

Base64 (può essere trasmesso anche attraverso MTOM/XOP)

Rappresenta il documento in formato binario da trasferire

si

Document

Tipo MIME

specifico per messaggio

Da Affinity Domain, Tabella 2.10-1

Indica il mime type del documento

si

XDSDocumentEntry.mimeType

Identificativo organizzazione

specifico per messaggio

Codifica OID nazionale delle regioni/province autonome italiane, come specificato al paragrafo 2.9 del documento di Affinity Domanin

Identificativo dominio regionale/provincia autonoma della RDA

no

XDSDocumentEntry.homeCommunityId (ITI TF:3 4.2.3.2.12)

Codice repository

specifico per messaggio

Codificato con OID, come specificato al paragrafo 2.14 del documento Affinity Domain

Identificativo del repository che custodisce il documento

si

XDSDocumentEntry.repositoryUniqueId (ITI TF:3 4.2.3.2.18)

Identificativo documento

specifico per messaggio

Codificato con OID, come specificato al paragrafo 2.19 del documento Affinity Domain

Identificativo del documento

si

XDSDocumentEntry.uniqueId (ITI TF:3 4.2.3.2.26)

 

Messaggio di risposta Recupero documento con fallimento (flussi RCD->INI, INI->RDA, INI->RDE)

Il messaggio di risposta, in caso di errore, può essere:
 

  • generato dalla RCD, per il flusso di comunicazione tra la RCD e l’INI a seguito di messaggio di richiesta della RDE (ovvero RDA) inoltrato dall’INI, per segnalare l’assenza di diritti di accesso o altri errori; il messaggio è inoltrato dall’INI alla RDE (ovvero RDA);
  • generato dall’INI, per il flusso di comunicazione tra la l’INI e la RDE o la RDA, per segnalare l’assenza di consenso alla consultazione dell’assistito o altri errori.

 

Campo

Tipologia

Codifica

Descrizione

Obbligatorio

Stato risposta

specifico per messaggio

Come da specifiche IHE

Successo/
Fallimento

si

Codice errore

specifico per messaggio

Come da specifiche IHE

Vedi tabella codici errore

si


 

Messaggio di richiesta Notifica recupero documento (flusso INI->RDA)
 

Campo

Tipologia

Codifica

Descrizione

Obbligatorietà

Dato SAML/XDS (ove applicabile)

Identificativo organizzazione

specifico per messaggio

Codifica OID nazionale delle regioni/province autonome italiane, come specificato al paragrafo 2.9 del documento di Affinity Domanin

Identificativo dominio regionale/provincia autonoma della RDA

no

XDSDocumentEntry.homeCommunityId (ITI TF:3 4.2.3.2.12)

Codice repository

specifico per messaggio

Codificato con OID, come specificato al paragrafo 2.14 del documento Affinity Domain

Identificativo del repository che custodisce il documento

si

XDSDocumentEntry.repositoryUniqueId (ITI TF:3 4.2.3.2.18)

Identificativo documento

specifico per messaggio

Codificato con OID, come specificato al paragrafo 2.19 del documento Affinity Domain

Identificativo del documento

si

XDSDocumentEntry.uniqueId (ITI TF:3 4.2.3.2.26)

Identificativo organizzazione

specifico per messaggio

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

specifico per messaggio

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

 

Identificativo assistito

specifico per messaggio

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

Codice Fiscale dell’assistito cui si riferisce la richiesta

si

 

Ruolo utente

specifico per messaggio

Vedi Tabella 5.4-1 del documento di Affinity Domain per la codifica ruoli

Ruolo dell’utente che effettua la richiesta

si

 

Contesto operativo richiesta

specifico per messaggio

Vedi tabella codifica contesto operativo

Contesto operativo della richiesta

si

 

Tipo documento

specifico per messaggio

Codifica LOINC

Tipo di documento da richiedere

no

 

 

Messaggio di risposta Notifica recupero documento (flusso RDA->INI)

Il messaggio di risposta, sia in caso di successo che in caso di errore è strutturato nel seguente modo.
 

Campo

Tipologia

Codifica

Descrizione

Obbligatorio

Stato risposta

specifico per messaggio

“Success” oppure “Failure”

Successo/
Fallimento

si

Codice errore

specifico per messaggio

Codifica interna

Vedi tabella codici errore

Solo se lo stato della risposta è fallimento.

 

A titolo esemplificativo, nelle appendici A2 e A3, sono riportati i messaggi di richiesta e risposta dei servizi di recupero e di notifica. Per maggiori dettagli si rimanda alle specifiche tecniche ufficiali IHE.

Fallimento / parziale successo servizio

Codici di errore

RetrieveDocumentSetResponse/RegistryResponse/RegistryErrorList/RegistryError
 

Attributo

Tipo di dato

Valore

codeContext

String

Vedi tabella messaggi di errore

errorCode

String

[ERROR_CODE]

location

String

Indica la posizione dell’errore verificatosi

severity

String

urn:oasis:names:tc:ebxml-regrep:ErrorSeverityType:Error

 

RetrieveDocumentSetResponse/RegistryResponse/RegistryErrorList/RegistryError.errorCode
 

[ERROR_CODE]

Descrizione

XDSRepositoryBusy

Carico di lavoro eccessivo

XDSRepositoryError

Errore interno: specificare solo se non sono disponibili codici più dettagliati

XDSRepositoryOutOfResources

Poche risorse

XDSUnknownCommunity

Id del dominio regionale non riconosciuto

 

NotifyRetrieveResponse/Error
 

[ERROR_CODE]

Descrizione

NotifyError

Errore nella registrazione della notifica

 

 

[1] IHE ITI TF-2b 3.43

Ultimo aggiornamento: 06/02/2018