Specifiche per l integrazione dei software di cartella clinica MMG/PLS con i servizi Web esposti dalla Regione Lazio (Tabelle RAO Priorità)

Transcript

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

2 Status del Documento Rev. Data Modifica 1 22/11/2016 Prima versione 2 28/03/2017 Precisazione Stampa Prestazione Clinica 3 12/06/2017 Accesso Servizi 4 03/07/2017 Variazione Indirizzo Collaudo Accesso Servizi 5 16/10/2017 Aggiornamento password servizi 2

3 Indice 1 INTRODUZIONE DESCRIZIONE DEI SERVIZI DI INTEGRAZIONE AUTENTICAZIONE PER L ACCESSO AI SERVIZI SERVIZI DISPONIBILI RICHIESTA DELLA PRIORITÀ PER LA PRESTAZIONE SPECIALISTICA Accesso al servizio del servizio AMBIENTE DI TEST E SERVIZI URL SERVIZI ACCESSO SERVIZI DATI DB DI TEST

4 1 Introduzione Il presente documento descrive le specifiche tecniche per tutti gli attori interessati (produttori di software di Cartella Clinica) per l integrazione tramite i servizi web predisposti. 4

5 2 dei Servizi di integrazione I servizi esposti sono destinati a tutti gli attori che utilizzano il software di Cartella Clinica e gestiscono la prescrizione della ricetta dematerializzata specialistica e hanno necessità di consultare le tabella RAO per l attribuzione della priorità alla ricetta ai fini di gestione regionale dei tempi d attesa nella prenotazione delle prestazioni prescritte Di seguito i servizi web esposti: Servizio Indicazione della Priorità per la prestazione specialistica Tramite questo servizio è possibile richiedere per una prestazione specialistica le indicazioni sulla priorità della prescrizione sulla base delle condizioni cliniche dell assistito. 1.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 utilizzo dei credenziali del medico prescrittore, che utilizza il software di terzi parti, registrate nel sistema regionale di Access Management Penso. 5

6 3 Servizi Disponibili 1.2 Richiesta della Priorità per la prestazione specialistica Accesso al servizio L indirizzo per accedere al servizio di test è: Si ricorda che i WSDL di definizione dei servizi devono essere scaricati dal sezione downloads Pacchetto wsdl (01/06/2017) Sarà comunicato ad avvenuto collaudo l indirizzo per raggiungere i servizi esposti in ambiente di produzione del servizio Tramite questo servizio è possibile effettuare la richiesta di indicazione delle priorità da attribuire alla ricetta specialistica nel caso della prescrizione di una prestazione sulla base delle condizioni cliniche del paziente Campi di input degli elementi costitutivi del messaggio di richiesta (TabellaRAORichiesta): Campo Contenuto Tipo codicebranca Filtro per Branca, codice a due caratteri (es: 00, 69, ecc) Opzionale codicenomenclatore Filtro per codice nomenclatore regionale (es: ) Opzionale codicediagnosi Filtro per codice diagnosi ICD9 (es: 4414) Opzionale inizio Progressivo primo record richiesto (0 n) Opzionale fine Progressivo ultimo record richiesto. Obbligatorio se è stato specificato inizio. Opzionale 6

7 Nel caso in cui la richiesta viene effettuata senza specificare nessun parametro, sarà restituita la tabella intera delle prestazioni/priorità. Nel caso in cui il numero di righe supera il massimale configurato, sarà restituito il codice dell errore Campi di output degli elementi costitutivi del messaggio di risposta ricerca (TabellaRAORicevuta): Campo Contenuto totale Numero totale di record corrispondenti alla richiesta parametri Ripetizione parametri di ricerca codiceesito 0 = successo, 1 = errore descrizioneesito Messaggio descrittivo dell esito della ricerca messaggi Elenco messaggi di avviso/errore Per ogni indicazione priorità trovata branca Codice e descrizione Branca priorità nomenclatore Codice e descrizione prestazione Nomenclatore per la priorità priorita Codice e descrizione della priorità condizioneclinica Testo con le indicazioni delle condizioni di applicabilità della priorità diagnosiicd9 Codice e descrizione della diagnosi ICD9 per la priorità Nell inserimento di una prestazione CRITICA verrà data la possibilità di individuare la condizione clinica più rispondente ed il conseguente grado di priorità attraverso la tabella RAO. La condizione clinica verrà riportata nella ricetta nel campo destinato alla diagnosi. In alternativa nel caso gli applicativi gestionali di studio medico consentano l inserimento della diagnosi codificata secondo l ICD9- CM la condizione clinica verrà riportata a margine di ciascuna prestazione critica, mentre la diagnosi verrà riportata nell apposito campo, e valevole per l intera ricetta. Ove necessario il campo relativo alla condizione clinica verrà troncato o sintetizzato. 7

