Specifiche per l integrazione dei software di cartella clinica

(1)

1

Specifiche per l’integrazione dei software di cartella clinica MMG/PLS con i servizi Web esposti dalla

Regione Lazio

Procedure operative per l’inserimento dei Medici di Medicina Generale e Pediatri di Libera Scelta nella rete

regionale di sorveglianza epidemiologica per SARS-

CoV-2

(2)

Status del Documento

Rev. Data Descrizione Modifica

1 02/12/2020 Prima versione

2 22/12/2020

 Il campo emailAssistito nel servizio

InvioComunicazioneInizioIsolamentoPositivo non è obbligatorio ma facoltativo

 Nel paragrafo 3.3 è stata inserita la nota dove viene specificato che il medico contestualmente all’invio della Comunicazione Inizio isolamento di paziente con diagnosi confermata di Covid-19 deve inviare all’assistito anche l’allegato 4 Istruzioni per l’isolamento.

 Nel paragrafo 3.6 è stata inserita la nota dove viene specificato che il medico contestualmente all’invio della Comunicazione INIZIO/FINE quarantena deve inviare all’assistito anche l’allegato 6 Istruzioni per la quarantena.

 Aggiunto il Servizio di Comunicazione al SISP di INIZIO quarantena.

 Aggiunto i campi nel servizio InvioComunicazioneInizioFineQuarantena emailAssistito - Facoltativo

telefonoAssistito1 - Obbligatorio telefonoAssistito2 – Facoltativo

(3)

3

Indice

1 INTRODUZIONE ... 4

2 DESCRIZIONE DEI SERVIZI DI INTEGRAZIONE ... 5

2.1 AUTENTICAZIONE PER L’ACCESSO AI SERVIZI ... 5

3 SERVIZI DISPONIBILI ... 6

3.1 COMUNICAZIONE TEST ANTIGENICO NEGATIVO ... 6

3.1.1 Accesso al servizio ... 6

3.1.2 Descrizione del servizio ... 6

3.2 COMUNICAZIONE TAMPONE MOLECOLARE NEGATIVO ... 8

3.3 COMUNICAZIONE INIZIO ISOLAMENTO DI PAZIENTE CON DIAGNOSI CONFERMATA DI COVID-19 ... 10

3.4 COMUNICAZIONE ATTESTAZIONE/CERTIFICAZIONE DI FINE ISOLAMENTO CON TAMPONE NEGATIVO ... 13

3.5 COMUNICAZIONE ATTESTAZIONE/CERTIFICAZIONE DI FINE ISOLAMENTO PER I CASI POSITIVI A LUNGO TERMINE ... 15

3.6 COMUNICAZIONE INIZIO/FINE QUARANTENA ... 17

3.7 COMUNICAZIONE AL SISP DI INIZIO QUARANTENA ... 20

3.8 CODICI ESITO SERVIZI ... 22

4 AMBIENTE DI TEST E SERVIZI ... 23

4.1 URLSERVIZI ... 23

4.2 ACCESSO SERVIZI ... 23

4.3 DATI DB DI TEST ... 24

(4)

1 Introduzione

Il presente documento descrive le specifiche tecniche relative all’uso dei servizi web di supporto alle procedure operative per l’inserimento dei Medici di Medicina Generale e Pediatri di Libera Scelta nella rete regionale di sorveglianza epidemiologica per SARS-CoV-2.

(5)

5

2 Descrizione dei Servizi di integrazione

I servizi esposti sono destinati a tutti gli attori che utilizzano i software di studio medico, in merito alla gestione delle attestazioni e delle comunicazioni finalizzate alla sorveglianza epidemiologica per SARS-CoV-2.

Di seguito i servizi web esposti:

Servizio Descrizione

Attestazione di Test antigenico negativo Questo servizio viene usato per produrre l’attestazione in caso di Test antigenico negativo.

Attestazione di Tampone molecolare negativo

Questo servizio viene usato per produrre l’attestazione in caso di Tampone molecolare negativo.

