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

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 2 16/01/2017 Prima versione 3 01/02/2017 Aggiunto il capitolo 1.2 Modificato URL di servizio di annullamento di vaccinazione 3 12/06/2017 Accesso Servizi 4 12/07/2017 Accesso Servizi 2

3 Indice 1 INTRODUZIONE DESCRIZIONE DEI SERVIZI DI INTEGRAZIONE AUTENTICAZIONE PER L ACCESSO AI SERVIZI INDICAZIONE STRUTTURA/AMBULATORIO DI RIFERIMENTO SERVIZI DISPONIBILI COMUNICAZIONE REGISTRAZIONE DELLE VACCINAZIONI Accesso al servizio del servizio COMUNICAZIONE ANNULLAMENTO REGISTRAZIONE DELLE VACCINAZIONI 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 relativi alla registrazione delle somministrazioni dei vaccini. 4

5 2 dei Servizi di integrazione I servizi esposti sono destinati a tutti gli attori che utilizzano il software di Cartella Clinica e devono trasmettere alla Regione le registrazioni delle somministrazioni dei vaccini. Di seguito i servizi web esposti: Servizio Comunicazione registrazione somministrazione del vaccino. Comunicazione annullamento di una registrazione Tramite questo servizio è possibile comunicare avvenuta registrazione di somministrazione del vaccino. Tramite questo servizio è possibile comunicare annullamento di una registrazione del vaccino. 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. 1.2 Indicazione Struttura/Ambulatorio di riferimento Per indicare la Struttura/Ambulatorio di riferimento e la Specialità del medico prescrittore, che invia le ricette elettroniche al SAR utilizzando le proprie credenziali dell OpenSSO Regionale, è necessario specificare un HEADER HTTP con il seguente nome: codicecontesto. Il valore del HEADER HTTP deve essere composto con le seguente modalità (dove [..] indicano valori opzionali): codiceruolo.codiceasl[.codicestruttura[_substruttura][.codiceuo]] Definizione: codiceruolo la Specializzazione del Medico Prescrittore, come dalla codifica di SOGEI, con la quale il Medico è registrato nel Sistema TS. I valori sono riportati nella tabella sottostante. Il valore è obbligatorio. codiceasl il della ASL/AO di competenza del Medico Prescrittore, come da registrazione nel Sistema TS. I valori sono riportati nella tabella sottostante. Il valore è obbligatorio. 5

6 codicestruttura - il Struttura di competenza del Medico Prescrittore. Nel caso delle strutture pubbliche il valore è opzionale e si riferisce ai codici del Sistema QUASIAS. Nel caso delle Strutture Classificate, il dato è obbligatorio e valori sono riportati nella tabella sottostante. substruttura il Sub della Struttura di competenza del Medico Prescrittore. Il valore è opzionale e si riferisce ai codici del Sistema QUASIAS codiceuo il del Ambulatorio di competenza del Medico Prescrittore. Il valore è opzionale e si riferisce ai codici codificati nel Sistema RECUP. Codici delle Specializzazione Medico da utilizzare per codiceruolo. A Specialista Ambulatoriale (Ex Sumai) B Medico consulente C Specialista di struttura privata accreditata D Dipendente dei servizi territoriali ASL F Medico di medicina generale G Guardia medica H Ospedaliero I Medico INAIL P Pediatra di libera scelta T Guardia medica turistica U Medico di azienda ospedaliero - universitaria X Altro (tirocinanti, specializzandi, etc.) Z Altra specializzazione Codici ASL/AO da utilizzare per codiceasl. Questa tabella sarà aggiornata in breve sulla base dei nuovi codici delle ASL RM/A RM/B RM/C RM/D RM/E RM/F RM/G RM/H VITERBO RIETI LATINA FROSINONE 6

