FSE Componente Locale Specifica del servizio di recupero documento nel dipartimentale/repository dell'Azienda
←
→
Trascrizione del contenuto della pagina
Se il tuo browser non visualizza correttamente la pagina, ti preghiamo di leggere il contenuto della pagina quaggiù
FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
FSE
Componente Locale
Specifica del servizio di recupero documento nel
dipartimentale/repository dell’Azienda
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 1 di 15
FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
STATO DELLE VARIAZIONI
VERSIONE PARAGRAFO O DESCRIZIONE DELLA VARIAZIONE
PAGINA
V1 Tutto il documento Versione iniziale del documento
V2 Tutto il documento Verifica e piccole correzioni per emissione ai fini dell’autocertificazione
V3 Tutto il documento Introdotti i nuovi parametri di colloquio per l’integrazione con
l’infrastruttura nazionale (INI) e i relativi controlli.
Specificati i requisiti di sicurezza richiesti
V 3.1 Par. 2.3.1.3 Rettifica valori ammessi per campo elencoCFAssistito.CFAssistito.attivo
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 2 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
Indice generale
1. Introduzione 4
1.1 Scopo del documento 4
1.2 Riferimenti 4
1.3 Adeguamento per integrazione con l’infrastruttura nazionale (INI) 5
2. Servizio : FSERetrievalDocumentService2 6
2.1 Obiettivi 6
2.1.1 Scopo del servizio 6
2.1.2 Fruitori 6
2.2 Modalità di richiamo 6
2.3 Descrizione dell’interfaccia del servizio 6
2.3.1 Operazione: GetDocumento2 6
2.3.1.1 Descrizione dell’operazione 7
2.3.1.2 Dettaglio passi Operazione 8
2.3.1.3 Interfaccia di INPUT 9
2.3.1.4 Interfaccia di OUTPUT 14
3. Codici di errore restituiti 15
4. Requisiti di sicurezza 15
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 3 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
1. Introduzione
1.1 Scopo del documento
Lo scopo del documento è fornire le specifiche dei requisiti di dettaglio che descrivono il funzionamento atteso, le
caratteristiche e le modalità di utilizzo, del servizio di recupero documento nel dipartimentale/repository
dell’Azienda, che le aziende devono mettere a disposizione del sistema di interoperabilità della Regione Piemonte
su cui si basano i servizi di
Fascicolo Sanitario Elettonico (FSE)
Ritiro Referti online (ROL)
Conservazione Legale Sostitutiva (CLS)
per il reperimento dei documenti indicizzati sulla componente locale (CL comprensiva di ILEC – indice locale degli
eventi clinici).
Le specifiche dei Web Service sono state estese al fine di gestire i metadati richiesti per garantire l’interoperabilità
nazionale con la componente INI (Infrastruttura Nazionale per l’Interoperabilità) realizzata dal Ministero
dell’Economia e delle Finanze secondo quanto previsto dal comma 15-ter, articolo 12 del decreto legge 18 ottobre
2012 n.179 e successive modifiche.
1.2 Riferimenti
[SRS_HL7]
DMA-CL-SRS-11-V01-Specifica_protocollo_interoperabilita_CL_dip_con e senza invio referti -HL7.pdf, o
versioni successive
[SRS_XML]
DMA-CL-SRS-15-V21-Specifica_protocollo_interoperabilita_CL_dip_con e senza invio referti-XML, o
versioni successive
[FRAMEWORK]
Specifiche tecniche per l’interoperabilità tra i sistemi regionali di FSE Framework e dataset dei servizi
base, Versione 2.1, 30 novembre 2017
[AFFINITY DOMAIN]
Specifiche tecniche per l’interoperabilità tra i sistemi regionali di FSE Affinity Domain Italia, Versione 2.1,
30 novembre 2017
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 4 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
1.3 Adeguamento per integrazione con l’infrastruttura nazionale (INI)
Le Aziende che sono dotate di un repository e non inviano il documento al Fascicolo Sanitario del Piemonte devono
implementare il nuovo servizio FSERetrievalDocumentService2. Tale servizio è stato esteso al fine di gestire i
metadati richiesti per garantire l’interoperabilità nazionale con la componente INI (Infrastruttura Nazionale per
l’Interoperabilità) e le relative codifiche.
In conformità alle specifiche previste dal documento [FRAMEWORK] per il servizio “Recupero documento” a
livello nazionale, il nuovo servizio FSERetrievalDocumentService2 prevede la richiesta e la restituzione di un solo
documento.
Il documento deve essere restituito dal servizio nel formato (pdf oppure pdf con CDA iniettato secondo le specifiche
previste) e con le regole di firma, conformi ai metadati inviati in fase di alimentazione al Fascicolo della Regione
Piemonte.
Esempio 1: se è stato inviato un referto firmato in formato pdf con CDA iniettato, il servizio deve restituire un
referto firmato in formato pdf con CDA iniettato.
Esempio 2: se è stato inviato l’atto operatorio non firmato in formato pdf, il servizio deve restituire l’atto operatorio
non firmato in formato pdf.
Il presente documento descrive le logiche, le regole e le codifiche previste dal nuovo servizio.
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 5 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
2. Servizio : FSERetrievalDocumentService2
2.1 Obiettivi
2.1.1 Scopo del servizio
Il servizio consente alla componente locale (CL) del sistema di interoperabilità della Regione Piemonte su cui si
basano i servizi di FSE, ROL e CLS per recuperare un documento legato ad un episodio clinico di un paziente
presente nel sistema dipartimentale o nel repository dell’Azienda.
2.1.2 Fruitori
Il fruitore del servizio è la CL dedicata all’Azienda.
2.2 Modalità di richiamo
Il servizio viene richiamato con modalità sincrona.
Figura 1-Richiesta puntuale documenti all'Azienda.
Il sistema dell’Azienda Sanitaria recupera il documento in base al codice paziente, codice episodio (opzionale) e
identificativo documento. E’ inviato anche il riferimento allo specifico repository in cui risiede il documento, se
precedentemente fornito dall’Azienda in fase di alimentazione del FSE. L’Identificativo del repository se presente è
codificato secondo le regole definite nei documenti [SRS_HL7] e [SRS_XML].
2.3 Descrizione dell’interfaccia del servizio
2.3.1 Operazione: GetDocumento2
Recupero del documento/i dal sistema dipartimentale o dal repository dell’Azienda.
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 6 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
2.3.1.1 Descrizione dell’operazione
Il servizio restituisce un documento per un paziente.
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 7 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
2.3.1.2 Dettaglio passi Operazione
Criteri di validazione della richiesta
Viene verificato il codice fiscale inviato in input , se non è presente sul Dipartimentale viene restituito un errore.
Vengono verificati i dati relativi al/i documento richiesto: l’identificativo del documento, dell’episodio e la firma
digitale.
Comportamento richiesto
1) Verifica parametri della richiesta
Il servizio controlla se i dati codificati della richiesta sono valorizzati e in caso affermativo verifica che
appartengono a quelli previsti nelle relative tabelle di decodifica. In caso di anomalia occorre restituire un errore
(vedi par. 3).
2) Verifica presenza del paziente in anagrafica
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 8 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
Il servizio verifica se il paziente è presente nell'anagrafica attraverso il codicePaziententeDipartimentale o l'IdAura
se presenti, oppure attraverso il codice fiscale.
Tale verifica serve a individuare l'anagrafe oggetto della richiesta.
Qualora il paziente non sia presente, verrà restituito un errore alla CL (vedi par. 3).
3) Verifica presenza documento
Il servizio verifica se il codice dell’episodio Dipartimentale (se valorizzato) e il codice documento Dipartimentale
corrispondono a quelli presenti sul Dipartimentale.
Se il codice dell’episodio è valorizzato e non esiste per quel paziente, deve essere restituito un errore (vedi par. 3).
Se il codice del documento non esiste per quel paziente deve essere restituito un errore (vedi par. 3).
In entrambi i casi il documento non viene restituito dal servizio.
4) Estrazione documento
E' un'operazione di estrazione dei dati.
Il servizio estrae, per poterlo restituire alla CL, il documento.
5) Composizione risposta
Il sistema restituisce il documento richiesto.
Se si è verificato un errore/warning, il sistema deve restituirlo (vedi par. 3).
2.3.1.3 Interfaccia di INPUT
Informazione di input Obblig Note
atorio
Dati richiedente (CL) una occorenza
Applicazione richiedente Sì Tipo: string
Lunghezza: 16
Valori possibili:
WEBAPP_DMA→ Richiesta proveniente dalla web
application di consultazione degli operatori sanitari o del
cittadino
WEBAPP_CM → Richiesta proveniente dalla web
application di consultazione del cittadino o dell’operatore
per lo scarico dei referti
INI → la richiesta che proviene dall’infrastruttura
nazionale (INI)
Identificativo organizzazione No Contiene l’identificativo dominio regionale o provincia
autonoma dell’utente richiedente
Tipo: string
Lunghezza: 30
Descrizione organizzazione No Contiene la descrizione della regione o provincia
autonoma dell’utente richiedente
Tipo: string
Lunghezza: 30
Contiene l’identificativo dominio regionale o provincia
Identificativo organizzazione RDA No autonoma che svolge il ruolo di RDA
Tipo: string
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 9 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
Lunghezza: 3
CF richiedente Sì Codice fiscale richiedente che corrisponde al tag
IdentificativoUtente del servizio RecuperoDocumento di
INI (vedi documento [FRAMEWORK]).
Tipo: string
Lunghezza: 16
Struttura richiedente No Identificativo della struttura dell’operatore o del
professionista sanitario oppure non valorizzato se il
richiedente è il paziente
Tipo: string
Lunghezza: 60
Se presente, il dato contiene il codice HSP11, HSP11+bis,
STS11, RIA11, Azienda
Ruolo richiedente Sì Ruolo dell’utente che effettua la richiesta
Tipo: string
Lunghezza: 10
Il tag può contenere i codici previsti nel documento
dell’Affinity Domain Italia nella tabella 5.4-1 [AFFINITY
DOMAIN] e riportati nella Nota 2.
Contesto operativo della richiesta No Il contesto operativo della richiesta è stato introdotto dal
servizio RecuperaDocumento di INI [FRAMEWORK] e
sostituisce il regime del richiedente.
Tipo: string
Lunghezza: 15
Il tag può contenere i codici previsti nel documento
dell’Affinity Domain Italia nella tabella 5.4-2 [AFFINITY
DOMAIN] e riportati nel presente documento nella Nota
1.
Numero di transazione Sì Valorizzato con un codice dal Fascicolo della Regione
Piemonte a fini di tracciatura della richiesta e
troubleshooting
Tipo: string
Lunghezza: 36
Token Operazione Sì Valorizzato con un codice dal Fascicolo della Regione
Piemonte a fini di tracciatura della richiesta e
troubleshooting
Tipo: string
Lunghezza: 10
Dati paziente una occorenza
Codice paziente dipartimentale No Tipo: string
Lunghezza: 50
IDAURA No Tipo: integer
ElencoCFAssistito SI Elenco dei codici fiscali dell’assistito di cui uno è quello
valido.
Almeno una occorrenza deve essere presente per indicare il
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 10 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
codice fiscale dell’assistito del quale si richiede il
documento.
ElencoCFAssistito.cfAssistito NO Dati su un codice fiscale dell’assistito
ElencoCFAssistito.cfAssistito.cf SI se Codice fiscale dell’assistito
presente
la
sezione
ElencoC
FAssistit
o.cfAssis
tito
ElencoCFAssistito.cfAssistito.attivo SI se Indica se il codice fiscale è attivo
presente Possibili valori:
la 0: non attivo
sezione 1: attivo
ElencoC
FAssistit
o.cfAssis
tito
Cognome No Cognome del paziente
Tipo: string
Lunghezza: 50
Nome No Nome del paziente
Tipo: string
Lunghezza: 30
Sesso No Sesso del paziente
Tipo: string
Lunghezza: 1
Valori possibili:
F - femminile
M – maschile
Stato di nascita No Stato di nascita del paziente
Tipo: string
Lunghezza: 3
Codice ISTAT dello stato di nascita
Comune di nascita No Comune di nascita del paziente
Tipo: string
Lunghezza: 6
Codice ISTAT del comune di nascita, se comune estero si
inserisce ‘999’+ codice stato estero
Data di nascita No Data di nascita del paziente
Tipo: date
Codice fiscale dell’assistito a cui si riferisce la richiesta o
del genitore/tutore che ha richiesto l’operazione
Identificativo genitore tutore No
Tipo: string
Lunghezza: 16
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 11 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
Indica se è stata fatta la presa in carico del paziente.
Tipo: string
Lunghezza: 2
Presa in carico No
Valori:
SI=paziente preso in carico
NO=paziente non preso in carico
Metadati documenti una occorenza
Codice Episodio Dipartimentale No Codice dell’episodio inviato dal dipartimentale o dal
repository dell’Azienda
Tipo: string
Lunghezza: 50
Identificativo Documento Sì Identificativo del documento inviato in fase di
alimentazione del Fascicolo della Regione Piemonte.
Tipo: string
Lunghezza: 64
Per documenti inviati con i nuovi servizi di adeguamento
per l’interoperabilità con l’infrastruttura nazionale (metodo
XML registraEpisodio3 o nuovi servizi HL7), il dato sarà
codificato secondo la nuova codifica OID prevista per gli
identificativi dei documenti.
Per i documenti inviati con i vecchi servizi (metodo XML
registraEpisodio2 o vecchi servizi HL7) il dato sarà
codificato secondo le specifiche previste nei documenti in
versione precedente.
Indica il tipo di documento inviato in fase di alimentazione
del Fascicolo della Regione Piemonte.
Il tag può contenere i codici previsti per l’interoperabilità
con l’infrastruttura nazionale nel documento dell’Affinity
Tipo documento No
Domain Italia nella tabella 2.18-1 [AFFINITY DOMAIN]
e riportati nella Nota 3.
Tipo: string
Lunghezza: 10
Identificativo del repository presso il quale risiede il
documento, se valorizzao in fase di alimentazione del
Fascicolo della Regione Piemonte.
Identificativo repository No L’identificativo del repository dove risiede il documento
sarà valorizzato secondo le modalità descritte nella Nota 4.
Tipo: string
Lunghezza: 64
Nota 1 – Contesto Operativo
CODICE Descrizione Nota
TREATMENT Trattamento di cura ordinario Nel caso di richiesta da parte di utenti
con autorizzazione all'accesso su
documenti non oscurati in presenza del
consenso alla consultazione da parte del
paziente
EMERGENCY Trattamento in emergenza Per tutti i documenti non oscurati a
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 12 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
prescindere
dalla presa in carico dell’assistito
PUBEMERGENCY Trattamento per la salvaguardia di Per tutti i documenti non oscurati a
un terzo o della collettività prescindere
dalla presa in carico dell’assistito
PERSONAL Consultazione FSE Nel caso di recupero dei dati e documenti
del FSE da parte del cittadino o del
genitore/tutore, solo per ruolo utente è
ASS = assistito,
GEN = genitore,
TUT = tutore
ADMINISTRATIVE Operazioni amministrative Utilizzato per utilizzare i servizi per
finalità amministrative
Nota 2 - Ruoli
Codice Descrizione Mappatura con ruoli del DPCM sul FSE
AAS Personale di assistenza ad alta specializzazione Medico / Dirigente sanitario
Medico Medicina Generale
APR Medico di Medicina Generale / Pediatra di Libera Scelta
Pediatra di Libera Scelta
PSS Professionista del sociale Professionista del sociale
INF Personale infermieristico Infermiere o altro Professionista Sanitario
FAR Farmacista Farmacista
DSA Direttore sanitario Direttore Sanitario
DAM Direttore amministrativo Direttore Amministrativo
OAM Operatore amministrativo Operatore Amministrativo
ASS Assistito Assistito
TUT Tutore Assistito
ING Informal giver Assistito
GEN Genitore Assistito
DRS Dirigente sanitario Medico/Dirigente sanitario
RSA Medico RSA Medico RSA
MRP Medico Rete di Patologia Medico Rete di Patologia
Nota 3 – Tipo Documento
Codice Descrizione
57833-6 Prescrizione farmaceutica
60591-5 Profilo Sanitario Sintetico
11502-2 Referto di Laboratorio
57829-4 Prescrizione per prodotto o apparecchiature mediche
34105-7 Lettera di dimissione ospedaliera
59258-4 Verbale di pronto soccorso
68604-8 Referto radiologico
11526-1 Referto di anatomia patologica
57832-8 Prescrizione diagnostica o specialistica
29304-3 Prestazione farmaceutica
11488-4 Referto specialistico
81223-0 Prestazione specialistica
ATTO_OPERATORIO Atto operatorio
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 13 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
Nota 4: Codifica IdRepository
Le Aziende che aderiscono al nuovo modello e in fase di invio dei metadati del documento sul nuovo metodo
registraEpisodio3 (sviluppato per garantire l’adeguamento all’interoperabilità con INI) o attraverso i nuovi servizi
HL7 valorizzano l’identificativo del repository, riceveranno sul servizio FSERetrievalDocumentService2 nel tag
Idrepository il relativo identificativo secondo la codifica OID inviata.
Le Aziende che aderiscono al vecchio modello in cui il repository è derivato dalla Componente Locale del Fascicolo
in funzione dei codici STS11, riceveranno l’informazione IdRepository non valorizzata.
2.3.1.4 Interfaccia di OUTPUT
Informazione di output Obbl. Note
Errori Vedi paragrafo 3
Esito No Tipo: string
Lunghezza: 10
Valori possibili:
SUCCESSO
FALLIMENTO
Lista errori Vedi paragrafo 3 n occorrenze
Codice errore/warning Si Tipo: string
Descrizione errore per l'operatore No Tipo: string
Documento una occorenza
Codice Episodio Dipartimentale No Tipo: string
Lunghezza: 50
Identificativo Documento Sì Tipo: string
Lunghezza: 64
Identificativo del repository No Tipo: string
Lunghezza: 64
Documento Sì Stream del documento
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 14 di 15FSE
SPECIFICA DEL SERVIZIO DI RECUPERO
DOCUMENTO SRS-CL-SER
3. Codici di errore restituiti
Tabella di codifica degli errori/warning restituiti dall'operazione del servizio.
Codice Tipo Descrizione per l'operatore
DIP_ER_001 Errore Errore interno Dipartimentale
DIP_ER_002 Errore L'anagrafica del paziente non è presente sul Dipartimentale
DIP_ER_003 Errore L’episodio non è presente sul Dipartimentale per il paziente
DIP_ER_004 Errore Il documento non è presente sul Dipartimentale per il paziente
4. Requisiti di sicurezza
Tutte le aziende, sia pubbliche che private, devono utilizzare il protocollo https e la SSL client authentication con un
certificato.
DMA-CL-SER-01-V03.1-Servizio Febbraio 2020 uso: Esterno
FSERetrievalDocumentService2.docx
Pagina 15 di 15Puoi anche leggere