Comunicazione inizio isolamento di paziente con diagnosi confermata di Covid-19

Questo servizio viene usato per comunicare l’inizio isolamento di un paziente con diagnosi confermata di Covid-19.

Attestazione/certificazione di fine isolamento con tampone negativo

Questo servizio viene usato produrre l’attestazione di fine isolamento con tampone negativo.

Attestazione/certificazione di fine isolamento per i casi positivi a lungo termine

Questo servizio viene usato produrre l’attestazione di fine isolamento per i casi positivi a lungo termine.

Comunicazione INIZIO/FINE quarantena Questo servizio viene usato produrre la Comunicazione di INIZIO/FINE quarantena.

Comunicazione al SISP di INIZIO quarantena Questo servizio viene usato per produrre la Comunicazione di INIZIO quarantena per il SISP.

N.B.: si fa presente che, fra i servizi resi disponibili, NON figurano quelli di annullamento, né quelli per la ri-emissione di un certificato prodotto.

2.1 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 l’uso delle credenziali del medico prescrittore, che utilizza il software di terzi parti, registrate nel sistema regionale di Access Management IAMUP.

(6)

3 Servizi Disponibili

3.1 Comunicazione Test antigenico negativo

3.1.1 Accesso al servizio

L’indirizzo per accedere al servizio di test è:

https://qservice.regione.lazio.it/servizi-mb/services/InvioTestAntigenicoNegativo

Sarà comunicato ad avvenuto collaudo l’indirizzo per raggiungere i servizi esposti in ambiente di produzione.

3.1.2 Descrizione del servizio

Tramite questo servizio, è possibile produrre l’attestazione in caso di esito Test antigenico negativo.

3.1.2.1 Campi di input

Descrizione degli elementi costitutivi del messaggio di richiesta (InvioTestAntigenicoNegativo)

Campo Contenuto Obbligatorio

idUtenteRichiedente Codice fiscale del medico (titolare o sostituto) che sta

eseguendo l’operazione. SI

softwareRichiedente Nome della Software House del medico MMG/PLS

che richiama il servizio. SI

cfMedicoTitolare Codice fiscale del medico titolare. SI

cfAssistito

Codice fiscale dell’assistito. Il codice fiscale deve essere inviato cifrato secondo le modalità di cui al decreto attuativo del comma 5 dell’articolo 50 del DL 269/2003

SI

codASL Codice della ASL del medico MMG/PLS Elemento

facoltativo

codDistretto Codice identificativo del distretto del medico MMG/PLS.

Elemento facoltativo

codSpecializzazione

Specializzazione del medico.

Indicare il Codice specializzazione corrispondente:

F per “Medico di medicina generale”

P per “Pediatra di libera scelta”

Elemento obbligatorio

dataEsecuzioneTestAntigenico Data in cui l’assistito è stato sottoposto al Test Antigenico. Formato ammesso aaaa/mm/gg SI

(7)

7

tipologiaStudio

Codifiche ammesse:

1 = Studio Medico 2 = Locale ASL

3 = Locale equiparato a Studio medico 9 = Altro

Valorizzare sempre a “1”

SI

luogoRilascioAttestazione

Indicare il luogo (es. Roma, Rieti, Viterbo) dove il medico rilascia la sua attestazione; questa informazione verrà riportata nell’attestazione.

SI

3.1.2.2 Campi di output

Per ogni richiesta, il sistema risponde con un messaggio di tipo InvioTestAntigenicoNegativoRicevuta, contenente l'esito della trasmissione.

Campo Contenuto

protocolloTransazione Riporta l’identificativo univoco della transazione, assegnato dal sistema.

timestamp Campo che contiene la data della transazione formata da giorno, ore, minuti, secondi, millisecondi.

esito Codice relativo all’esito della transazione. Per i valori consultare il paragrafo 3.7.

descrizioneEsito Descrizione dell’esito della transazione. Per i valori consultare il paragrafo 3.7.

pdfDocumento In caso di esito positivo (00), contiene il documento in formato pdf.

