Specifiche per l integrazione dei software di Studi MMG/PLS con i servizi del Sistema di Prenotazione Automatizzata (SPA) della Regione Lazio 12/06/2017 1
Status del Documento Rev. Data Descrizione Modifica 1 28/03/2017 Prima versione 3 12/06/2017 Accesso Servizi 2
INDICE 1 INTRODUZIONE... 4 2 DESCRIZIONE GENERALE DEL SISTEMA... 5 2.1 DESCRIZIONE GENERALE DEI SERVIZI D INTEGRAZIONE... 5 3 PROCESSI DI GESTIONE DELLA PRENOTAZIONE AUTOMATIZZATA E SERVIZI UTILIZZATI... 6 3.1 PROCESSO PRESCRIZIONE DELLA RICETTA DEMATERIALIZZATA E RICHIESTA PRENOTAZIONE PRESTAZIONI SPECIALISTICHE.... 6 3.2 PROCESSO ANNULLAMENTO DELLA RICETTA DEMATERIALIZZATA.... 7 3.3 PROCESSO ANNULLAMENTO PRENOTAZIONE PRESTAZIONI SPECIALISTICHE... 8 4 SERVIZI DISPONIBILI... 10 4.1 AUTENTICAZIONE PER L ACCESSO AI SERVIZI... 10 4.2 CERTIFICATO DI PROTEZIONE... 10 4.3 RICHIESTA PRENOTAZIONE... 11 4.3.1 Descrizione Servizio... 11 4.3.2 Accesso al servizio... 11 4.3.3 Descrizione messaggio di input... 11 4.3.4 Descrizione messaggio di output... 12 4.4 ANNULLAMENTO PRENOTAZIONE... 13 4.4.1 Descrizione Servizio... 13 4.4.2 Accesso al servizio... 13 4.4.3 Descrizione messaggio di input... 13 4.4.4 Descrizione messaggio di output... 14 5 AMBIENTE DI TEST E SERVIZI... 15 5.1 URL SERVIZI... 15 5.2 ACCESSO AI SERVIZI DI EROGAZIONE... 15 5.3 DATI DB DI TEST... 15 6 ELENCO ALLEGATI... 17 3
1 Introduzione Il presente documento descrive le specifiche tecniche e i processi relativi alla integrazione con il Sistema di Prenotazione Automatizzata (di seguito SPA) per software della Cartella Clinica degli Studi MMG/PLS della Regione Lazio. 4
2 Descrizione generale del Sistema 2.1 Descrizione generale dei Servizi d integrazione Il Sistema SPA espone i Servizi Web per dare la possibilità ai software di terzi parti di effettuare la prenotazione delle prestazioni specialistiche prescritti utilizzando la prima disponibilità presente nel Sistema Regionale RECUP. La gestione della prenotazione da parte dello studio medico è composta dalle seguenti fasi: Prescrizione della ricetta dematerializzata, integrata con i servizi del Sistema SOGEI Invio della ricetta al FSE Regionale. Richiesta prenotazione prima disponibilità. Gli Attori principali che utilizzeranno i servizi esposti sono: Studi MMG/PLS. I Servizi Web che il sistema SPA espone sono: Servizio Richiesta Prenotazione Annullamento Prenotazione Descrizione Tramite questo servizio è possibile: Richiedere, da parte dello Studio MMG, una prenotazione delle prestazioni presenti nella ricetta dematerializzata specialistica, prescritta dal MMG, al RECUP Regionale. La prenotazione sarà effettuata sulla base della prima disponibilità per ogni prestazione presente nella ricetta. Nel caso in cui la prenotazione sia effettuata correttamente, nella risposta del servizio sarà presente il documento in formato pdf della promemoria relativa alla prenotazione, che il medico potrà stampare e consegnare all assistito. Tramite questo servizio è possibile: Annullare una prenotazione eseguita dallo Studio MMG per la ricetta specialistica dematerializzata. 5
3 Processi di gestione della prenotazione automatizzata e servizi utilizzati 3.1 Processo Prescrizione della ricetta Dematerializzata e Richiesta Prenotazione prestazioni specialistiche. La Richiesta di Prenotazione viene eseguita dal MMG/PLS dal proprio studio, utilizzando il software di cartella clinica dello studio il quale, a sua volta è integrato con i Sistemai Regionali tramite i Servizi Web esposti da tali sistemi e con il Sistema SOGEI. Nello schema successivo è riportato il flusso di comunicazione tra lo studio MMG/PLS e i Sistemi Regionali. sd 01 - Inv io Ricetta - Studio MMG Studio MMG SAC FSE SPA RECUP Prescrizione Specialistica e Farnmaceutica() Invio Ricetta() Ricevuta(NRE, Codice Autorizzazione) AddDocument(CD2 Ricetta) Ricevuta(Esito) Esiti previsiti da FSE Richiesta Prenotazione Specialistica(CF,NRE, Azienda Medico) Richiesta Prenotazione Specialistica(CF,NRE,Azienda Medico) Ricevuta(Stato Prenotazione, Promemoria) Ricevuta(Stato Prenotazione, Promemoria) Prenotazione(Prima Disponibilità) Stati Previsti: - "Prenotazione non può essere eseguita" - "Errore nella Prenotazione" - in questo caso può essere rieseguito Invio della ricettta - Richiesta Prenotazione - "Prenotazione eseguita" - in questo caso viene allegtata la promemoria PDF Il Medico MMG/PLS nel caso di prescrizione dematerializzata deve: Eseguire la prescrizione (specialistica o farmaceutica) tramite il proprio Software di Cartella Clinica. Il Software di Cartella Clinica deve essere integrato con il Sistema SAC di SOGEI per l invio della ricetta dematerializzata specialistica e farmaceutica. Il Software di Cartella Clinica deve invocare i Servizi del Sistema FSE Regionale per l invio della ricetta dematerializzata. Le specifiche di invio delle ricette in formato CDA2 sono presenti sul sito poslazio.it nella sezione Integrazione Software 6
Il Software di Cartella Clinica può invocare i Servizi esposti dal Sistema Regionale SPA per effettuare la prenotazione delle prestazioni della ricetta dematerializzata prescritta. Il Sistema Regionale SPA comunicherà al Sistema di Cartella Clinica l esito della richiesta di prenotazione che consiste in: o La prima disponibilità per le prestazioni specialistiche presenti nella ricetta, nel caso in cui le prestazioni possono essere prenotate; o Il documento di promemoria della prenotazione da stampare per l assistito; o Esito negativo nel caso in cui le prestazioni non possono essere prenotate. Il Sistema di Cartella Clinica dello Studio Medico, deve provvedere alla visualizzare dell esito delle richieste effettuate e permettere di stampare al medico, nel casi in cui presente, il promemoria di prenotazione. 3.2 Processo Annullamento della ricetta dematerializzata. L annullamento della ricetta dematerializzata viene eseguito dal MMG/PLS dal proprio studio, utilizzando il software di Cartella Clinica dello studio il quale, a sua volta è integrato con i Sistemai Regionali tramite i Servizi Web esposti da tali sistemi e con Sistema SOGEI. Nello schema successivo è riportato il flusso di comunicazione tra lo studio MMG/PLS e i Sistemi Regionali. sd 02 - Annullamento Ricetta SAC Studio MMG FSE Invio Annullamento Ricetta(NRE) Ricevuta(Codice Annullamento) Annullamento Prescrizione Specialistica e Farmaceutica() AddDocument(CD2 Ricetta Annullata) Ricevuta(Esito) Nel caso in cui la ricetta che si cerca di annullare è già stata presa in carico da una Azienda e/o RECUP, annullamento di prescirizione non è consentita. In questo caso Studio MMG deve comunicare annullamento solo al FSE. Esiti previsti dalla documetazione FSE Il Medico MMG/PLS nel caso di annullamento della prescrizione dematerializzata deve: Eseguire l annullamento della prescrizione (specialistica o farmaceutica) tramite il proprio Software di Cartella Clinica. 7
Il Software di Cartella Clinica deve essere integrato con il Sistema SAC di SOGEI per l invio dell annullamento della ricetta dematerializzata specialistica e farmaceutica. Il Software di Cartella Clinica deve invocare i Servizi del Sistema FSE Regionale per l invio della ricetta dematerializzata annullata. Le specifiche di invio della ricetta in formato CDA2 sono presenti sul sito poslazio.it nella sezione Integrazione Software Nel presente documento non sono descritti i servizi che corrispondo a questo flusso. Il documento è presente sul sito poslazio.it nella sezione Integrazione Software. 3.3 Processo Annullamento Prenotazione prestazioni specialistiche Nello schema successivo è riportato il flusso di comunicazione tra lo studio MMG/PLS e i Sistemi Regionali per l annullamento della prenotazione della ricetta dematerializzata specialistica, eseguita dal Medico MMG/PLS dal proprio studio, utilizzando il software di cartella clinica dello studio il quale, a sua volta è integrato con i Sistemai Regionali tramite i Servizi Web esposti da tali sistemi. sd 03 - Annullamento Prenotazione - Studio MMG Studio MMG SPA RECUP Richiesta Annullamento Prenotazione(CF, NRE) Richiesta Annullamento Prenotazione(CF, NRE) Ricevuta(Stato Annullamento) Ricevuta(Stato Annullamento) Il Medico MMG/PLS nel caso di annullamento della prenotazione deve: Eseguire l annullamento della prenotazione tramite il proprio Software di Cartella Clinica. Il Software di Cartella Clinica deve invocare i Servizi esposti dal Sistema Regionale SPA per effettuare l annullamento della prenotazione delle prestazioni della ricetta dematerializzata prescritta. Il Sistema Regionale SPA comunicherà al Sistema di Cartella Clinica l esito della richiesta di prenotazione che consiste in: o L esito dell annullamento della prenotazione 8
Il Sistema di Cartella Clinica dello Studio Medico, deve provvedere alla visualizzazione al medico dell esito delle richiesta effettuata. 9
4 Servizi Disponibili 4.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 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. In ambiente di collaudo e 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. 4.2 Certificato di Protezione Il software gestionale delle terzi parti deve essere in grado di codificare il codice fiscale utilizzando le tecniche di crittografia con la chiave pubblica RSA contenuta nel certificato X.509 fornito da LAZIOcrea ed applicando il padding PKCS#1 v1.5. La trasformazione deve essere conforme con quella ottenuta dall'esecuzione del comando del pacchetto open source "openssl", come a titolo di esempio: openssl rsautl -encrypt -in CF.txt -out CF.enc -inkey SpaCF.cer -certin -pkcs in cui il file CF.txt contiene il codice fiscale in chiaro, il file SpaCF.cer contiene il certificato X.509 della LAZIOcrea, il file CF.enc contiene il risultato dell'operazione di crittografia sul codice fiscale. I codici fiscali crittografati devono essere codificati BASE64 (RFC 1521). Il certificato SpaCF.cer è disponibile su richiesta. 10
4.3 Richiesta Prenotazione 4.3.1 Descrizione Servizio Il servizio permette ai software di Cartella Clinica degli Studi MMG/PLS di effettuare la richiesta di prenotazione per la ricetta dematerializzata specialistica prescritta dallo stesso studio. Il Servizio, sulla base dei parametri di input: NRE della ricetta dematerializzata Codice Fiscale dell assistito Codice Fiscale del medico Azienda di competenza del medico comunica alla software di Cartella Clinica dello studio: Esito della richiesta. Nel caso in cui la prenotazione non può essere eseguita, sarà comunicato che le prestazioni non sono prenotabili tramite il RECUP Regionale. La prima data disponibile e l azienda di erogazione per le prestazioni presenti nella ricetta dematerializzata, nel caso in cui le prestazioni sono prenotabili tramite RECUP Regionale. Il documento, in formato pdf, di promemoria della prenotazione. 4.3.2 Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: https://test.laitspa.it/medbase-ws/ws/richiestaprenotazione ( il link di collaudo potrà essere soggetto ad alcune variazioni) Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione. 4.3.3 Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di richiesta di prenotazione per una ricetta dematerializzata PrenotazioneRichiesta. Nome Campo Contenuto Caratteristiche cfmedico Codice fiscale del medico MMG che effettua la richiesta di prenotazione. Elemento obbligatorio 11
Nome Campo Contenuto Caratteristiche codiceaslcompetenza Codice della ASL di competenza del MMG/PLS che effettua la richiesta di prenotazione. Elemento obbligatorio Nre Numero Ricetta Elettronico, prescritto del Medico. Elemento obbligatorio cfassistito Codice fiscale dell assistito. Se l assistito è provvisto di Tessera Sanitaria l elemento è Obbligatorio per la ricerca della prescrizione. Se l assistito è un soggetto privo di Elemento obbligatorio Tessera Sanitaria (ad es. straniero europeo o extraeuropeo) il campo deve essere lasciato vuoto in quanto il soggetto non possiede un codice fiscale. Tale campo deve essere inserito criptato tramite l utilizzo del certificato SpaCF.cer. telefonoassistito Il telefono del assistito per il contatto. Campo facoltativo 4.3.4 Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo RicevutaPrenotazione, contenente l'esito della trasmissione. Formato dell'elemento RicevutaPrenotazione in caso di corretta ricezione: Nome Campo Contenuto Note Nre Numero Ricetta Elettronico, prescritto del Medico. tipodocumento Descrizione documento. Valore: Promemoria documentopdf Documento di promemoria PDF come allegato MTOM. https://www.w3.org/tr/soap12-mtom Nel caso in cui ci sono prenotazione per più unità erogante, nello stesso documento saranno presenti più pagine. Ripetizione di Messaggio Codice Codice del messaggio diagnostico Valori: 0 Prenotazione eseguita correttamente. 1 Prenotazione eseguita correttamente con warning. 2 Prenotazione eseguita errori. value Testo del messaggio level parametri Livello di importanza del messaggio. Uno tra TRACE, DEBUG, INFO, WARNING, ERROR, FATAL Corrisponde ai parametri di ricerca (RicercaAssistitiRequest) forniti in input 12
4.4 Annullamento Prenotazione 4.4.1 Descrizione Servizio Il servizio permette ai software di Cartella Clinica degli Studi MMG/PLS di richiedere l annullamento della prenotazione effettuata correttamente (è stato ricevuto il documento di promemoria) per la ricetta dematerializzata specialistica prescritta dallo stesso studio. Il Servizio, sulla base dei parametri d ingresso: NRE della ricetta dematerializzata Codice Fiscale dell assistito Codice Fiscale del medico Comunica la software di Cartella Clinica dello studio: Esito della richiesta. 4.4.2 Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: https://test.laitspa.it/medbase-ws/ws/annullaprenotazione ( il link di collaudo potrà essere soggetto ad alcune variazioni) Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione. 4.4.3 Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di richiesta di annullamento della prenotazione per una ricetta dematerializzata AnnullamentoPrenotazioneRichiesta. Nome Campo Contenuto Caratteristiche cfmedico Codice fiscale del medico MMG che effettua la richiesta di prenotazione. Elemento obbligatorio Nre Numero Ricetta Elettronico, prescritto del Medico. Elemento obbligatorio cfassistito Codice fiscale dell assistito. Se l assistito è provvisto di Tessera Sanitaria l elemento è Obbligatorio per la ricerca della prescrizione. Se l assistito è un soggetto privo di Tessera Sanitaria (ad es. straniero europeo o extraeuropeo) il campo deve essere lasciato vuoto in quanto il soggetto non possiede un codice fiscale. Tale campo deve essere inserito criptato tramite l utilizzo del certificato SpaCF.cer. Elemento obbligatorio 13
4.4.4 Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo RicevutaAnnulamentoPrenotazione, contenente l'esito della trasmissione. Formato dell'elemento RicevutaAnnullamentoPrenotazione in caso di corretta ricezione: Nome Campo Contenuto Note Nre Numero Ricetta Elettronico, prescritto del Medico. Ripetizione di Messaggio Codice Codice del messaggio diagnostico Valori: 0 Annullamento Prenotazione eseguito correttamente. 1 Annullamento Prenotazione eseguito correttamente con warning 2 Annullamento Prenotazione eseguito con errori. value Testo del messaggio level parametri Livello di importanza del messaggio. Uno tra TRACE, DEBUG, INFO, WARNING, ERROR, FATAL Corrisponde ai parametri di ricerca (RicercaAssistitiRequest) forniti in input 14
5 Ambiente di test e servizi 5.1 URL Servizi L URL di accesso ai servizi in ambiente di test è generalizzato a: https://test.laitspa.it/medbase-ws/ws/ I nomi dei singoli servizi sono presenti nella tabella successiva: Servizio Richiesta Prenotazione Annullamento Prenotazione Web Services Collaudo https://test.laitspa.it/medbase-ws/ws/richiestaprenotazione https://test.laitspa.it/medbase-ws/ws/annullaprenotazione 5.2 Accesso ai Servizi di Erogazione Per effettuare l accesso ai servizi esposti per la gestione della Prenotazione, tramite basic authentication è presente l utenza valida per tutti gli attori interessati all integrazione: Utente: FGLMSM55B02H501Y Password: WsSAR001 5.3 Dati DB di test I dati presenti sul DB di test possono essere così riepilogati: Nella tabella successiva sono presenti alcuni Codici Fiscali degli assistiti presenti sul DB di Test. Codici Fiscali MZZTZN78P52H501X DNLRNT30R45I418T BRNFNC70L61H501H DRSMRS61P55H501B FSTFDN29H21A746J FRRGNI56A02G273S MRNPLA49P24H501W 15
Codici Fiscali CLLRLB40E49F158K SNTDNL53M62G601J PTRMSM52D13E472R CNGCNZ58B57H501N RFFRZE69E43H501E DRNMRC81A15B114I MRTSDR65R24H501U BRRNNZ38P50H501X NGLMRP39A46A515Y PSCMLS29H51F656G AAXAAA00A50H5L1O LTTGRG56T20Z336N SNTFLC80A12H501S CLLRSM27B10D708K DRNPRZ61E53H501T PRLCRM35E69F970Y SNTCRL55B23H501D RCCVLE20E57E799B MRTVCN57C12F734X CSSFRC78B21H501T BNVNNA50S66H501S LRTBRC44P54G232R PTRBBR68D46H501N DPLNDR48E21L120B Anche se i 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. Per l assistito con il Codice Fiscale DPLNDR48E21L120B possono essere richieste Esenzioni per reddito. Per quasi tutti gli assistiti, con Codici Fiscali elencati, sono presenti le esenzioni per la patologia. 16
6 Elenco allegati Nome Documento Revisione Data Autore Specifiche Integrazione FSE dal sito www.poslazio.it nella sessione Interazione software. Specifiche Access Gateway Sistema Informativo Fascicolo Sanitario Elettronico (F.S.E.) della Regione Lazio 17