8 4 Ambiente di test e servizi 1.3 URL Servizi Di seguito URL di accesso ai servizi in ambiente di test: Servizio Indicazione della Priorità per la prestazione specialistica 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!! 1.5 Dati DB di test I dati presenti sul DB di test possono corrispondono e tutte le prestazioni specialistiche per le quale la Regione Lazio ha effettuato la configurazione relativa alla priorità da indicare sulla ricetta. I codici del Nomenclatore Regionale delle prestazioni sono: Codice TEST CARDIOVASCOLARE DA SFORZO CON PEDANA MOBILE TOMOGRAFIA COMPUTERIZZATA (TC) DEL RACHIDE E DELLO SPECO VERTEBRALE, SENZA E CON CONTRASTO RISONANZA MAGNETICA NUCLEARE (RM) DELL'ADDOME INFERIORE E SCAVO PELVICO ECOGRAFIA DELL' ADDOME INFERIORE ECOGRAFIA DELL' ADDOME SUPERIORE MAMMOGRAFIA BILATERALE (2 proiezioni) TOMOGRAFIA COMPUTERIZZATA (TC) DEL RACHIDE E DELLO SPECO VERTEBRALE ECOGRAFIA ADDOME COMPLETO 8

9 Codice ELETTROCARDIOGRAMMA DINAMICO TOMOGRAFIA COMPUTERIZZATA (TC) DELL' ADDOME SUPERIORE RISONANZA MAGNETICA NUCLEARE (RM) MUSCOLOSCHELETRICA, SENZA E CON CONTRASTO 89.7 VISITA GENERALE RISONANZA MAGNETICA NUCLEARE (RM) DELLA COLONNA, SENZA E CON CONTRASTO Cervicale, toracica, lombosacrale DIAGNOSTICA ECOGRAFICA DEL CAPO E DEL COLLO ECO(COLOR)DOPPLERGRAFIA DEGLI ARTI SUPERIORI O INFERIORI O DISTRETTUALE, ARTERIOSA O VENOSA ECOCOLORDOPPLERGRAFIA CARDIACA A riposo o dopo prova fisica o farmacologica RISONANZA MAGNETICA NUCLEARE (RM) DELLA COLONNA Cervicale, toracica, lombosacrale ECOGRAFIA DELLA MAMMELLA TOMOGRAFIA COMPUTERIZZATA (TC) DEL TORACE, SENZA E CON CONTRASTO TOMOGRAFIA COMPUTERIZZATA (TC) DELL' ADDOME COMPLETO TOMOGRAFIA COMPUTERIZZATA (TC) DEL CAPO, SENZA E CON CONTRASTO TC del cranio [sella turcica, orbite] TC dell' encefalo RISONANZA MAGNETICA NUCLEARE (RM) DEL CERVELLO E DEL TRONCO ENCEFALICO Incluso: relativo distretto vascolare TOMOGRAFIA COMPUTERIZZATA (TC) DEL BACINO TC di: bacino e articolazioni sacro-iliache RISONANZA MAGNETICA NUCLEARE (RM) MUSCOLOSCHELETRICA TOMOGRAFIA COMPUTERIZZATA (TC) DELL' ADDOME INFERIORE ECO(COLOR)DOPPLER DEI TRONCHI SOVRAAORTICI A riposo o dopo prova fisica o farmacologica Le codifiche delle Branche utilizzate sono : Codice 00 Laboratorio Analisi Chimico Cliniche e Microbiologia 05 Angiologia 08 Cardiologia 09 Chirurgia Generale 12 Chirurgia Plastica 15 Medicina Sportiva 9

10 Codice 19 Malattie endocrine,del ricambio e nutrizione 29 Nefrologia 30 Neurochirurgia 32 Neurologia 34 Oculistica 35 Odontoiatria e Stomatologia 36 Ortopedia e Traumatologia 37 Ostetricia e Ginecologia 38 Otorinolaringoiatria 40 Psichiatria 43 Urologia 52 Dermatologia 56 Recupero e riabilitazione funzionale 58 Gastroenterologia 61 Medicina Nucleare 64 Oncologia 68 Pneumologia 69 Radiologia 70 Radioterapia 79 Risonanza Magnetica 80 Chirurgia Speciale Diagnostica Invasiva 82 Terapia del dolore 10