(8)

3.2 Comunicazione Tampone molecolare negativo

3.2.1 Accesso al servizio

https://qservice.regione.lazio.it/servizi-mb/services/InvioTamponeMolecolareNegativo

3.2.2 Descrizione del servizio

Tramite questo servizio, è possibile produrre l’attestazione in caso di esito Tampone molecolare negativo.

3.2.2.1 Campi di input

Descrizione degli elementi costitutivi del messaggio di richiesta (InvioTamponeMolecolareNegativo)

idUtenteRichiedente Codice fiscale del medico (titolare o sostituto) che sta eseguendo l’operazione. SI softwareRichiedente Nome della Software House del medico

MMG/PLS che richiama il servizio. SI cfMedicoTitolare Codice fiscale del medico titolare. SI

cfAssistito

Codice fiscale dell’assistito. Il codice fiscale deve essere inviato cifrato secondo le modalità di cui al decreto attuativo del comma 5 dell’articolo 50 del DL 269/2003.

SI

codASL Codice della ASL del medico MMG/PLS. Elemento

facoltativo codDistretto Codice identificativo del distretto del

medico MMG/PLS.

Specializzazione del medico. Indicare solo il Codice specializzazione corrispondente F (Medico di medicina generale)

P (Pediatra di libera scelta).

dataEsecuzioneTamponeMolecolareNegativo

Data in cui l’assistito è stato sottoposto al Tampone Molecolare Negativo.

Formato ammesso aaaa/mm/gg.

SI

tipologiaStudio

Inserire il codice corrispondente:

3 = Locale equiparato allo Studio medico 9 = Altro

SI

(9)

9

Indicare il luogo (es. Roma, Rieti, Viterbo) dove il medico rilascia la sua attestazione;

questa informazione verrà riportata nell’attestazione.

SI

3.2.2.2 Campi di output

Per ogni richiesta, il sistema risponde con un messaggio di tipo InvioTamponeMolecolareNegativoRicevuta, contenente l'esito della trasmissione.

protocolloTransazione Riporta l’identificativo univoco della transazione, assegnato dal sistema timestamp Campo che contiene la data della transazione formata da giorno, ore,

minuti, secondi, millisecondi.

esito Codice relativo all’esito della transazione. Per i valori consultare il paragrafo 3.7

descrizioneEsito Descrizione dell’esito della transazione. Per i valori consultare il paragrafo 3.7

(10)

3.3 Comunicazione Inizio isolamento di paziente con diagnosi confermata di Covid-19

3.3.1 Accesso al servizio

https://qservice.regione.lazio.it/servizi-mb/services/InvioComunicazioneInizioIsolamentoPositivo

3.3.2 Descrizione del servizio

Tramite questo servizio è possibile comunicare l’inizio isolamento di un paziente con diagnosi confermata di Covid- 19.

NOTA OPERATIVA:

Il medico, contestualmente all’invio della Comunicazione Inizio isolamento di paziente con diagnosi confermata di Covid-19, deve inviare all’assistito anche l’allegato 4 (“Istruzioni per l’isolamento”) al documento “Procedure operative per l’inserimento dei Medici di Medicina Generale e Pediatri di Libera Scelta, nella rete regionale di sorveglianza epidemiologica per SARS-CoV-2”, prodotto da Regione.

3.3.2.1 Campi di input

Descrizione degli elementi costitutivi del messaggio di richiesta (InvioComunicazioneInizioIsolamentoPositivo)

idUtenteRichiedente

Codice fiscale del medico (titolare o sostituto) che sta eseguendo l’operazione.

SI

softwareRichiedente

Nome della Software House del medico MMG/PLS che richiama il servizio.

SI cfMedicoTitolare Codice fiscale del medico titolare. SI

cfAssistito

SI

(11)

11

codASL Codice della ASL del medico

MMG/PLS.

P per “Pediatra di libera scelta”.

dataEsecuzioneTestDiagnosticoSARSCoV2Positivo

