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 Descrizione 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 5 16/10/2017 Aggiornamento password servizi 6 16/02/2018 Aggiornamento strutture della request e response del servizio di invio vaccinazioni 7 16/02/2018 Eliminato paragrafo /06/2018 Eliminato paragrafo 1.2 Aggiornamento strutture della request del servizio di invio vaccinazione Inserito nuovo paragrafo 3.3 Inserito nuovo capitolo 4 Inserito nuovo capitolo 5 Inserite nuove tabelle di codifica e di codici errore Inserito nuovo metodo di consultazione vaccinazione effettuate Modificato Paragrafo 6.1 specificato modalità corretta per il download del wsdl dei servizi (Importante) 9 28/08/2018 Modificato paragrafo 4.1 condizione di controllo per il campo Motivo della somministrazione. Modificato paragrafo 6.3 riferimento ad utenza/medico da utilizzare in ambiente di test. 2

3 Indice 1 INTRODUZIONE DESCRIZIONE DEI SERVIZI DI INTEGRAZIONE AUTENTICAZIONE PER L ACCESSO AI SERVIZI SERVIZI DISPONIBILI COMUNICAZIONE REGISTRAZIONE DELLE VACCINAZIONI Accesso al servizio Descrizione del servizio COMUNICAZIONE ANNULLAMENTO REGISTRAZIONE DELLE VACCINAZIONI Accesso al servizio Descrizione del servizio RICHIESTA ELENCO VACCINAZIONI REGISTRATE Accesso al servizio Descrizione del servizio CONTROLLI FORMALI PER LA REGISTRAZIONE DEL VACCINO CONTROLLI FORMALI PER IL VACCINO PER L INFLUENZA CONTROLLI FORMALI PER IL VACCINO ANTI-PNEUMOCOCCICO POLISACCARIDICO (PPV) 23-VALENTE TABELLA CODICI CODICI CODICI DI ERRORE Servizio di registrazione vaccinazione Servizio di annullamento vaccinazione Servizio di elenco vaccinazione 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 e relativa consultazione. 4

5 2 Descrizione dei Servizi di integrazione I servizi esposti sono destinati a tutti gli attori che utilizzano il software di Cartella Clinica e devono trasmettere e recuperare dalla Regione le registrazioni delle somministrazioni dei vaccini. Di seguito i servizi web esposti: Servizio Comunicazione registrazione somministrazione del vaccino. Comunicazione annullamento di una registrazione Recupero elenco vaccinazioni somministrate. Descrizione Tramite questo servizio è possibile comunicare avvenuta registrazione di somministrazione del vaccino. Tramite questo servizio è possibile comunicare annullamento di una registrazione del vaccino. Tramite questo servizio è possibile recuperare la totalità delle somministrazioni che un medico MMG ha effettuato per un determinato vaccino. 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 utilizzo dei credenziali del medico prescrittore, che utilizza il software di terzi parti, registrate nel sistema regionale di Access Management OpenSSO. 5