7 AZ.OSP.SAN CAMILLO-FORLANINI AZIENDA OSP. S.GIOVANNI/ADDOLORATA AZIENDA POLICLINICO UMBERTO I ISTITUTI FISIOTERAPICI OSPITALIERI INMI "L.SPALLANZANI" - IRCCS AZIENDA OSPEDALIERA SANT`ANDREA AZ. OSP. UNIV. POLICLINICO TOR VERGATA Codici Strutture Classificati da utilizzare per codicestruttura OSP. REGINA APOSTOLORUM ALBANO OSPEDALE SAN PIETRO FATEBENEFRATELLI OSPEDALE FATEBENEFRATELLI OSP. GEN. DI ZONA 'CRISTO RE' OSPEDALE ISRAELITICO OSPEDALE PEDIATRICO BAMBINO GESU` POLICLINICO A. GEMELLI E C.I.C POLICL. UNIV. CAMPUS BIO MEDICO Esempi di valori di HEADER HTTP: Minimo Obbligatorio per la Struttura Pubblica: Z Medico Prescrittore ha la Specializzazione Z Altre Specializzazioni e lavora presso l ASL Roma/A. Minimo Obbligatorio per la Struttura Classificata: H Medico Prescrittore ha la Specializzazione H Ospedaliero e lavora presso struttura OSPEDALE PEDIATRICO BAMBINO GESU` con riferimento all ASL Roma/A. Altri esempi: Z Medico Prescrittore ha la Specializzazione Z Altre Specializzazioni e lavora presso l ASL Roma/B al POLICLINICO CASILINO. Z OCU7 - Medico Prescrittore ha la Specializzazione Z Altre Specializzazioni e lavora presso l ASL Roma/B al POLICLINICO CASILINO, presso Ambulatorio Oculistica Casilino. H _02 - Medico Prescrittore ha la Specializzazione H Ospedaliero e lavora presso struttura POLICLINICO UNIVERSITARIO A. GEMELLI con riferimento all ASL Roma/A e presidio COMPLESSO INTEGRATO COLUMBUS (C.I.C.). 7

8 3 Servizi Disponibili 1.2 Comunicazione registrazione delle vaccinazioni Accesso al servizio L indirizzo per accedere al servizio di test è: Sarà comunicato ad avvenuto collaudo l indirizzo per raggiungere i servizi esposti in ambiente di produzione del servizio Tramite questo servizio è possibile comunicare una o più registrazioni delle somministrazioni dei vaccini per gli assistiti Campi di input Operazione utilizzata è inviovaccinazioni. degli elementi costitutivi del messaggio di richiesta (InvioVaccinazioniRichiesta), Campo Contenuto Tipo codicefiscalemedico Fiscale Medico che effettua somministrazione Obbligatorio codiceaslmedico ASL di competenza Medico (i codici sono definiti nella Obbligatorio tabella sottostante) codicecentrovaccinale Centro Vaccinale. (Il del Centro Vaccinale è Opzionale pubblicato su specializzazionemedico Specializzazione del medico. Come dalla codifica di SOGEI. Obbligatorio Per ogni invio del medico ripetizione di DettaglioVaccinazione. codicefiscaleassistito Fiscale Assistito Obbligatorio codiceprogvaccinale programma vaccinale. Nel caso di Programma di vaccinazione con vaccino antipneumococcico coniugato (PCV) 13-valente inserire il valore: 001. Altrimenti lasciare il campo nullo. Opzionale codicevaccino Vaccino. Obbligatorio 8

9 Campo Contenuto Tipo Nel caso di Programma di vaccinazione con vaccino antipneumococcico coniugato (PCV) 13-valente inserire il valore: 016. Per la comunicazione delle altre vaccinazioni, utilizzare i codici presenti nella tabella sottostante. datasomministrazione Data Somministrazione Obbligatorio dataregistrazione Data Registrazione Obbligatorio numdose Numero Dose Obbligatorio numlotto Numero Lotto Opzionale codicelotto Lotto Opzionale motivosomministrazione Motivo Somministrazione. E obbligatorio per gli assistiti minori di Opzionale 65 anni. (i codici sono definiti nella tabella sottostante) nel caso di Programma di vaccinazione con vaccino anti-pneumococcico coniugato (PCV) 13-valente. Per altri tipologie di vaccinazioni lasciare il campo nullo. luogosomministrazione Luogo Somministrazione (i codici sono definiti nella tabella sottostante). Obbligatorio Codici ASL da utilizzare: ASL ASL RM1 (ex RM/A) RM2 (ex RM/B) RM2 (ex RM/C) RM3 (ex RM/D) RM1 (ex RM/E) RM4 (ex RM/F) RM5 (ex RM/G) RM6 (ex RM/H) VITERBO RIETI LATINA FROSINONE Codici delle Specializzazione Medico. A Specialista Ambulatoriale (Ex Sumai) B Medico consulente C Specialista di struttura privata accreditata D Dipendente dei servizi territoriali ASL 9

10 F G H I P T U X Z Medico di medicina generale Guardia medica Ospedaliero Medico INAIL Pediatra di libera scelta Guardia medica turistica Medico di azienda ospedaliero - universitaria Altro (tirocinanti, specializzandi, etc.) Altra specializzazione Codici validi per il Motivo Somministrazione, obbligatorio nel caso in cui vaccinazione viene effettuata per l assistito minore di 65 anni, nel caso di Programma di vaccinazione con vaccino anti-pneumococcico coniugato (PCV) 13- valente. Per altri tipi di vaccinazione questa tabella non è applicabile. 1 Cardiopatie croniche 2 Malattie polmonari croniche 3 Diabete Mellito 4 Epatopatie croniche 5 Alcoolismo cronico 6 Soggetti con perdite liquorali da traumi o intervento 7 Presenza di impianto cocleare 8 Emonoglobinopatie quali anemia falciforme e talassemia 9 Immunodeficienze congenite o acquisite 10 Infezione da HIV 11 Condizioni di asplenia anatomica o funzionale e pazienti candidati alla splenectomia. 12 Patologie onco-ematologiche (leucemie, linfomi e mieloma multiplo) 13 Neoplasie diffuse 14 Trapianto d'organo o di midollo 15 Patologie richiedenti un trattamento immunosoppressivo a lungo termine 16 Sindrome nefrosica o insufficienza renale cronica Il Luogo di somministrazione del vaccino: 1 Studio MMG/PLS 2 Domicilio assistito 3 Centro Vaccinale Codifica Vaccini: 001 POLIO SABIN 002 POLIO SALK 003 DIFTERITE 004 ANTITETANICA 005 PERTOSSE 10

11 006 EPATITE B PEDIATRICA 007 EPATITE B ADULTI 008 EPATITE A PEDIATRICA 009 EPATITE A ADULTI 010 MORBILLO 011 PAROTITE 021 RABBIA 022 MENINGOCOCCO 023 COLERA 024 FEBBRE GIALLA 012 ROSOLIA 013 VARICELLA 014 HAEMOPHILUS INFLUENZAE 015 PNEUMOCOCCO PEDIATRICO 016 ANTI-PNEUMOCOCCICO CONIUGATO (PCV) 13-VALENTE 017 INFLUENZA 018 TUBERCOLOSI 019 TIFO ORALE 020 TIFO PARENTERALE 025 ENCEFALITE CENTRO EUROPEA 026 ENCEFALITE GIAPPONESE 027 VAIOLO 028 ANTI-PNEUMOCOCCICO POLISACCARIDICO (PPV) 23-VALENTE 051 DIFTERITE TETANO PEDIATRICO 052 DIFTERITE TETANO PER ADULTI 053 EPATITE A+B PEDIATRICO 054 EPATITE A+B ADULTI 055 DIFTERITE TETANO PERTOSSE 056 MORBILLO PAROTITE ROSOLIA 057 DIFTERITE TETANO POLIO SALK 058 TETRAVALENTE (D,T,P,EPB) 059 PENTAVALENTE (D,T,P,HIB,IPV) 060 PENTAVALENTE (D,T,P,EPB,IPV) Campi di output Per ogni richiesta, il sistema risponde con un messaggio di tipo InvioVaccinazioniRicevuta, contenente l'esito della trasmissione. Formato dell'elemento InvioVaccinazioniRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note dataricezione Data di ricezione codesitoop esito dell operazione di inserimento = inserimento andata a buon fine senza presenza di segnalazioni = inserimento andata a buon fine ma con presenza di record scartati = inserimento e non avvenuta. 11

12 Nome Campo Contenuto Note Ripetizione di EsitoVaccinazioni codesito esito Per i valori si faccia riferimento al documento specifico. Esito esito Per i valori si faccia riferimento al documento specifico. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto codicefiscaleassist ito Fiscale Assistito del record a cui fa riferimento il messaggio. 1.3 Comunicazione annullamento registrazione delle vaccinazioni Accesso al servizio L indirizzo per accedere al servizio di test è: Sarà comunicato ad avvenuto collaudo l indirizzo per raggiungere i servizi esposti in ambiente di produzione del servizio Tramite questo servizio è possibile comunicare l annullamento di una registrazione di una somministrazione del vaccino per l assistito Campi di input Operazione utilizzata è annullavaccinazione. degli elementi costitutivi del messaggio di richiesta (InvioAnnullaVaccinazioniRichiesta): Campo Contenuto Tipo codicefiscalemedico Fiscale Medico che effettua somministrazione Obbligatorio codiceregione Regione Obbligatorio codiceaslcomp ASL di competenza Medico Obbligatorio codicecentrovaccinale Centro Vaccinale. (Il del Centro Vaccinale è Opzionale pubblicato su specializzazionemedico Specializzazione del medico. Come dalla codifica di SOGEI. Obbligatorio codicefiscaleassistito Fiscale Assistito Obbligatorio codiceprogvaccinale programma vaccinale. Opzionale 12

13 Campo Contenuto Tipo Nel caso di Programma di vaccinazione con vaccino antipneumococcico coniugato (PCV) 13-valente inserire il valore: 001. Altrimenti lasciare il campo nullo. numdose Numero Dose Obbligatorio codicevaccino Vaccino. Obbligatorio Nel caso di Programma di vaccinazione con vaccino antipneumococcico coniugato (PCV) 13-valente inserire il valore: 016. Per la comunicazione delle altre vaccinazioni, utilizzare i codici presenti nella tabella della codifica dei vaccini. datasomministrazione Data Somministrazione Obbligatorio dataregistrazione Data Registrazione Obbligatorio Campi di output Per ogni richiesta, il sistema risponde con un messaggio di tipo InvioAnnullaVaccinazioniRicevuta, contenente l'esito della trasmissione. Formato dell'elemento InvioAnnullaVaccinazioniRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note dataricezione Data di ricezione codesitoop esito dell operazione di eliminazione = eliminazione andata a buon fine senza presenza di segnalazioni = eliminazione andata a buon fine ma con presenza di segnalazioni = eliminazione non avvenuta. Ripetizione di EsitoVaccinazioni codesito esito Per i valori si faccia riferimento al documento specifico. Esito esito Per i valori si faccia riferimento al documento specifico. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante, AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto 13

14 4 Ambiente di test e servizi 1.4 URL Servizi Di seguito URL di accesso ai servizi in ambiente di test: Servizio Registrazione Vaccini Comunicazione annullamento di una registrazione 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: WsSAR Dati DB di test L utente/medico mario.rossi.17 corrisponde al Fiscale PROVAX00X00X000Y, 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 MZZTZN78P52H501X DNLRNT30R45I418T BRNFNC70L61H501H DRSMRS61P55H501B FSTFDN29H21A746J FRRGNI56A02G273S MRNPLA49P24H501W 14

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 15