Data in cui l’assistito è stato sottoposto al test diagnostico per SARS-CoV-2 positivo.

SI

indirizzoIsolamentoAssistito Indicare l’indirizzo per il periodo di misura dell’isolamento. SI numeroCivicoIsolamentoAssistito

Indicare il numero civico dell’indirizzo per il periodo di misura dell’isolamento.

SI

comuneIsolamentoAssistito Indicare il comune per il periodo di misura dell’isolamento. SI

emailAssistito Indicare email dell’assistito. NO

telefonoAssistito1 Indicare telefono dell’assistito. SI telefonoAssistito2 Indicare il telefono dell’assistito. NO

tipologiaStudio

Codifiche ammesse:

3 = Locale equiparato a Studio medico

9 = Altro

SI

(12)

3.3.2.2 Campi di output

Per ogni richiesta, il sistema risponde con un messaggio di tipo

InvioComunicazioneInizioIsolamentoPositivoRicevuta, contenente l'esito della trasmissione.

Timestamp Campo che contiene la data della transazione formata da giorno, ore, minuti, secondi, millisecondi.

Esito Codice relativo all’esito della transazione. Per i valori consultare il paragrafo 3.7.

(13)

13

3.4 Comunicazione Attestazione/certificazione di fine isolamento con tampone negativo

3.4.1 Accesso al servizio

https://qservice.regione.lazio.it/servizi-mb/services/InvioAttestazioneFineIsolamentoTamponeNegativo

3.4.2 Descrizione del servizio

Tramite questo servizio, è possibile produrre l’attestazione di fine isolamento con tampone negativo.

3.4.2.1 Campi di input

Descrizione degli elementi costitutivi del messaggio di richiesta (InvioAttestazioneFineIsolamentoTamponeNegativo)

SI

softwareRichiedente Nome della Software House del medico MMG/PLS che richiama il servizio. SI cfMedicoTitolare Codice fiscale del medico titolare. SI

cfAssistito

SI

MMG/PLS.

(14)

dataEsecuzioneTamponeNasoFaringeoPositivo

Data in cui l’assistito è stato sottoposto al Tampone naso-faringeo per ricerca di SARS-CoV-2 con esito positivo;

SI

dataEsecuzioneTamponeNasoFaringeoNegativo

Data in cui l’assistito è stato sottoposto al Tampone naso-faringeo per ricerca di SARS-CoV-2 (dopo almeno 3 giorni senza sintomi, se presenti) con esito negativo.

SI

tipologiaStudio

Codifiche ammesse:

SI

3.4.2.2 Campi di output

InvioAttestazioneFineIsolamentoTamponeNegativoRicevuta, contenente l'esito della trasmissione.

(15)

15

3.5 Comunicazione Attestazione/certificazione di fine isolamento per i casi positivi a lungo termine

3.5.1 Accesso al servizio

https://qservice.regione.lazio.it/servizi-mb/services/InvioAttestazioneFineIsolamentoPositiviLungoTermine

3.5.2 Descrizione del servizio

Tramite questo servizio, è possibile è possibile produrre l’attestazione di fine isolamento per i casi positivi a lungo termine.

3.5.2.1 Campi di input

Codice fiscale del medico (titolare o sostituto) che sta eseguendo

l’operazione. SI

cfAssistito

SI

MMG/PLS.

dataEsecuzioneTamponeNasoFaringeoPositivo

Data in cui l’assistito è stato sottoposto al Tampone naso-faringeo per ricerca di SARS-CoV-2 con esito positivo.

SI

(16)

tipologiaStudio

Codifiche ammesse:

SI

3.5.2.2 Campi di output

InvioAttestazioneFineIsolamentoPositiviLungoTermineRicevuta, contenente l'esito della trasmissione.

(17)

17

3.6 Comunicazione INIZIO/FINE quarantena

3.6.1 Accesso al servizio

https://qservice.regione.lazio.it/servizi-mb/services/InvioComunicazioneInizioFineQuarantena

3.6.2 Descrizione del servizio

