Specifiche per l`integrazione dei software di cartella clinica con i

Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
Specifiche per l’integrazione dei software di cartella
clinica con i servizi Web esposti dalla Regione Lazio
12/01/2017
1
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
Status del Documento
Rev.
Data
Descrizione Modifica
1
17/11/2016
2
12/01/2017
Prima versione
Modifica endpuoint di test per tutti i servizi.
Modifiche nei dati di DB di test
2
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
Indice
1
INTRODUZIONE ............................................................................................................................................................. 4
1.1
2
DESCRIZIONE DEI SERVIZI DI INTEGRAZIONE ................................................................................................................. 5
1.2
1.3
3
GLOSSARIO .......................................................................................................................................................................... 4
AUTENTICAZIONE PER L’ACCESSO AI SERVIZI ................................................................................................................................ 5
PROCEDURA DI RICHIESTA DELLE CREDENZIALI ............................................................................................................................. 5
SERVIZI DISPONIBILI...................................................................................................................................................... 7
1.4 ANAGRAFICA MEDICO UCP ..................................................................................................................................................... 7
1.4.1
Accesso al servizio .................................................................................................................................................. 7
1.4.2
Descrizione del servizio ........................................................................................................................................... 7
1.5 ANAGRAFICA ASSISTITO .......................................................................................................................................................... 9
1.5.1
Accesso al servizio .................................................................................................................................................. 9
1.5.2
Descrizione messaggio ........................................................................................................................................... 9
1.6 ESENZIONI ASSISTITO ........................................................................................................................................................... 12
1.6.1
Accesso al servizio ................................................................................................................................................ 12
1.6.2
Descrizione messaggio ......................................................................................................................................... 12
1.7 SERVIZIO COORTI ................................................................................................................................................................ 13
1.7.1
Accesso al servizio ................................................................................................................................................ 13
1.7.2
Descrizione messaggio ......................................................................................................................................... 14
4
NOTE TECNICHE .......................................................................................................................................................... 16
4.1
4.2
5
CRITERI DI PAGINAZIONE DEI RISULTATI .................................................................................................................................... 16
CRITERI DI ORDINAMENTO DEI RISULTATI.................................................................................................................................. 16
AMBIENTE DI TEST E SERVIZI....................................................................................................................................... 17
1.8 URL SERVIZI ...................................................................................................................................................................... 17
1.9 ACCESSO SERVIZI ................................................................................................................................................................ 17
1.10
DATI DB DI TEST ............................................................................................................................................................ 17
3
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
1 Introduzione
Il presente documento descrive le specifiche tecniche per tutti gli attori interessati (produttori di software di Cartella
Clinica per gli studi medici MMG e PLS) per l’integrazione tramite i servizi web predisposti.
1.1 Glossario
ASUR
Anagrafe Sanitaria Unica Regionale
CNIPA
Centro Nazionale Informatica Pubblica Amministrazione
CNS
Carta Nazionale dei Servizi dei servizi
DIT
Dipartimento Innovazioni tecnologiche della Presidenza del consiglio dei ministri
DPCM
Decreto Presidente consiglio dei ministri
MEF
Ministero dell’economia e della finanze
NRE
Numero Ricetta Elettronica
RGS
Ragioneria Generale dello Stato
SAC
Sistema di Accoglienza Centrale, che rappresenta l’infrastruttura tecnologica del Ministero
dell’economia e delle finanze, per la ricezione dei dati delle ricette mediche trasmessi dagli utenti.
SAR
Sistema di Accoglienza Regionale
SASN
Servizio Assistenza Sanitaria personale Navigante
SPC
Sistema Pubblico Connettività
SSN
Servizio Sanitario Nazionale
4
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
2 Descrizione dei Servizi di integrazione
I servizi esposti sono destinati ai Studi di MMG e PLS, che continueranno utilizzare il proprio software di Cartella
Clinica dello studio
Tutti i servizi web sono sviluppati seguendo le linee guida e impostazioni tecniche prodotte dal MEF – SOGEI
riguardo al progetto Tessera Sanitaria Elettronica e Medici in Rete.
Di seguito i servizi web esposti:
Servizio
Descrizione
Anagrafica medico UCP
Tramite questo servizio è possibile ricercare medici MMG/PLS associati in
UCP al medico fruitore del servizio.
Anagrafica assistito
Tramite questo servizio è possibile ricercare all’interno dell’archivio degli
assistiti di propria competenza (sia UCP che studio medico)
Esenzioni Assistito
Tramite questo servizio è possibile avere i dettagli delle esenzioni
dell’assistito di propria competenza.
Servizio Coorti
Tramite questo servizio è possibile ricercare una coorte per codice ed averne
l’elenco degli assistiti afferenti
1.2 Autenticazione per l’accesso ai servizi
L’accesso ai servizi Web di Integrazione, esposti dal sistema, avviene tramite i sistemi di autenticazione standard
del protocollo HTTPS e BASIC Authentication.
La procedura per invocare i servizi web esposti prevede nel caso di studi medici che utilizzano i software di terzi
parti di utilizzare l’utente e password del medico MMG e PLS configurati nel sistema regionale di Access
Management Penso.
1.3 Procedura di richiesta delle credenziali
In ambiente di produzione, per gli studi medici di MMG e PLS, le credenziali per accedere ai Servizi Web di
Integrazione sono le stesse che utilizza il medico per accedere al Portale Regionale della Sanità (www.poslazio.it).
5
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
In ambiente di test saranno fornite sia le credenziali specifiche, che potranno essere utilizzate da tutti gli attori che
dovranno invocare i servizi web esposti, sia i codici fiscali specifici per effettuare le prove di trasmissione.
6
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
3 Servizi Disponibili
1.4 Anagrafica medico UCP
1.4.1 Accesso al servizio
L’indirizzo per accedere al servizio di test è:
https://test.laitspa.it/medbase-ws/ws/medicoUCP
Sarà comunicato ad avvenuto collaudo l’indirizzo per raggiungere i servizi esposti in ambiente di
produzione.
1.4.2 Descrizione del servizio
Tramite questo servizio è possibile effettuare ricerche nell’archivio dei medici MMG/PLS associati in UCP al
medico fruitore del servizio. E’ possibile ricercare anche la lista dei codici fiscali dei medici appartenenti alla stessa
UCP di appartenenza.
1.4.2.1 Campi di input
Descrizione degli elementi costitutivi del messaggio di richiesta ricerca (ricercaMediciRequest):
7
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
Nome Campo
Contenuto
codiceFiscale
Tipo
Codice fiscale del medico da ricercare.
facoltativo
Se non specificato verrà restituito l’elenco dei medici
appartenenti alla UCP di competenza del medico fruitore
Campi per i quali effettuare l’ordinamento dei dati.
ordinamento
facoltativo
Per maggiori dettagli sulla sintassi da utilizzare per il campo
di ordinamento fare riferimento alla relativa sezione del
(Valori ammessi:
codiceFiscale
documento
cognome
nome)
Campi relativi alla paginazione (vedere apposita sezione del documento)
inizio
Numero del record di inizio
facoltativo
fine
Numero del record di fine
facoltativo
1.4.2.2 Campi di output
Descrizione degli elementi costitutivi del messaggio di risposta ricerca (ricercaMediciResponse):
Nome Campo
Contenuto
Codice dell’esito della ricerca.
codiceEsito
Valori possibili:
-1 Elaborazione fallita
0 Elaborazione completata con successo
1 Elaborazione completata con presenza di warning
descrizioneEsito
totale
codiceFiscale
cognome
nome
sesso
dataNascita
comuneNascita
categoria
asl
distretto
Descrizione dell’esito della ricerca
Numero totale dei record che soddisfano i criteri di ricerca impostati
Ripetizione di Medico
Codice fiscale del medico
Cognome del medico
Nome del medico
Sesso del medico (M o F)
Data di nascita del medico
Comune di nascita del medico
Categoria del medico (MMG o PLS)
Codice e descrizione della asl di competenza del medico
Codice e descrizione del distretto di competenza del medico
8
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
Nome Campo
Contenuto
Ripetizione di Messaggio
codice
Codice del messaggio diagnostico
value
Testo del messaggio
level
Livello di importanza del messaggio.
Uno tra TRACE, DEBUG, INFO, WARNING, ERROR, FATAL
parametri
Corrisponde ai parametri di ricerca (RicercaMediciRequest) forniti in input
1.5 Anagrafica assistito
1.5.1 Accesso al servizio
L’indirizzo per accedere al servizio di test è:
https://test.laitspa.it/medbase-ws/ws/assistito
Sarà comunicato ad avvenuto collaudo l’indirizzo per raggiungere i servizi esposti in ambiente di
produzione.
1.5.2 Descrizione messaggio
Tramite questo servizio è possibile effettuare ricerche nell’archivio degli assistiti di propria competenza sia per UCP
che per studio medico.
1.5.2.1 Campi di input
Descrizione degli elementi costitutivi del messaggio di richiesta ricerca (ricercaAssistitiRequest):
Nome Campo
Contenuto
Tipo
codiceFiscale
Codice fiscale dell’assistito da ricercare
facoltativo
codiceStraniero
Codice STP/ENI dell’assistito da ricercare
facoltativo
codiceFiscaleMedico
Codice fiscale del medico curante dell’assistito. Per avere la lista dei
obbligatorio
proprio assistiti un medico deve impostare questo campo con il
proprio codice fiscale. Per avere la lista degli assistiti di un altro
medico, qui va impostato il codice fiscale del medico di interesse. Il
sistema rifiuterà codici fiscali diversi dal proprio se tali codici fiscali
non sono associati in UCP al medico fruitore del servizio
9
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
Nome Campo
Contenuto
Tipo
Campi per i quali effettuare l’ordinamento dei dati.
ordinamento
facoltativo
Per maggiori dettagli sulla sintassi da utilizzare per il campo di
(Valori ammessi:
ordinamento fare riferimento alla relativa sezione del documento
codiceFiscale
cognome
nome
Campi relativi alla paginazione (vedere apposita sezione del documento)
inizio
fine
Numero del record di inizio
Numero del record di fine
facoltativo
facoltativo
1.5.2.2 Campi di output
Descrizione degli elementi costitutivi del messaggio di risposta ricerca (ricercaAssistitiResponse):
Nome Campo
Contenuto
Codice dell’esito della ricerca.
codiceEsito
Valori possibili:
-1 Elaborazione fallita
0 Elaborazione completata con successo
1 Elaborazione completata con presenza di warning
descrizioneEsito
totale
Descrizione dell’esito della ricerca
Numero totale dei record che soddisfano i criteri di ricerca impostati
Ripetizione di Paziente
codiceRegionale
validitaCodiceRegionale
codiceFiscale
validitaCodiceFiscale
cognome
nome
sesso
dataNascita
comuneNascita
nazioneNascita
nazioneCittadinanza
codiceStraniero
dataInizioCodiceStraniero
dataFineCodiceStraniero
dataDecesso
comuneDecesso
Codice regionale dell’assistito
Data di decorrenza validità codice regionale
Codice fiscale dell’assistito
Data di decorrenza validità codice fiscale
Cognome dell’assistito
Nome dell’assistito
Sesso dell’assistito (M o F)
Data di nascita dell’assistito
Comune di nascita dell’assistito (codice e descrizione)
Nazione di nascita dell’assistito (codice e descrizione)
Nazione di cittadinanza dell’assistito (codice e descrizione)
Codice STP/ENI dell’assistito
Data di inizio validità codice straniero
Data di fine validità codice straniero
Data di decesso dell’assistito
Comune di decesso dell’assistito (codice e descrizione)
10
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
Nome Campo
indirizzoResidenza
civicoResidenza
capResidenza
comuneResidenza
nazioneResidenza
municipioResidenza
dataInizioResidenza
dataFineResidenza
indirizzoDomicilio
civicoDomicilio
capDomicilio
comuneDomicilio
municipioDomicilio
dataInizioDomicilio
dataFineDomicilio
email
telefono1
telefono2
telefono3
dataInizioMandatoAssistenziale
dataFineMandatoAssistenziale
aslResidenza
distrettoResidenza
aslDomicilio
distrettoDomicilio
tipoScelta
medico
Contenuto
Indirizzo di residenza dell’assistito
Civico di residenza dell’assistito
Cap di residenza dell’assistito
Comune di residenza dell’assistito (codice e descrizione)
Nazione di residenza dell’assistito (codice e descrizione)
Numero del municipio di residenza dell’assistito
Data di inizio validità dei dati di residenza
Data di fine validità dei dati di residenza
Indirizzo di domicilio dell’assistito
Civico del domicilio dell’assistito
Cap del domicilio dell’assistito
Comune di domicilio dell’assistito (codice e descrizione)
Numero del municipio di domicilio dell’assistito
Data di inizio validità dei dati di domicilio
Data di fine validità dei dati di domicilio
Indirizzo email dell’assistito
Recapito telefonico dell’assistito
Recapito telefonico dell’assistito
Recapito telefonico dell’assistito
Data di inizio del mandato assistenziale
Data di fine del mandato assistenziale
Asl di residenza dell’assistito (codice e descrizione)
Distretto di residenza dell’assistito (codice e descrizione)
Asl di domicilio dell’assistito (codice e descrizione)
Distretto di domicilio dell’assistito (codice e descrizione)
Tipo di scelta medico (codice e descrizione)
Il medico curante dell’assistito (sono riportati i campi indicati dal servizio
anagrafica medico)
dataInizioScelta
dataFineScelta
dataScadenzaScelta
motivoRevoca
Codice
value
level
Data di assegnazione del medico
Data di revoca del medico
Data di scadenza dell’assegnazione del medico
Motivo di revoca (codice e descrizione)
Ripetizione di Messaggio
Codice del messaggio diagnostico
Testo del messaggio
Livello di importanza del messaggio.
Uno tra TRACE, DEBUG, INFO, WARNING, ERROR, FATAL
parametri
Corrisponde ai parametri di ricerca (RicercaAssistitiRequest) forniti in input
11
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
1.6 Esenzioni Assistito
1.6.1 Accesso al servizio
L’indirizzo per accedere al servizio di test è:
https://test.laitspa.it/medbase-ws/ws/esenzioneAssistito
Sarà comunicato ad avvenuto collaudo l’indirizzo per raggiungere i servizi esposti in ambiente di
produzione.
1.6.2 Descrizione messaggio
Tramite questo servizio è possibile ricercare un assistito di propria competenza tramite codice fiscale ed avere
accesso alle informazioni sulle esenzioni a lui assegnate.
1.6.2.1 Campi di input
Descrizione degli elementi costitutivi del messaggio di richiesta ricerca (ricercaEsenzioniAssistitoRequest):
Nome Campo
Contenuto
Tipo
codiceFiscale
Codice fiscale dell’assistito da estrarre
perReddito
Flag per estrarre solo le esenzioni da reddito o solo quelle per
facoltativo
sensibile
patologia
Campo per futuro utilizzo
facoltativo
dataRiferimento
Data di riferimento per stabilire la validità dell’esenzione
facoltativo
obbligatorio
(di default viene
considerata la data
odierna)
1.6.2.2 Campi di output
Descrizione degli elementi costitutivi del messaggio di risposta ricerca (ricercaAssistitoResponse):
Nome Campo
Contenuto
12
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
Nome Campo
Contenuto
Codice dell’esito della ricerca.
codiceEsito
Valori possibili:
-1 Elaborazione fallita
0 Elaborazione completata con successo
1 Elaborazione completata con presenza di warning
descrizioneEsito
Descrizione dell’esito della ricerca
Dati esente
codiceFiscale
cognome
nome
sesso
dataNascita
comuneNascita
Codice fiscale dell’assistito
Cognome dell’assistito
Nome dell’assistito
Sesso dell’assistito (M o F)
Data di nascita dell’assistito
Comune di nascita dell’assistito (codice e descrizione)
Ripetizione di Esenzione
Codice dell’esenzione secondo il catalogo regionale delle esenzioni
Codice dell’esenzione secondo il catalogo del sistema TS
Descrizione dell’esenzione
Data di inizio assegnazione dell’esenzione
Data di scadenza assegnazione dell’esenzione
Data di cessazione anticipata dell’assegnazione dell’esenzione
Flag che indica se si tratta di una esenzione da reddito
Ripetizione di Messaggio
Codice del messaggio diagnostico
Testo del messaggio
Livello di importanza del messaggio.
codice
codiceTS
descrizione
dataInizio
dataFine
dataCessazione
perReddito
codice
value
level
Uno tra TRACE, DEBUG, INFO, WARNING, ERROR, FATAL
parametri
Corrisponde ai parametri di ricerca (ricercaEsenzioniAssistitoRequest) forniti in
input
1.7 Servizio Coorti
1.7.1 Accesso al servizio
L’indirizzo per accedere al servizio di test è:
https://test.laitspa.it/medbase-ws/ws/coorte
Sarà comunicato ad avvenuto collaudo l’indirizzo per raggiungere i servizi esposti in ambiente di
produzione.
13
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
1.7.2 Descrizione messaggio
Tramite questo servizio è possibile ricercare una coorte tramite codice ed avere accesso alle informazioni sugli
assistiti ad essa afferenti.
1.7.2.1 Campi di input
Descrizione degli elementi costitutivi del messaggio di richiesta ricerca (ricercaCoorteRequest) :
codiceCoorte
Il codice coorte da ricercare
ordinamento
Campi per i quali effettuare l’ordinamento dei dati.
obbligatorio
facoltativo
Per maggiori dettagli sulla sintassi da utilizzare per il campo di
(Valori ammessi:
ordinamento fare riferimento alla relativa sezione del documento
codiceFiscale
cognome
nome)
Campi relativi alla paginazione (vedere apposita sezione del documento)
inizio
Numero del record di inizio
facoltativo
fine
Numero del record di fine
facoltativo
1.7.2.2 Campi di output
Descrizione degli elementi costitutivi del messaggio di risposta ricerca (ricercaCoorteResponse):
Codice dell’esito della ricerca.
codiceEsito
Valori possibili:
-1 Elaborazione fallita
0 Elaborazione completata con successo
1 Elaborazione completata con presenza di warning
descrizioneEsito
Descrizione dell’esito della ricerca
Dati coorte
codice
descrizione
Codice coorte
Descrizione coorte
Ripetizione di paziente
14
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
Codice fiscale dell’assistito
Cognome dell’assistito
Nome dell’assistito
Sesso dell’assistito (M o F)
Data di nascita dell’assistito
Comune di nascita dell’assistito (codice e descrizione)
Ripetizione di Messaggio
Codice del messaggio diagnostico
Testo del messaggio
Livello di importanza del messaggio.
codiceFiscale
cognome
nome
sesso
dataNascita
comuneNascita
codice
value
level
Uno tra TRACE, DEBUG, INFO, WARNING, ERROR, FATAL
parametri
Corrisponde ai parametri di ricerca (ricercaCoorteRequest) forniti in input
15
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
4 Note tecniche
4.1 Criteri di paginazione dei risultati
I servizi che prevedono i parametri di paginazione offrono la possibilità di recuperare le informazioni un po' per
volta. Questo garantisce una risposta più rapida e diminuisce notevolmente il traffico di rete per singola chiamata.
Inoltre alcuni servizi, trattando potenzialmente una mole di dati eccessiva per per singola richiesta, impongono un
limite massimo di record restituibili dal servizio.
Per ovviare a tale problema pertanto il fruitore del servizio è tenuto a ridurre il resultset restituito dal server o
impostando dei parametri di ricerca più stringenti o sfruttando i criteri di paginazione.
Un esempio classico è quello della ricerca degli assistiti di una UCP.
In una UCP gli assistiti possono essere migliaia ed il webservice non sarebbe in grado di restituire l’elenco
completo in una singola chiamata. Pertanto una possibilità sarebbe quella di restringere i parametri di ricerca
impostando per esempio il cognome dell’assistito, ma questo potrebbe non essere in linea con le necessità del
software che intende integrarsi. Una soluzione migliore è quella di ricercare con i criteri di paginazione.
Ad esempio impostando i campi inizio = 0 e fine = 9 si otterranno i primi 10 risultati della ricerca, impostando inizio
= 10 e fine = 19 si otterranno i secondi 10 risultati e così via.
Ovviamente in questo caso potrebbe essere di fondamentale importanza avere i risultati ordinati secondo un
determinato criterio. I criteri di ordinamento dei risultati sono descritti nella prossima sezione.
Resta inteso che questa funzionalità deve essere usata con criterio e non al solo scopo di aggirare i limiti imposti
dal webservice. In tal senso non devono essere effettuate chiamate in serie per poter estrarre l’intero
resultset dei dati.
4.2 Criteri di ordinamento dei risultati
I servizi che prevedono i parametri di ordinamento offrono la possibilità di recuperare le informazioni ordinate
secondo determinati criteri. I campi per i quali è possibile applicare l’ordinamento sono elencati nelle specifiche di
ogni servizio che li prevede.
E’ possibile ordinare per più campi sia in ordine crescente che decrescente.
La sintassi da utilizzare nel parametro di ordinamento è la seguente
(+|-)nomeCampo1,(+|-)nomeCampo2,(+|-)nomeCampoN
esempio1: per ordinare in ordine crescente per i campi cognome e nome il campo ordinamento dovrà assumere il
seguente valore: +cognome,+nome
esempio2: per ordinare in ordine crescente per il campo cognome e descrescente per il campo nome il campo
ordinamento dovrà assumere il seguente valore: +cognome,-nome
16
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207
Specifiche per l’integrazione dei software di Cartella Clinica
con i servizi Web esposti dalla Regione Lazio.
5 Ambiente di test e servizi
1.8 URL Servizi
Di seguito URL di accesso ai servizi in ambiente di test:
Servizio
Descrizione
Anagrafica medico UCP
https://test.laitspa.it/medbase-ws/ws/medicoUCP
Anagrafica assistito
https://test.laitspa.it/medbase-ws/ws /assistito
Esenzioni Assistito
https://test.laitspa.it/medbase-ws/ws/esenzioneAssistito
Servizio Coorti
https://test.laitspa.it/medbase-ws/ws/coorte
1.9 Accesso Servizi
Attualmente i servizi sono accessibili senza autenticazione con l’utenza fissa che corrisponde al CF del medico
FGLMSM55B02H501Y.
1.10 Dati DB di test
I dati presenti sul DB di test possono essere così riepilogati:
Servizio Anagrafica Medico UCP: esiste una sola UCP con i medici con i CF:
FGLMSM55B02H501Y
LNEMRN59C70H501K.
Servizio Anagrafica assistito: ci sono assistiti per i medici in UCP di cui sopra.
Servizio Esenzioni assistito: ci sono varie tipologie di esenzione per l'assistito con CF RSSNMR24A48F023E.
Servizio Coorti: esiste una sola Coorte (codice=COR001) con 4 assistiti.
Anche se Codici Fiscali possono risultare corretti (ai fini di controlli che effettua SOGEI sulle ricette anche in
ambiente di Test), i dati anagrafici associati a questi assistiti sono di fantasia.
17
LazioCrea
Sede Legale e
amministrativa:
S.p.A.
Società a Socio unico Regione Lazio
Via del Serafico, 107
00142 Roma
T +39 06 515631
F +39 06 51563611
R.E.A. RM-1464288
Sede operativa:
Capitale sociale:
€ 924.400,00
C.F./P.IVA 13662331001
Via A. B. Cairoli, 68
00145 Roma
T +39 06 51689800
F +39 06 51892207