6 3 Servizi Disponibili 3.1 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 Descrizione del servizio Tramite questo servizio è possibile comunicare una o più registrazioni delle somministrazioni dei vaccini per gli assistiti Campi di input Operazione utilizzata è inviovaccinazioni. Descrizione degli elementi costitutivi del messaggio di richiesta (InvioVaccinazioniRichiesta), Campo Contenuto Tipo codicefiscalemedico Codice Fiscale Medico che effettua somministrazione Obbligatorio codiceaslmedico Codice ASL di competenza Medico (i codici sono definiti nella Obbligatorio tabella sottostante) codicecentrovaccinale Codice Centro Vaccinale. (Il Codice 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 Codice Fiscale Assistito. E obbligatorio per i Soggetti presenti codiceprogvaccinale nell anagrafe regionale Codice programma vaccinale. E obbligatorio: nel caso di Programma di vaccinazione antipneumococcica (programma unico valido sia per il vaccino anti-pneumococcico coniugato (PCV) 13-valente e sia per Obbligatorio Opzionale 6

7 Campo Contenuto Tipo il vaccino anti-pneumococcico polisaccaridico (PPV) 23- valente) nel caso di Programma di vaccinazione antinfluenzale I codici sono presenti nella specifica tabella del paragrafo 5.1 codicevaccino Codice Vaccino. Utilizzare i codici presenti nella specifica tabella Obbligatorio del paragrafo 5.1 datasomministrazione Data Somministrazione Obbligatorio dataregistrazione Data Registrazione Obbligatorio numdose Numero Dose Obbligatorio numlotto Numero Lotto Opzionale codicelotto Codice Lotto Opzionale motivosomministrazione Motivo Somministrazione. E' obbligatorio: Opzionale nel caso di Programma di vaccinazione con vaccino antipneumococcico coniugato (PCV) 13-valente) per gli assistiti con età inferiore a 65 anni. nel caso di Programma di vaccinazione con vaccino antipneumococcico polisaccaridico (PPV) 23-valente per gli assistiti con età inferiore a 65 anni. nel caso di Programma di vaccinazione con vaccino per l influenza. I codici sono presenti nella specifica tabella del paragrafo 5.1 luogosomministrazione Luogo Somministrazione. I codici sono presenti nella specifica Obbligatorio tabella del paragrafo 5.1 nomecommercialevaccino Nome Commerciale del Vaccino. E obbligatorio nel caso di Programma di vaccinazione con vaccino per l influenza I codici sono presenti nella specifica tabella del paragrafo 5.1 Opzionale Campi di output Per ogni richiesta, il sistema risponde con un messaggio di tipo InvioVaccinazioniRicevuta, contenente l'esito della trasmissione. 7

8 Formato dell'elemento InvioVaccinazioniRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note dataricezione Data di ricezione codesitoop Codice 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. Ripetizione di EsitoVaccinazioni codesito Codice esito Per i valori si faccia riferimento alla tabella di seguito riportata. Esito Descrizione esito Per i valori si faccia riferimento alla tabella di seguito riportata. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto codicefiscaleassist ito Codice Fiscale Assistito del record a cui fa riferimento il messaggio o Identificativo in caso il soggetto non è presente nell anagrafe regionale. codicevaccino Codice Vaccino Valore del Vaccino per il quale fa riferimento l esito codiceprogvaccinal e Codice programma vaccinale Valore della campagna vaccinale per il quale fa riferimento l esito 3.2 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 Descrizione del servizio Tramite questo servizio è possibile comunicare l annullamento di una registrazione di una somministrazione del vaccino per l assistito. 8

9 Campi di input Operazione utilizzata è annullavaccinazione. Descrizione degli elementi costitutivi del messaggio di richiesta (InvioAnnullaVaccinazioniRichiesta): Campo Contenuto Tipo codicefiscalemedico Codice Fiscale Medico che effettua somministrazione Obbligatorio codiceregione Codice Regione Obbligatorio codiceaslcomp Codice ASL di competenza Medico Obbligatorio codicecentrovaccinale Codice Centro Vaccinale. (Il Codice del Centro Vaccinale è Opzionale pubblicato su specializzazionemedico Specializzazione del medico. Come dalla codifica di SOGEI. Obbligatorio codicefiscaleassistito Codice Fiscale Assistito Obbligatorio codiceprogvaccinale Codice programma vaccinale. E obbligatorio: Opzionale nel caso di Programma di vaccinazione antipneumococcica (programma unico valido sia per il vaccino anti-pneumococcico coniugato (PCV) 13-valente e sia per il vaccino anti-pneumococcico polisaccaridico (PPV) 23-valente) nel caso di Programma di vaccinazione antinfluenzale I codici sono presenti nella specifica tabella del paragrafo 5.1 numdose Numero Dose Obbligatorio codicevaccino Codice Vaccino. Utilizzare i codici presenti nella specifica tabella Obbligatorio del paragrafo 5.1 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: 9

10 Nome Campo Contenuto Note dataricezione Data di ricezione codesitoop Codice 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 Codice esito Per i valori si faccia riferimento al documento specifico. Esito Descrizione 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 3.3 Richiesta elenco vaccinazioni registrate 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 Descrizione del servizio Tramite questo servizio è possibile ottenere l elenco delle vaccinazioni registrate da un singolo MMG/PLS Campi di input Operazione utilizzata è elencovaccinazioni. Descrizione degli elementi costitutivi del messaggio di richiesta (ElencoVaccinazioniRichiesta): 10

11 Campo Contenuto Tipo codicefiscalemedico Codice Fiscale Medico che ha effettuato le somministrazioni Obbligatorio codiceregione Codice Regione Obbligatorio codiceaslcomp Codice ASL di competenza Medico Obbligatorio codicecentrovaccinale codiceprogvaccinale codicevaccino datainizioricercavaccinazione datafinericercavaccinazione Codice Centro Vaccinale. (Il Codice del Centro Vaccinale è Opzionale pubblicato su Codice programma vaccinale. Opzionale E obbligatorio: nel caso di Programma di vaccinazione antipneumococcica (programma unico valido sia per il vaccino anti-pneumococcico coniugato (PCV) 13- valente e sia per il vaccino anti-pneumococcico polisaccaridico (PPV) 23-valente) nel caso di Programma di vaccinazione antinfluenzale I codici sono presenti nella specifica tabella del paragrafo 5.1 Codice Vaccino. Utilizzare i codici presenti nella specifica Obbligatorio tabella del paragrafo 5.1 Data di inizio delle vaccinazioni per cui filtrare la ricerca Opzionale (formato dd/mm/yyyy). Il filtro di ricerca è applicato al campo data somministrazione. Data di fine vaccinazione per cui filtrare la ricerca (formato Opzionale dd/mm/yyyy). Il filtro di ricerca è applicato al campo data somministrazione Campi di output Per ogni richiesta, il sistema risponde con un messaggio di tipo ElencoVaccinazioniRicevuta, contenente l elenco delle informazioni richieste. Formato dell'elemento ElencoVaccinazioniRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note dataricezione Data di ricezione codesito Codice esito dell operazione di ricerca. Vedere tabella relativa al servizio descresito Descrizione esito dell'operazione di ricerca Vedere tabella relativa al servizio Ripetizione di DettaglioAssistitoVaccinazione 11

12 Nome Campo Contenuto Note codicefiscaleassistito nomeassistito cognomeassistito sessoassistito datanascitaassistito indirizzoresidenzaassistito comuneresidenzaassistito numdose datasomministrazione dataregistrazione numlotto codicelotto motivosomministrazione luogosomministrazione nomecommercialevaccino Codice fiscale del Soggetto Vaccinato Nome del Soggetto Vaccinato Cognome del Soggetto Vaccinato Sesso del Soggetto Vaccinato Data di Nascita del Soggetto Vaccinato Indirizzo di Residenza del Soggetto Vaccinato Comune di Residenza del Soggetto Vaccinato Numero ordinale della dose registrata Data somministrazione della dose Data di registrazione della somministrazione Numero Lotto Codice Lotto Motivo della Somministrazione Luogo della Somministrazione Nome Commerciale del Vaccino 12

13 4 Controlli formali per la registrazione del vaccino 4.1 Controlli formali per il Vaccino per l Influenza Il campo Data Vaccinazione, non deve essere antecedente la data Inizio Campagna Vaccinale e non deve essere successiva alla data Fine Campagna Vaccinale. Inoltre non può essere successiva alla data di inserimento (non possono essere registrate vaccinazioni ancora da effettuate). Per il campo Numero Dose, è possibile l inserimento sia di una 1 che di una 2 dose, non necessariamente in quest ordine. Qualora si inserisca una 2 dose ad un paziente a cui è stata registrata la 1 dose, questa deve riportare la stessa motivazione inserita per la 1 dose e la data vaccinazione deve in ogni caso essere successiva almeno di un giorno alla data inserimento per la 1 dose. Per il campo di input Motivo, devono essere verificate le condizioni di coerenza con altri campi di seguito riportate: Codice Motivo Descrizione Motivo Data Nascita 1 Età >= 65 anni >=65 anni(**) 2 Malattie dell apparato respiratorio di cui al punto 2 del Protocollo 3 Malattie croniche dell apparato cardio-circolatorio 4 Diabete mellito 5 Altre malattie metaboliche (inclusi gli obesi con BMI > 30) 6 Epatopatie croniche 7 Insufficienza renale/surrenale cronica 8 Malattie degli organi emopoietici ed emoglobinopatie 9 Malattie congenite o acquisite che comportino deficit immunitario 10 Malattie infiammatorie croniche e sindromi da malassorbimento intestinale 11 Patologie per le quali sono programmati importanti interventi chirurgici 12 Tumori 13 Patologie associate ad un aumentato rischio di aspirazione delle secrezioni respiratorie 14 Soggetti di età superiore a 6 mesi e inferiore a 18 anni in trattamento a lungo termine con acido acetilsalicilico, a rischio di sindrome di Reye in caso di infezione influenzale 15 Donne nel 2 e 3 trimestre di gravidanza all inizio della stagione epidemica >= 0.5 anni(*) and < 18 anni(*) >=12 anni(*) and <=53 anni(*) Sesso Luogo =F Somministrazione 13

14 Codice Motivo Descrizione Motivo 16 Individui di qualunque età ricoverati in strutture per lungodegenti Data Nascita 17 Medici e personale sanitario di assistenza >=15 anni(*) 18 Familiari e contatti di soggetti ad alto rischio 19 Personale delle Forze dell Ordine(Polizia di Stato, >=18 anni(*) Polizia Locale, Carabinieri Guardia di Finanza, Polizia Penitenziaria), Vigili del Fuoco e personale della protezione civile 20 Personale che, per motivi occupazionali, è a contatto >=15 anni(*) con animali che potrebbero costituire fonte d infezione da virus influenzali 21 Altri soggetti addetti a servizi pubblici di primario >=15 anni(*) interesse collettivo 22 Donatore di sangue >= 18 anni(*) Sesso Luogo Somministrazione = Struttura di ricovero ospedaliero per postacuzie (*): da verificare rispetto alla data di vaccinazione; (**):da verificare rispetto alla data del 31/12 dell anno di inizio campagna vaccinale (es: considerare la data del 31/12/2018 per la campagna vaccinale 2018/19); 4.2 Controlli formali per il Vaccino anti-pneumococcico polisaccaridico (PPV) 23-valente Per il campo Data Vaccinazione, non è previsto una data Inizio Campagna Vaccinale e una data di Fine Campagna Vaccinale. Inoltre non può essere successiva alla data di inserimento (non possono essere registrate vaccinazioni ancora da effettuare). Per il campo Numero Dose, è previsto l inserimento solo della 1 dose. La registrazione di una nuova vaccinazione è subordinata al verificarsi di 4 condizioni di seguito elencate: 1. il soggetto ha un età superiore ai 5 anni; 2. è già vaccinato con vaccino coniugato anti-pneumococcico 13-valente; 3. la vaccinazione per il vaccino coniugato anti-pneumococcico 13-valente deve essere stata eseguita a partire dall 1 gennaio 2017; 4. la vaccinazione per PPV 23 valente è da erogare a distanza di almeno un anno dalla somministrazione del vaccino anti-pneumococcico 13-valente; 14

15 5 Tabella codici 5.1 Codici Codici ASL Codice 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 Descrizione ASL Codici Programma Vaccinale Codice Programma Vaccinale Descrizione Programma Vaccinale Data Inizio Campagna Data Fine Campagna 001 Programma di Vaccinazione anti-pneumococcica (programma unico valido sia per il vaccino antipneumococcico coniugato (PCV) 13-valente e sia per il vaccino anti-pneumococcico polisaccaridico (PPV) 23- valente) Programma di Vaccinazione anti-influenzale /10/ /01/2019 Codici delle Specializzazione Medico Codice A B C D F G H I P T Descrizione Specialista Ambulatoriale (Ex Sumai) Medico consulente Specialista di struttura privata accreditata Dipendente dei servizi territoriali ASL Medico di medicina generale Guardia medica Ospedaliero Medico INAIL Pediatra di libera scelta Guardia medica turistica 15

16 Codice U X Z Descrizione Medico di azienda ospedaliero - universitaria Altro (tirocinanti, specializzandi, etc.) Altra specializzazione Codici per il Motivo Somministrazione Codici Validi per il campo Motivazione per il vaccino anti-pneumococcico coniugato (PCV) 13 Codice valente e per il vaccino anti-pneumococcico polisaccaridico (PPV) 23-valente Descrizione 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 Codici Validi per il campo Motivazione per il vaccino per l influenza Codice Descrizione 1 Età >= 65 anni 2 Malattie dell apparato respiratorio di cui al punto 2 del Protocollo 3 Malattie croniche dell apparato cardio-circolatorio 4 Diabete mellito 5 Altre malattie metaboliche (inclusi gli obesi con BMI > 30) 6 Epatopatie croniche 7 Insufficienza renale/surrenale cronica 8 Malattie degli organi emopoietici ed emoglobinopatie 9 Malattie congenite o acquisite che comportino deficit immunitario 10 Malattie infiammatorie croniche e sindromi da malassorbimento intestinale 11 Patologie per le quali sono programmati importanti interventi chirurgici 12 tumori 13 Patologie associate ad un aumentato rischio di aspirazione delle secrezioni respiratorie 16

17 Codice Codici Validi per il campo Motivazione per il vaccino per l influenza Descrizione 14 Soggetti di età superiore a 6 mesi e inferiore a 18 anni in trattamento a lungo termine con acido acetilsalicilico, a rischio di sindrome di Reye in caso di infezione influenzale 15 Donne nel 2 e 3 trimestre di gravidanza all inizio della stagione epidemica 16 Individui di qualunque età ricoverati in strutture per lungodegenti 17 Medici e personale sanitario di assistenza 18 Familiari e contatti di soggetti ad alto rischio 19 Personale delle Forze dell Ordine(Polizia di Stato, Polizia Locale, Carabinieri Guardia di Finanza, Polizia Penitenziaria), Vigili del Fuoco e personale della protezione civile 20 Personale che, per motivi occupazionali, è a contatto con animali che potrebbero costituire fonte d infezione da virus influenzali 21 Altri soggetti addetti a servizi pubblici di primario interesse collettivo 22 Donatore di sangue Codici per il Luogo di Somministrazione Codice Codici Validi per il campo Luogo di somministrazione per il vaccino per l'influenza Descrizione 1 Studio medico/ambulatorio 2 RSA 3 Altra struttura residenziale o semiresidenziale 4 Domicilio dell assistito 5 Struttura di ricovero ospedaliero per acuzie 6 Struttura di ricovero ospedaliera per post acuzie 7 Altro Codici Validi per il campo Luogo di somministrazione per tutti gli altri vaccini Codice 1 Studio MMG/PLS 2 Domicilio assistito 3 Centro Vaccinale Descrizione Codici per il Vaccino 17

18 Codice Descrizione 001 POLIO SABIN 002 POLIO SALK 003 DIFTERITE 004 ANTITETANICA 005 PERTOSSE 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) Codifica Nome Commerciale del Vaccino 18

19 Nome commerciale vaccino per il vaccino per l'influenza per la Campagna anti-influenzale Codice 1 Fluarix Tetra 2 Influvac S Tetra 3 Vaxigrip Tetra 4 Fluad 5.2 Codici di errore Descrizione Di seguito vengono elencati i codici di errori restituiti da ciascun servizio Servizio di registrazione vaccinazione codesito Esito tipoerrore I00 Inserimento riuscito. SUCCESSO EI02 Assistito assente o cf non corretto. BLOCCANTE EI03 Richiamo (num Dose) assente BLOCCANTE EI04 Specializzazione non presente o parametro non BLOCCANTE corretto EI05 Data somministrazione assente BLOCCANTE EI07 Centro vaccinale assente BLOCCANTE EI08 Medico vaccinatore non trovato BLOCCANTE EI09 Motivo vaccinazione non trovato BLOCCANTE EI10 Errore generico con descrizione completa dell'errore BLOCCANTE EI11 Data registrazione obbligatoria BLOCCANTE EI12 Errore tecnico. BLOCCANTE EI13 Campagna obbligatoria per il vaccino specificato BLOCCANTE EI14 Vaccino non specificato o assente in archivio BLOCCANTE EI15 Campagna non presente in archivio BLOCCANTE EI16 Luogo non specificato o assente in archivio BLOCCANTE EI17 E' necessario specificare una asl del medico BLOCCANTE EI18 Asl non trovata BLOCCANTE EI19 Formato data somministrazione non valido. Formato BLOCCANTE valido dd/mm/yyyy EI20 Formato data registrazione non valido. Formato BLOCCANTE valido dd/mm/yyyy EI21 Vaccinazioni non specificate BLOCCANTE Nel caso di codesito EI10, è riportato di seguito l elenco delle descrizioni complete, dei possibili errori: CONTROLLI GENERICI o Nessuna campagna vaccinale valida trovata o La campagna vaccinale non prevede vaccini o La campagna vaccinale non prevede il vaccino fornito o Il richiamo deve essere successivo al suo richiamo precedente o Il richiamo deve essere precedente al suo richiamo successivo 19

20 o Il richiamo non può essere successivo alla data odierna o Il luogo di vaccinazione è un dato obbligatorio da fornire o Il luogo di vaccinazione fornito, non è un luogo valido per questo vaccino CAMPAGNA ANTI-PNEUMOCOCCICA o VACCINO ANTIPNEUMOCOCCICO CONIUGATO 13-VALENTE (PVC) Campagna vaccinale non applicabile ad assistiti minori di 2 anni Per tutti i soggetti inseriti nel Programma Regionale di vaccinazione con vaccino antipneumococcico coniugato (PCV) 13-valente è raccomandata la somministrazione di una unica dose del vaccino. Solo per soggetti di età >= 2 anni e < 6 anni è raccomandata la somministrazione di una seconda dose del vaccino a due mesi di distanza dalla prima Numero ordinale dose non prevista per questo vaccino Per questo vaccino non possono essere somministrati più di due richiami Le vaccinazioni registrate in data precedente o uguale al XX/XX/XXXX non possono essere eliminate. Campagna vaccinale non applicabile senza motivo di vaccinazione, ad assistiti minori di 65 anni L'assistito è già stato vaccinato per questo vaccino con la dose specificata o VACCINO ANTIPNEUMOCOCCICO POLISACCARIDICO 23-VALENTE (PPV) Numero ordinale dose non prevista per questo vaccino Per questo vaccino non possono essere somministrati più di due richiami Campagna vaccinale non applicabile ad assistiti minori di 5 anni Per i soggetti non vaccinati con almeno una dose di vaccino coniugato 13-valente non è possibile effettuare la vaccinazione di Polisaccaridico (PPV) 23-valente Non è possibile vaccinare soggetti vaccinati prima del 01/01/2017 con vaccino coniugato 13-valente Per soggetti vaccinati in precedenza con vaccino coniugato 13-valente è possibile somministrare il vaccino Polisaccaridico (PPV) 23-valente solo dopo un anno dall'ultima dose di coniugato 13-valente Campagna vaccinale non applicabile senza motivo di vaccinazione, ad assistiti minori di 65 anni CAMPAGNA ANTIINFLUENZALE o VACCINO PER L INFLUENZA Per questo vaccino non possono essere somministrati più di due richiami Numero ordinale dose non prevista per questo vaccino L'assistito è già stato vaccinato per questo vaccino con la dose specificata Il nome commerciale del vaccino per questa campagna vaccinale è un dato obbligatorio Il nome commerciale del vaccino fornito non è valido Il motivo per questa campagna vaccinale è un dato obbligatorio Il motivo utilizzato non è compatibile con gli altri campi inseriti Il motivo della somministrazione deve essere lo stesso in entrambe le dosi somministrate Servizio di annullamento vaccinazione codesito Esito tipoerrore A00 Annullamento riuscito. SUCCESSO EA02 Assistito assente o cf non corretto. BLOCCANTE EA03 Richiamo (num Dose) assente BLOCCANTE EA05 Data somministrazione assente BLOCCANTE EA07 Centro vaccinale assente BLOCCANTE EA08 Medico vaccinatore non trovato BLOCCANTE EA11 Data registrazione obbligatoria BLOCCANTE EA12 Errore tecnico. BLOCCANTE 20

21 codesito Esito tipoerrore EA14 Vaccino non specificato o assente in archivio BLOCCANTE EA15 Campagna non presente in archivio BLOCCANTE EA16 Codice regione non presente o errata BLOCCANTE EA17 Campagna obbligatoria per il vaccino specificato BLOCCANTE EA18 Errore generico con descrizione completa dell'errore BLOCCANTE EA19 Formato data somministrazione non valido. Formato BLOCCANTE valido dd/mm/yyyy EA20 Formato data registrazione non valido. Formato BLOCCANTE valido dd/mm/yyyy EA21 Errore logico in fase annullamento vaccinazione. BLOCCANTE Servizio di elenco vaccinazione codesito Esito tipoerrore E01 Il campo Asl è un campo obligatorio BLOCCANTE E02 Asl non valida BLOCCANTE E03 Il campo specializzazione medico è un campo BLOCCANTE obligatorio E04 Specializzazione medico non valida BLOCCANTE E05 Medico non valido BLOCCANTE E06 Centro vaccinale non valido E07 Il campo codice vaccino è un campo obligatorio BLOCCANTE E08 Formato data non valido. Formato valido dd/mm/yyyy BLOCCANTE 21

22 6 Ambiente di test e servizi 6.1 URL Servizi Di seguito URL di accesso ai servizi in ambiente di test: Servizio Registrazione Vaccini Comunicazione annullamento di una registrazione Recupero elenco vaccinazioni registrate Descrizione Per il recupero del wsdl dei servizi (VacciniService.wsdl), accedere alla index page (sezione download) alla seguente url: 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!! 6.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 MZZTZN78P52H501X 22

23 Codici Fiscali DNLRNT30R45I418T BRNFNC70L61H501H DRSMRS61P55H501B FSTFDN29H21A746J FRRGNI56A02G273S MRNPLA49P24H501W CLLRLB40E49F158K SNTDNL53M62G601J PTRMSM52D13E472R CNGCNZ58B57H501N RFFRZE69E43H501E DRNMRC81A15B114I MRTSDR65R24H501U BRRNNZ38P50H501X NGLMRP39A46A515Y PSCMLS29H51F656G AAXAAA00A50H5L1O LTTGRG56T20Z336N SNTFLC80A12H501S CLLRSM27B10D708K DRNPRZ61E53H501T PRLCRM35E69F970Y SNTCRL55B23H501D RCCVLE20E57E799B MRTVCN57C12F734X CSSFRC78B21H501T BNVNNA50S66H501S LRTBRC44P54G232R PTRBBR68D46H501N 23

24 Codici Fiscali DPLNDR48E21L120B 24