Tramite questo servizio, è possibile produrre la Comunicazione INIZIO/FINE quarantena.

NOTA OPERATIVA:

Il medico, contestualmente all’invio della Comunicazione INIZIO/FINE quarantena, deve inviare all’assistito anche l’allegato 6 (“Istruzioni per la quarantena”) al documento “Procedure operative per l’inserimento dei Medici di Medicina Generale e Pediatri di Libera Scelta, nella rete regionale di sorveglianza epidemiologica per SARS-CoV- 2”, prodotto da Regione.

3.6.2.1 Campi di input

Descrizione degli elementi costitutivi del messaggio di richiesta (InvioComunicazioneInizioFineQuarantena)

Codice fiscale del medico (titolare o sostituto) che sta eseguendo

l’operazione. SI

cfAssistito

SI

codASL Codice della ASL del medico MMG/PLS. Elemento facoltativo

codDistretto Codice identificativo del distretto del

medico MMG/PLS. Elemento facoltativo

(18)

telefonoAssistito1 Indicare telefono dell’assistito. SI telefonoAssistito2 Indicare telefono dell’assistito. NO

dataInizioQuarantena

Data in cui l’assistito è stato sottoposto in quarantena in qualità di contatto stretto asintomatico.

SI

dataFineQuarantena Data presunta di termine quarantena.

Formato ammesso aaaa/mm/gg. SI

interruzionePerTamponeNegativo

Valorizzare a ‘S’ per interruzione della quarantena a fronte di tampone nasofaringeo negativo dopo 10gg da ultimo contatto con il CASO.

Se ‘S’, si deve compilare obbligatoriamente il campo dataTamponeNegativo.

NON valorizzare se interruzionePerScaden zaQuarantena = ‘S’, altrimenti valorizzare il campo

dataTamponeNegativo

Data in cui l’assistito è stato sottoposto al Tampone naso-faringeo risultato negativo, dopo 10 giorni dall’ultimo contatto con il CASO.

SI se è stato impostato interruzionePerTampo neNegativo = ‘S’

interruzionePerScadenzaQuarantena

Valorizzare a ‘S’ se l’assistito ha osservato i 14 giorni di quarantena dall’ultimo contatto in assenza di sintomi, senza eseguire tampone nasofaringeo.

NON valorizzare se interruzionePerTampo neNegativo = ‘S’, altrimenti valorizzare il campo

tipologiaStudio

Codifiche ammesse:

SI

(19)

19

3.6.2.2 Campi di output

Per ogni richiesta, il sistema risponde con un messaggio di tipo InvioComunicazioneInizioFineQuarantenaRicevuta, contenente l'esito della trasmissione.

protocolloTransazione Riporta l’identificativo univoco della transazione, assegnato dal sistema Timestamp Campo che contiene la data della transazione formata da giorno, ore,

Esito Codice relativo all’esito della transazione. Per i valori consultare il paragrafo 3.7

(20)

3.7 Comunicazione al SISP di INIZIO quarantena

3.7.1 Accesso al servizio

https://qservice.regione.lazio.it/servizi-mb/services/InvioComunicazioneInizioQuarantenaSISP

3.7.2 Descrizione del servizio

Tramite questo servizio, è possibile produrre la Comunicazione al SISP di INIZIO quarantena.

3.7.2.1 Campi di input

Descrizione degli elementi costitutivi del messaggio di richiesta (InvioComunicazioneInizioQuarantena)

SI

cfAssistito

SI

codASL Codice della ASL del medico MMG/PLS Elemento facoltativo

codDistretto Codice identificativo del distretto del

medico MMG/PLS. Elemento facoltativo

telefonoAssistito1 Indicare telefono dell’assistito. SI telefonoAssistito2 Indicare il telefono dell’assistito. NO indirizzoQuarantenaAssistito Indicare l’indirizzo per il periodo di misura

dela quarantena. SI

numeroCivicoQuarantenaAssistito Indicare il numero civico dell’indirizzo per il periodo di misura dela quarantena. SI

