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