(21)

21

comuneQuarantenaAssistito Indicare il comune per il periodo di misura

della quarantena. SI

NomeCaso Indicare il nome del CASO. NO

CognomeCaso Indicare il cognome del CASO. NO

dataUltimoContatto Data ultimo contatto con il CASO.

Formato ammesso aaaa/mm/gg. NO

tipologiaStudio

Codifiche ammesse:

SI

3.7.2.2 Campi di output

Per ogni richiesta, il sistema risponde con un messaggio di tipo InvioComunicazioneInizioQuarantenaSISP Ricevuta, contenente l'esito della trasmissione.

protocolloTransazione Riporta l’identificativo univoco della transazione, assegnato dal sistema Timestamp Campo che contiene la data della transazione formata da giorno, ore,

Esito Codice relativo all’esito della transazione. Per i valori consultare il paragrafo 3.7

(22)

3.8 Codici Esito Servizi

Codice Esito Descrizione Esito

00 Transazione andata a buon fine

03 Il campo cfMedicoTitolare o idUtenteRichiedente non è compatibile con l'utente autenticato 04 Utente finale non autorizzato, controllare il campo cfMedicoTitolare

05 Utente non autorizzato

06 Il campo cfAssistito non è stato cifrato correttamente o è vuoto 07 Il campo cfAssistito e' formalmente errato

09 Il campo cfAssistito contiene un CF non presente nella banca dati assistiti 10 Il campo emailAssistito è formalmente errato

53 Il campo protocolloTransazione non è formalmente valid 63 Il campo dataDa è formalmente errato

64 Il campo dataA è formalmente errato

65 I campi dataDa e dataA non sono congruenti tra di loro 74 Telefono formalmente errato

97 Servizio fermo per manutenzione 98 Servizio non attivo

99 Errore di sistema

(23)

23

4 Ambiente di test e servizi

4.1 URL Servizi

Di seguito URL di accesso ai servizi in ambiente di test:

Servizio Descrizione

Test antigenico negativo https://qservice.regione.lazio.it/servizi- mb/services/InvioTestAntigenicoNegativo Tampone molecolare negativo https://qservice.regione.lazio.it/servizi-

mb/services/InvioTamponeMolecolareNegativo Comunicazione al SISP dell’inizio

isolamento di paziente con diagnosi confermata di Covid-19

https://qservice.regione.lazio.it/servizi-

mb/services/InvioComunicazioneInizioIsolamentoPositivo

Attestazione/certificazione di fine isolamento con tampone negativo

mb/services/InvioAttestazioneFineIsolamentoTamponeNegativo Attestazione/certificazione di fine

isolamento per i casi positivi a lungo termine

mb/services/InvioAttestazioneFineIsolamentoPositiviLungoTermine

Comunicazione INIZIO/FINE quarantena https://qservice.regione.lazio.it/servizi-

mb/services/InvioComunicazioneInizioFineQuarantena InvioComunicazioneInizioQuarantenaSISP https://qservice.regione.lazio.it/servizi-

mb/services/InvioComunicazioneInizioQuarantenaSISP

Per il recupero dei wsdl dei servizi accedere alla index page (sezione download) alla seguente url:

https://qservice.regione.lazio.it/servizi-mb/

4.2 Accesso Servizi

Per effettuare l’accesso ai servizi esposti, tramite basic authentication è presente l’utenza valida per tutti gli attori interessati all’integrazione:

Utente: FGLMSM55B02H501Y Password: WsSAR001!!

(24)

4.3 Dati DB di test

L’utente/medico con Codice Fiscale FGLMSM55B02H501Y, è registrato con specializzazione medico ospedaliero (H) della ASL Roma/A (120101).

Il Sistema individuerà automaticamente il medico sulla base dell’autenticazione effettuata per accedere ai servizi.

Nella tabella successiva sono presenti alcuni di Codici Fiscali degli assistiti presenti sul DB di Test.

Codici Fiscali CNCGRL77B16H501E AAAEEE01A01H501Q