Specifiche per l integrazione delle Aziende e degli Applicativi Regionali con i servizi del Sistema di Accoglienza Regionale (SAR) della Regione Lazio

Transcript

1 Specifiche per l integrazione delle Aziende e degli Applicativi Regionali con i servizi del Sistema di Accoglienza Regionale (SAR) della Regione Lazio - Erogazione Ricette Dematerializzate 01/12/2016 1

2 Status del Documento Rev. Data Descrizione Modifica 1 21/12/2015 Prima versione 2 22/02/2016 Modifica delle URL di WS nel capitolo /02/2016 Correzioni 4 22/03/2016 Correzioni 5 23/05/2016 Aggiunta la spiegazione per utilizzo dell opzione 4 per la presa in carico della ricetta nel capitolo Modifica nel capitolo Aggiunta deli campi obbligatori nel messaggio di input per la trasmissione dell erogazione della ricetta. 6 30/09/2016 Modifica nel capitolo Il campo CfMedico1 è obbligatorio Modifica nel capitolo Aggiunto riferimento per la gestione di aggiunta del Prelievo con il codice _ /10/2016 Modificati endpoint dei servizi di test 8 01/12/2016 Modifica nei capitoli e Gestione del campo reddito. Il campo non deve essere valorizzato. 2

3 INDICE 1 INTRODUZIONE GLOSSARIO IL CONTESTO NORMATIVO DESCRIZIONE GENERALE DEL SISTEMA DESCRIZIONE GENERALE DEI SERVIZI D INTEGRAZIONE STATI DELLA RICETTA DEMATERIALIZZATA PROCESSI DI GESTIONE DELLA RICETTA DEMATERIALIZZATA E SERVIZI UTILIZZATI PROCESSO DI PRESA IN CARICO RICETTA DEMATERIALIZZATA La presa in carico della ricetta dematerializzata con esito positivo Presa in carico della ricetta dematerializzata tramite WS con esito negativo a causa dell errore formale Presa in carico della ricetta dematerializzata tramite Maschera Applicativa con esito negativo a causa dell errore formale La presa in carico della ricetta dematerializzata con esito negativo a causa del malfunzionamento del Sistema SAR La presa in carico della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema Erogatore Rilascio della presa in carico della ricetta dematerializzata con esito positivo PROCESSO EROGAZIONE RICETTA DEMATERIALIZZATA Erogazione totale della ricetta dematerializzata con esito positivo Erogazione parziale della ricetta dematerializzata con esito positivo Erogazione delle singole prestazioni della ricetta dematerializzata e chiusura della ricetta con esito positivo Erogazione della ricetta dematerializzata con esito negativo causa errore formale Erogazione della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema SAR Erogazione della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema Erogatore PROCESSO ANNULLAMENTO EROGAZIONE RICETTA DEMATERIALIZZATA Annullamento Erogazione della ricetta dematerializzata senza revoca di presa in carico con esito positivo Annullamento Erogazione della ricetta dematerializzata con revoca di presa in carico con esito positivo Annullamento Erogazione della ricetta dematerializzata con esito negativo causa errore formale Erogazione della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema SAR Erogazione della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema Erogatore PROCESSO DI REGISTRAZIONE EROGAZIONE IN DIFFERITA Comunicazione del malfunzionamento del Sistema Erogatore al Sistema SAR Trasmissione dell erogazione delle ricette in differita causa malfunzionamento SAR senza precedente comunicazione di presa in carico tramite i Servizi Trasmissione dell erogazione delle ricette in differita causa malfunzionamento SAR con precedente comunicazione di presa in carico tramite i Servizi Trasmissione di erogazione delle ricette in differita causa malfunzionamento del Sistema Erogatore senza precedente comunicazione di presa in carico tramite i Servizi Trasmissione dell erogazione delle ricette in differita causa malfunzionamento del Sistema Erogatore con precedente comunicazione di presa in carico tramite i Servizi Visualizzazione ricette trasmesse in differita Ricerca ricette trasmesse in differita Annullamento erogazione ricette trasmesse in differita

4 5 SERVIZI DISPONIBILI EROGAZIONE AUTENTICAZIONE PER L ACCESSO AI SERVIZI AUTENTICAZIONE PER L ACCESSO ALLE MASCHERE FUNZIONALE DEL SISTEMA SAR GESTIONE CREDENZIALI SCADUTE O INVALIDE PER WS CERTIFICATO DI PROTEZIONE VISUALIZZAZIONE E PRESA IN CARICO DELLA RICETTA DEMATERIALIZZATA Descrizione Servizio Accesso al servizio Descrizione messaggio di input Descrizione messaggio di output COMUNICAZIONE DELL EROGAZIONE E CHIUSURA DELLA RICETTA Descrizione Servizio Accesso al servizio Descrizione messaggio di input Descrizione messaggio di output ANNULLAMENTO DELL EROGAZIONE DELLA RICETTA Descrizione Servizio Accesso al servizio Descrizione messaggio di input Descrizione messaggio di output COMUNICAZIONE DI MALFUNZIONAMENTO DEL SISTEMA EROGATORE Descrizione Servizio Accesso al servizio Descrizione messaggio di input Descrizione messaggio di output RICERCA SEGNALAZIONE DEL MALFUNZIONAMENTO Descrizione Servizio Accesso al servizio Descrizione messaggio di input Descrizione messaggio di output COMUNICAZIONE EROGAZIONE DELLE RICETTE IN DIFFERITA Descrizione Servizio Accesso al servizio Descrizione messaggio di input Descrizione messaggio di output VISUALIZZAZIONE EROGAZIONI DELLE RICETTE IN DIFFERITA Descrizione Servizio Accesso al servizio Descrizione messaggio di input Descrizione messaggio di output RICERCA EROGAZIONE DELLE RICETTE IN DIFFERITA Descrizione Servizio Accesso al servizio Descrizione messaggio di input Descrizione messaggio di output COMUNICAZIONE ANNULLAMENTO EROGAZIONE DELLE RICETTE IN DIFFERITA Descrizione Servizio Accesso al servizio Descrizione messaggio di input

5 Descrizione messaggio di output RICHIESTA ERRORI COMUNICAZIONE EROGAZIONE DELLE RICETTE IN DIFFERITA Descrizione Servizio Accesso al servizio Descrizione messaggio di input Descrizione messaggio di output AMBIENTE DI TEST E SERVIZI URL SERVIZI ACCESSO AI SERVIZI DI EROGAZIONE DATI DB DI TEST CODIFICA DEGLI ERRORI ELABORAZIONE RICETTE ERRORI SAR ELENCO ALLEGATI

6 1 Introduzione Il presente documento descrive le specifiche tecniche e i processi relativi alla integrazione con il Sistema SAR per tutti i soggetti Regionali che erogano le prestazioni specialistiche sulla base delle ricette dematerializzate. Per ricetta dematerializzata si intende un documento redatto in modalità informatica da un medico prescrittore, provvisto di una numerazione univoca e inviato ad un sistema di accoglienza, il quale lo rende disponibile alle strutture di erogazione per la consultazione e, se sussistono le condizioni, per la sua chiusura in modalità informatica. In particolare: per ricetta dematerializzata si intende una ricetta medica contenente prescrizioni farmaceutiche o specialistiche, compilata in modalità informatica e non sul modello cartaceo stampato dall IPZS; per modalità informatica si intende l utilizzo: o o di sistemi gestionali in grado: di generare una ricetta secondo un determinato tracciato record, se utilizzati da un medico prescrittore, di fornire informazioni inerenti l erogazione, se utilizzati da una struttura di erogazione, di collegarsi ad un sistema di accoglienza per la trasmissione dei dati; di applicazioni web messe a disposizione dal sistema TS, tramite cui compilare la ricetta in fase di prescrizione e di fornire indicazioni inerenti l erogazione; per medico prescrittore si intende un soggetto autorizzato ad effettuare una prescrizione medica; per numerazione univoca si intende il Numero di Ricetta Elettronica (NRE), unico a livello nazionale, rilasciato dal Sistema di Accoglienza Centrale, con cui vengono contraddistinte le ricette dematerializzate; per sistema di accoglienza si intende un sistema centrale (SAC) o regionale (SAR) in grado di accogliere nei propri archivi le ricette dematerializzate inviate elettronicamente; per struttura di erogazione si intende una struttura autorizzata a somministrare quanto prescritto da un medico. La Regione Lazio, con nota prot. n del 10 novembre 2009, ha aderito all art. 4 comma 1 del DPCM 26 marzo 2008 stabilendo la realizzazione di un Sistema di Accoglienza Regionale (SAR) in grado di interagire con il Sistema di Accoglienza Centrale (SAC) predisposto dal Ministero dell Economia e Finanze (MEF) per la trasmissione telematica delle prescrizioni. 6

7 In questo scenario, il SAR costituisce il contenitore che accoglie tutte le prescrizioni dematerializzate, farmaceutiche e specialistiche, dei medici prescrittori della Regione Lazio e le relative registrazioni di erogazione delle ricette dematerializzate. 1.1 Glossario ASUR DPCM MEF NRE SAC SAR SASN SSN SSR Anagrafe Sanitaria Unica Regionale Decreto Presidente Consiglio dei Ministri Ministero dell Economia e della Finanze Numero Ricetta Elettronica Sistema di Accoglienza Centrale, che rappresenta l infrastruttura tecnologica del Ministero dell Economia e delle Finanze, per la ricezione dei dati delle ricette mediche trasmessi dagli utenti. Sistema di Accoglienza Regionale Servizio Assistenza Sanitaria personale Navigante Servizio Sanitario Nazionale Servizio Sanitario Regionale 7

8 2 Il contesto normativo Nella realizzazione del proprio Sistema Sanitario la Regione Lazio evolve il servizio seguendo quelle che sono le normative Nazionali e le indicazioni tecniche delle istituzioni preposte al coordinamento delle attività in materia sanitaria. Il Tavolo Permanente per la Sanità Elettronica (TSE) delle Regioni e delle Province Autonome propone l armonizzazione degli interventi e la definizione di un quadro di regole tecniche condivise per la Sanità Elettronica. In dettaglio i riferimenti sono: 1. Legge finanziaria 2003 (art. 50, comma 1 del DL 30 settembre 2003, n. 269, convertito, con modificazioni, dalla legge 24 novembre 2003, n. 326), che rappresenta la normativa di riferimento del progetto monitoraggio della spesa sanitaria. 2. Legge finanziaria 27 dicembre 2006, n. 296, articolo 1, comma 810, lettera c) che dispone la trasmissione dei dati delle ricette da parte dei medici prescrittori al Ministero dell Economia e delle Finanze. 3. DPCM 26 marzo 2008 attuativo del comma 810, che rappresenta la normativa di riferimento del progetto Collegamento in rete dei Medici. Tale decreto è suddiviso in articoli, di cui i principali sono: a) Art 1: principi generali relativi alle modalità di trasmissione. In esso viene stabilito: che la modalità di trasmissione delle ricette al MEF avviene nell ambito del SPC; quali sono le possibilità che gli utenti hanno per autenticarsi; che il Ministero dell economia e della finanze (di seguito MEF), d intesa con il Dipartimento Innovazioni Tecnologiche della Presidenza del Consiglio dei Ministri (DIT) e il Centro Nazionale Informatica Pubblica Amministrazione (CNIPA) predispone gli accordi di servizio con le amministrazioni interessate. b) Art. 2: trattamento dei dati e obbligo di riservatezza. c) Art. 3: Infrastrutture regionali: le Regioni devono comunicare al MEF quali sono le infrastrutture regionali esistenti in grado di fornire servizi di connettività agli utenti e interoperare con le infrastrutture di cooperazione applicativa del Sistema di Accoglienza Centrale (di seguito SAC). La valutazione viene effettuata dal MEF d accordo con il DIT e il CNIPA. d) Art. 4: programma di applicazione per la trasmissione delle ricette: si dà la possibilità alle Regioni di aderire al comma 1 di tale articolo e di poter trasmettere i dati delle ricette dei propri medici, sostituendosi a questi ultimi. La valutazione viene effettuata dal MEF d accordo con il DIT e il CNIPA. 8

9 e) Art. 5: definizione dei dati delle ricette. 4. Decreto del 2 novembre 2011 il Ministero dell'economia e delle Finanze (MEF) ha stabilito la "Dematerializzazione della ricetta medica cartacea, di cui all'articolo 11, comma 16, del decreto-legge n. 78 del 2010 (Progetto Tessera Sanitaria)" (rif. (D02/11/2011)) che, ai fini dell'attuazione di quanto appunto previsto dall'art 11, comma 16, ultimo periodo del decreto-legge 31 maggio 2010, n. 78 (convertito con modificazioni dalla legge 30 luglio 2010, n. 122), prevede che la ricetta cartacea, di cui al D.P.C.M. 26 marzo 2008, è sostituita dalla ricetta elettronica generata dal medico prescrittore secondo le modalità di cui al disciplinare tecnico allegato 1 che costituisce parte integrante del decreto. 9

10 3 Descrizione generale del Sistema 3.1 Descrizione generale dei Servizi d integrazione Il Sistema SAR espone i Servizi Web per dare la possibilità ai software di terzi parti di comunicare con il SAR ai fini di registrazione delle erogazioni delle ricette dematerializzate. L erogazione di una ricetta dematerializzata si divide in due momenti: Visualizzazione del contenuto della ricetta dematerializzata prescritta con contestuale presa in carico in maniera esclusiva della stessa, Comunicazione di chiusura dell erogazione a seguito di vendita del farmaco o dispensazione di prestazioni specialistiche. I servizi esposti sono disponibili per la registrazione delle erogazioni delle ricette dematerializzate solo per le prescrizioni specialistiche. Gli Attori principali che utilizzeranno i servizi esposti sono: Sistemi Informativi CUP delle strutture e ambulatori privati. Inoltre il Sistema SAR mette a disposizione le maschere funzionali applicative, che permettono alle strutture e agli ambulatori, ancora non integrati tramite i servizi web, di visualizzare e prendere in carico le ricette dematerializzate specialistiche direttamente tramite Sistema SAR. I servizi che il SAR espone verso i software di terzi parti sono realizzati, con le specifiche corrispondenti ai servizi esposti dal SAC del MEF. Nel caso in cui non ci siano i servizi web corrispondenti esposti dal SAC del MEF, i servizi di SAR aggiuntivi seguiranno le linee guida presenti nel SAC del MEF sulla base della documentazione presente sul sito I Servizi Web che il sistema SAR espone sono: Servizio Visualizzazione e Presa in carico della ricetta dematerializzata. Descrizione Tramite questo servizio è possibile: effettuare la presa in carico esclusivo della ricetta dematerializzata da parte della struttura erogatrice. visualizzare i dati completi della ricetta indipendentemente 10

11 Servizio Descrizione dallo stato della ricetta stessa (anche per erogate) rilasciare la ricetta presa in carico, nel caso in cui ancora non è erogata. visualizzare i dati oscurati anagrafici della ricetta. Comunicazione della chiusura dell erogazione della ricetta dematerializzata Annullamento dell erogazione delle ricette dematerializzate Comunicazione del malfunzionamento del sistema erogatore Trasmissione delle ricette dematerializzate in differita Tramite questo servizio è possibile: registrare l erogazione totale della ricetta. registrare l erogazione parziale della ricetta. registrazione dell erogazione della singola prestazione della ricetta. registrare il completamento dell erogazione della ricetta dopo aver registrato l erogazione delle singole prestazioni. Tramite questo servizio è possibile: comunicare l annullamento dell erogazione della ricetta senza revoca della presa in carico. comunicare l annullamento dell erogazione della ricetta con revoca della presa in carico. Tramite questo servizio è possibile: comunicare il malfunzionamento del Sistema Erogatore e ricevere il numero di ticket che dovrà essere utilizzato per l invio della erogazione delle ricette in differita. richiedere la lista dei malfunzionamenti segnalati dal Sistema Erogatore. Tramite questo servizio è possibile: trasmettere in differita l erogazione delle ricette dematerializzate, non registrate in tempo reale a causa di sopraggiunti malfunzionamenti. visualizzare le ricette trasmesse in differita dal Sistema Erogatore. ricercare le ricette trasmesse in differita dal Sistema Erogatore. Annullamento delle ricette Tramite questo servizio è possibile: 11

12 Servizio Descrizione trasmesse in differita. richiedere l annullamento della erogazione di una ricetta trasmessa in differita. Richiesta di errori di elaborazione delle ricette trasmesse in differita Tramite questo servizio è possibile: richiedere eventuali errori e warning prodotti dal Sistema SAR durante l elaborazione delle erogazioni e gli annullamenti di erogazioni delle ricette trasmesse in differita dal Sistema Erogatore. 3.2 Stati della ricetta dematerializzata Nella tabella successiva sono riportati gli stati della ricetta dematerializzata gestiti nell ambito del Sistema SAR in corrispondenza del Sistema SAC per le ricette con le prescrizioni specialistiche. Codice Descrizione Stati Stati Descrizione dell azione che determina lo stato Stato Stato Precedenti Successivi 3 Ricetta da erogare 4 Ricetta annullata dal prescrittore 5 Ricetta in corso di erogazione 7 Singola Prestazione Erogata 8 Ricetta Erogata nessuno 4,5 La ricetta dematerializzata è correttamente inserita negli archivi del SAR e pronta per essere erogata. 3 nessuno La ricetta dematerializzata è correttamente inserita negli archivi del SAR e annullata dal medico prescrittore. La ricetta non può essere erogata. 3 7,8,3 La ricetta dematerializzata è correttamente presa in carico esclusivo da un Sistema Erogatore. La ricetta non può essere presa in carico da nessun altro Sistema Erogatore e può essere o erogata (stato 8) o rilasciata (stato 3). 5 8 Per la ricetta dematerializzata, che contiene diverse prestazioni, è stata registrata l erogazione di una o più prestazioni singole L erogazione dell ultima prestazione specialistica, chiude la ricetta facendola passare allo stato di ricetta completamente erogata (stato 8). 5,7 5,3,9 Per la ricetta dematerializzata è stata registrata l erogazione completa. All interno della ricetta possono essere stati o tutte le prestazioni o anche solo alcune. 12

13 Codice Descrizione Stato Stato 9 Annullamento Ricetta Erogata Stati Precedenti Stati Descrizione dell azione che determina lo stato Successivi 8 8,3 Annullamento dell erogazione della ricetta da parte dell erogatore. La ricetta viene portata nuovamente nello stato di visualizzata e presa in carico esclusivamente, in modo che si possano inserire nuovamente i dati per concludere l erogazione (stato 8) oppure rilasciare completamente la ricetta e porla di nuovo nello stato da erogare (stato 3). 13

14 4 Processi di gestione della ricetta dematerializzata e servizi utilizzati 4.1 Processo di Presa in Carico Ricetta Dematerializzata Il processo di presa in carico della ricetta Dematerializzata può essere eseguito dai seguenti attori Sistemi Erogatori: CUP di un azienda privata (Sistema Erogatore) - la gestione della ricetta dematerializzata in questo caso avviene tramite i servizi d integrazione esposti dal Sistema SAR o tramite una maschera funzionale predisposta dal Sistema SAR per la gestione dell operazione. Call Center utilizzato da una azienda privata - la gestione della ricetta dematerializzata in questo caso avviene tramite una maschera funzionale predisposta dal Sistema SAR per la gestione dell operazione. Nella gestione di questo evento possono essere presenti una delle seguenti possibilità, descritte in dettaglio nei paragrafi successivi: Presa in carico della ricetta dematerializzata con esito positivo. Presa in carico della ricetta dematerializzata con esito negativo a causa dell errore formale della ricetta. Presa in carico della ricetta dematerializzata con esito negativo a causa del malfunzionamento del Sistema SAR. La presa in carico non può essere eseguita per malfunzionamento del Sistema Erogatore. Nel caso in cui la ricetta non è presente nel Sistema SAR in quanto extra Regione, il Sistema SAR provvederà a comunicare al Sistema SAC l avvenuta presa in carico della ricetta dematerializzata da parte di un azienda/struttura regionale. Il Servizio esposto dal SAR è VisualizzaErogatoService. Il Servizio di presa in carico della ricetta dematerializzata prevede la gestione delle seguenti opzioni: 1 - comunicazione di visualizzazione e presa in carico della ricetta e recupero completo dei dati. Nel caso in cui questa opzione venga utilizzata per la prima volta, la ricetta sarà registrata come presa in carico da parte del Sistema Erogatore; per tutte le volte successive, indipendentemente dallo stato della ricetta, tramite quest opzione sarà possibile visualizzare i dati completi della ricetta, sia quelli inseriti dal prescrittore che quelli eventualmente impostati dall erogatore che ha iniziato a trattare una ricetta e non l ha ancora erogata totalmente. 14

15 2 - comunicazione di visualizzazione e presa in carico della ricetta, senza recupero dei dati. Tale opzione può essere utilizzata solo per ricette prescritte nella stessa regione nella quale avviene l erogazione. 3 - rilascio della ricetta dematerializzata che era stata visualizzata e presa in carico, per impossibilità di erogazione, in tal caso la ricetta torna ad essere visibile a tutti gli erogatori. 4 - visualizzazione dei dati dell assistito oscurati dal medico. 5 - visualizzazione e presa in carico della ricetta senza dichiarazione della struttura di erogazione. Di seguito sono riportati i processi per la gestione della presa in carico della ricetta dematerializzata La presa in carico della ricetta dematerializzata con esito positivo Presa in carico tramite i servizi WS esposti dal SAR. Questo flusso riporta la presa in carico della ricetta dematerializzata da parte di qualsiasi Sistema Erogatore tramite utilizzo dei Servizi esposti dal Sistema SAR (opzione 1 o 2) sd 01 - Presa in Carico - Esito Risposta - Positiv o - WS (1,2) Sistema Erogatore SAR WS SAC Invoca WS VisualizzaErogatoService(Opzione 1 o 2) Invoca WS VisualizzaErogatoRichiesta(Opzione 1 o 2) VisualizzaErogatoRicevuta(Positivo) VisualizzaErogatoRicevuta(Positivo) Registra Prenotazione() In questo caso il Sistema Erogatore deve attendere la risposta positiva dal Sistema SAR prima di effettuare la registrazione della presa in carico esclusivo e prenotazione nel proprio DB Presa in carico da parte del Call Center tramite una maschera applicativa predisposta dal Sistema SAR. Questo flusso riporta la presa in carico della ricetta dematerializzata da parte del Call Center tramite utilizzo della maschera applicativa messa a disposizione dal Sistema SAR e successiva registrazione da parte del Sistema del CUP Aziendale. 15

16 sd 02 - Presa in Carico - Esito Risposta - Positiv o - App - WS (5) Call Center CUP SAR WebApp SAR WS SAC Registra Presa in Carico tramite WebApp() Invoca WS VisualizzaErogatoRichiesta(Opzione 5) VisualizzaErogatoRicevuta(Positivo) Esito(Positivo) Registra su CUP() Registra Prenotazione() Invoca WS VisualizzaErogatoService(Opzione 1 o 2) Invoca WS VisualizzaErogatoRichiesta(Opzione 1 o 2) VisualizzaErogatoRicevuta(Positivo) VisualizzaErogatoRicevuta(Positivo) In questo caso l operatore di Call Center utilizza la maschera funzionale messa a disposizione dal Sistema SAR per la registrazione di presa in carico della ricetta, senza indicazione della Struttura Erogatrice (opzione 5). In un momento successivo, appena possibile, la registrazione sarà effettuata sul Sistema CUP Aziendale, il quale provvederà a comunicare al Sistema SAR la Struttura Erogatrice tramite lo stesso servizio (opzione 1 o 2). Nel caso in cui la Struttura Erogatrice non sia stata individuata, il Sistema Erogatore deve rilasciare la ricetta Presa in carico tramite la maschera applicativa predisposta dal Sistema SAR. Questo flusso riporta la presa in carico della ricetta dematerializzata da parte del CUP dell azienda privata tramite utilizzo della maschera applicativa messa a disposizione dal Sistema SAR. sd 03 - Presa in Carico - Esito Risposta - Positiv o- App - WS (1,2) CUP Ambulatorio Privato o Pubblico SAR WebApp SAC Registra Presa in Carico tramite WebApp() Esito Positivo() Invoca WS VisualizzaErogatoRichiesta(Opzione 1 o 2) VisualizzaErogatoRicevuta(Positivo) Registra Prenotazione() 16

17 In questo caso l operazione di presa in carico sarà effettuata tramite la maschera applicativa del Sistema SAR con indicazione della Struttura Erogatrice Presa in carico della ricetta dematerializzata tramite WS con esito negativo a causa dell errore formale Nel caso in cui il Sistema SAR rilevi errori nei dati inviati da parte delle Sistemi e Strutture Erogatrici, tali errori dovranno essere corretti in tempo reale e dovrà essere rieseguita l operazione di presa in carico della ricetta, finché il Sistema SAR non produrrà l esito positivo dell operazione. Il Sistema Erogatore non può eseguire la registrazione nel proprio DB fino alla convalida positiva della presa in carico della ricetta da parte del Sistema SAR. sd 04 - Flusso Presa in Carico - Esito Risposta - Errore Sistema Erogatore SAR WS SAC Invoca WS VisualizzaErogatoService(Opzione 1 o 2) Invoca WS VisualizzaErogatoRichiesta(Opzione 1 o 2) VisualizzazioneErogatoRicevuta(Ristituzione Errore) VisualizzazioneErogatoRicevuta(Ristituzione Errore) Correzione Errore, Ri-Invocazione WS() Presa in carico della ricetta dematerializzata tramite Maschera Applicativa con esito negativo a causa dell errore formale. Nel caso in cui la presa in carico della ricetta venga effettuata tramite la maschera applicativa del Sistema SAR, detta presa in carico sarà ritenuta effettiva solo dopo che il Sistema SAR avrà restituito l esito positivo. 17

18 sd 05 - Flusso Presa in Carico - Esito Risposta - Errore - App Struttura Erogatrice SAR WebApp SAC Registra Presa in Carico tramite WebApp() Esito(Errore) Invoca WS VisualizzaErogatoRichiesta(Opzione 5) VisualizzazioneErogatoRicevuta(Errore) Correzione Errore, Ri-Conferma registrazione() La presa in carico della ricetta dematerializzata con esito negativo a causa del malfunzionamento del Sistema SAR. Nel caso di malfunzionamento del Sistema SAR il Sistema Erogatore deve eseguire la prenotazione e l erogazione della ricetta sulla base del promemoria presentato dall assistito. Il Sistema Erogatore dovrà trasmettere in differita i dati della ricetta presa in carico ed erogata sulla base del flusso di trasmissione delle ricette in differita, questa modalità è descritta nei capitoli successivi. sd 06 - Flusso Presa in Carico - Malfunzionamento SAR Sistema Erogatore SAR WS Invoca WS VisualizzaErogatoService(Opzione 1, 2, 5) VisualizzazioneErogatoRicevuta(Malfunzionamento SAR) Prenotazione Ricetta(in base promemoria cartacea) Erogazione Ricetta(in base promemoria cartacea) Processo Trasmissione in deferita() 18

19 4.1.5 La presa in carico della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema Erogatore. Nel caso di malfunzionamento del proprio Sistema l Erogatore deve eseguire la prenotazione e l erogazione della ricetta sulla base del promemoria presentata dall assistito. Il Sistema Erogatore deve aprire un ticket di malfunzionamento. Il ticket può essere aperto con seguente modalità: invocazione del apposito WS esposto dal Sistema SAR. tramite utilizzo della maschera funzionale, fornita dal SAR. Al Sistema Erogatore sarà comunicato il numero di ticket il quale dovrà essere inserito nella successiva trasmissione delle ricette in modalità differita. Il Sistema Erogatore dovrà trasmette in differita i dati della ricetta presa in carico ed erogata sulla base del flusso di trasmissione delle ricette in differita, decritta nei capitoli successivi e utilizzando il numero di malfunzionamento in suo possesso. La trasmissione delle ricette con il codice del malfunzionamento specifico potrà essere trasmesso dal Sistema Erogatore solo nei 5 giorni successivi al malfunzionamento registrato. In seguito il SAR non accetterà più le ricette in differita con questo codice del malfunzionamento. sd 07 - Flusso Presa in Carico- Malfunzionamento Sistema Erogatore Sistema Erogatore SAR WS Invoca WS RicettaDifferitaService(InvioSegnalazione) InvioSegnalazioneRicevuta(Numero Malfunzionamento) Prenotazione Ricetta(in base promemoria cartacea) Erogazione Ricetta(in base promemoria cartacea) Processo Trasmissione in deferita() 19

20 sd 08 - Flusso Presa in Carico- Malfunzionamento Sistema Erogatore Sistema Erogatore Help Desk SAR Segnalazione Malfunzionamento() Comunicazione Numero Malfunzionamento() Prenotazione Ricetta(in base promemoria cartacea) Erogazione Ricetta(in base promemoria cartacea) Processo Trasmissione in deferita() Rilascio della presa in carico della ricetta dematerializzata con esito positivo Rilascio della presa in carico tramite i servizi WS esposti dal SAR Nel caso in cui il Sistema Erogatore debba rilasciare una ricetta presa in carico, prima di aver registrato l erogazione, si dovrà utilizzare lo stesso servizio di visualizzazione e di presa in carico VisualizzaErogatoService della ricetta utilizzando l opzione Rilascio della presa in carico da parte del Call Center tramite maschera applicativa SAR In questo caso il rilascio, tramite la maschera applicativa, potrà avvenire soltanto immediatamente dopo la presa in carico per errore della ricetta e potrà essere effettuata solo dall operatore che ha effettuato la presa in carico. Non si potrà rilasciare la ricetta presa in carico da parte degli altri operatori o nei giorni successivi Rilascio della presa in carico tramite maschera applicativa predisposta dal Sistema SAR In questo caso il rilascio della presa in carico può avvenire in qualsiasi momento, attraverso la maschera applicativa del Sistema SAR. 4.2 Processo Erogazione Ricetta Dematerializzata. Il Processo di erogazione della ricetta Dematerializzata può essere eseguita da seguenti Attori Sistemi Erogatori: 20

21 CUP di un azienda privata (Sistema Erogatore) - in questo caso la gestione della ricetta dematerializzata avviene tramite i servizi d integrazione esposti dal Sistema SAR. Il processo di erogazione di ricetta dematerializzata e presa in carico della ricetta dematerializzata deve essere eseguita dallo stesso soggetto erogatore. La registrazione dell erogazione tramite Servizi Web sincroni del SAR può essere registrata solo nel caso in cui, precedentemente, è stata registrata la presa in carico della ricetta tramite Servizi Web sincroni del SAR. Nel caso in cui non sia stato possibile registrare la presa in carico tramite i Servizi Web sincroni a causa di malfunzionamenti, la registrazione dell erogazione dovrà avvenire obbligatoriamente in modalità differita anche se al momento della registrazione stessa non saranno presenti malfunzionamenti dei sistemi. Le modalità di invio delle ricette in differita saranno descritte nei capitoli successivi. Nel caso in cui sia stata correttamente registrata da parte del Sistema Erogatore, tramite i Servizi Web sincroni, la presa in carico della ricetta e/o l erogazione delle singole prestazioni, ma la chiusura della ricetta è stata registrata in modalità differita a causa di malfunzionamenti, il Sistema Erogatore potrà comunque trasmette entro un anno dalla data di prescrizione della ricetta, la relativa chiusura di erogazione tramite i Servizi Web sincroni. Altrimenti, per tutte le ricette prese in carico e non chiuse nel Sistema SAR, l operazione di chiusura erogazione sarà effettuata d ufficio dal Sistema SAR alla scadenza di un anno dalla data di prescrizione e trasmessa al Sistema SAC. Nella gestione di questo evento possono essere presenti le seguenti possibilità: Erogazione totale della ricetta dematerializzata con esito positivo. Erogazione parziale della ricetta dematerializzata con esito positivo. Erogazione della prestazione singola della ricetta dematerializzata con esito positivo. Chiusura erogazione della ricetta dematerializzata delle prestazioni singole con esito positivo. Erogazione della ricetta dematerializzata con esito negativo causa errore formale della ricetta. Erogazione della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema SAR. Erogazione non può essere eseguita causa malfunzionamento del Sistema Erogatore. Il Sistema SAR provvederà a comunicare al Sistema SAC l avvenuta erogazione della ricetta dematerializzata da parte di una azienda/struttura regionale. Il Servizio esposto dal SAR è InvioErogatoService. 21

22 Il Servizio di erogazione della ricetta dematerializzata prevede la gestione delle seguenti operazioni: operazione 1 - comunicazione di erogazione totale della ricetta dematerializzata. Tramite questa operazione viene comunicato che tutte le prestazioni della ricetta sono state erogate, indipendentemente dalle date di erogazione della singola prestazione e dalla chiusura completa della ricetta. operazione 3 - comunicazione di erogazione parziale della ricetta dematerializzata. Tramite questa operazione viene comunicato che non tutte le prestazioni della ricetta sono stati erogate, indipendentemente dalle date di erogazione della singola prestazione e dalla chiusura completa della ricetta. operazione 2 comunicazione di erogazione della singola prestazione della ricetta dematerializzata. Tramite questa operazione viene comunicata l erogazione di una delle prestazioni presenti nella ricetta. La ricetta in questo caso non viene considerata chiusa. operazione 6 comunicazione della conclusione di erogazione della ricetta dematerializzata, nel caso in cui per la stessa ricetta sono state registrate le erogazioni delle singole prestazioni (operazione 2). Per utilizzare questa operazione è necessario che almeno una delle prestazioni sia stata erogata con l opzione 2, ma non è necessario che lo siano state tutte. Utilizzo di questa opzione prevede anche la comunicazione di tutte le altre prestazioni erogate, nel caso in cui ci sono, per effettuare la chiusura della ricetta. Al momento della comunicazione di questa operazione la ricetta sarà chiusa in modalità totale o parziale, sulla base della prestazioni registrate e singolarmente erogate per questa ricetta. In seguito saranno riportati i processi per la gestione dell erogazione della ricetta dematerializzata Erogazione totale della ricetta dematerializzata con esito positivo Questo flusso prevede la registrazione dell erogazione totale della ricetta da parte del Sistema Erogatore. In questo caso la registrazione dell erogazione nel DB del Sistema Erogatore avviene solo dopo aver ricevuto l esito positivo del Sistema SAR. 22

23 sd 09 - Flusso Erogazione Totale Ricetta - Esito Positivo Sistema Erogatore SAR WS SAC Invoca WS InvioErogatoService(Operazione 1) Invoca WS InvioErogatoRichiesta(Operazione 1) InvioErogatoRicevuta(Positivo) InvioErogatoRicevuta(Positivo) Registrazione Erogazione() Erogazione parziale della ricetta dematerializzata con esito positivo Questo flusso prevede la registrazione dell erogazione parziale della ricetta da parte del Sistema Erogatore. In questo caso la registrazione dell erogazione nel DB del Sistema Erogatore avviene solo dopo aver ricevuto l esito positivo del Sistema SAR. sd 10 - Flusso Erogazione Parziale Ricetta - Esito Positivo Sistema Erogatore SAR WS SAC Invoca WS InvioErogatoService(Operazione 3) Invoca WS InvioErogatoRichiesta(Operazione 3) InvioErogatoRicevuta(Positivo) InvioErogatoRicevuta(Positivo) Registrazione Erogazione() Erogazione delle singole prestazioni della ricetta dematerializzata e chiusura della ricetta con esito positivo. Questo flusso prevede prima la registrazione delle singole prestazioni della ricetta e, successivamente, la registrazione di chiusura della ricetta da parte del Sistema Erogatore. In questo caso la registrazione 23

24 dell erogazione nel DB del Sistema Erogatore avviene solo dopo aver ricevuto l esito positivo del Sistema SAR sia per le prestazioni singole sia per la chiusura della ricetta. sd 11 - Flusso Erogazione Singola Prestazione Ricetta - Esito Positivo Sistema Erogatore SAR WS SAC Invoca WS InvioErogatoService(Operazione 2) InvioErogatoRicevuta(Positivo) Registrazione Erogazione() Ripetizione Erogazione Singola(se serve) Invoca WS InvioErogatoService(Operazione 6) Verifica se ricetta è stata erogata totalmente o parzialmente() Invoca WS InvioErogatoRichiesta(Operazione 1 o 3) InvioErogatoRicevuta(Positivo) InvioErogatoRicevuta(Positivo) Registrazione Erogazione() Erogazione della ricetta dematerializzata con esito negativo causa errore formale. Nel caso in cui il Servizio SAR per la registrazione dell erogazione, per qualsiasi operazione, restituisca errori formali a causa dei quali l erogazione della ricetta non possa essere registrata, il Sistema Erogatore provvederà a correggere gli errori e rinviare l erogazione della ricetta al Sistema SAR. Solo in seguito la registrazione dell erogazione potrà essere terminata nel Sistema Erogatore Erogazione della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema SAR. Nel caso di malfunzionamento del Sistema SAR il Sistema Erogatore deve eseguire l erogazione della ricetta sulla base del promemoria presentato dall assistito. Nel caso in cui il malfunzionamento del Sistema SAR si fosse presentato solo per la registrazione dell erogazione, ma la presa in carico della ricetta fosse stata eseguita correttamente, il Sistema Erogatore dovrà eseguire 24

25 l erogazione sulla base del promemoria cartaceo dell assistito e dei dati registrati nel proprio sistema. In seguito il Sistema Erogatore dovrà trasmettere l erogazione della ricetta in differita. Nel caso in cui il Sistema Erogatore non abbia trasmesso la presa in carico della ricetta a causa di malfunzionamenti (sia del proprio Sistema sia del Sistema SAR), dovrà trasmettere sia presa in carico che l erogazione della ricetta in differita, anche se al momento dell erogazione non sono presenti malfunzionamenti. Il Sistema Erogatore dovrà trasmette in differita i dati della ricetta presa in carico ed erogata sulla base del flusso di trasmissione delle ricette in differita, decritta nei capitoli successivi. sd 12 - Flusso Erogazione - Malfunzionamento SAR - Presa in carico non trasmessa Sistema Erogatore SAR WS Invoca WS VisualizzaErogatoService(Opzione 1, 2, 5) VisualizzaErogatoRicevuta(Malfunzionamento SAR) Prenotazione Ricetta(in base promemoria cartacea) Erogazione Ricetta(in base promemoria cartacea) Processo Trasmissione in deferita() 25

26 sd 13 - Flusso Erogazione - Malfunzionamento SAR - Presa in carico trasmessa Sistema Erogatore SAR WS Invoca WS VisualizzaErogatoService(Opzione 1, 2, 5) VisualizzaErogatoRicevuta(Positivo) Invoca WS InvioErogatoService(tutte le operazioni) InvioErogatoRicevuta(Malfunzionamento SAR) Erogazione Ricetta(in base promemoria cartacea) Processo Trasmissione in deferita() Erogazione della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema Erogatore. Nel caso di malfunzionamento del proprio Sistema l Erogatore deve eseguire l erogazione della ricetta sulla base del promemoria presentato dall assistito. Il Sistema Erogatore deve aprire un ticket di malfunzionamento. Il ticket può essere aperto con seguente modalità: invocazione dell apposito WS esposto dal Sistema SAR tramite la comunicazione telefonica all operatore del Help Desk del SAR Al Sistema Erogatore sarà comunicato il numero di ticket il quale dovrà essere inserito nella successiva trasmissione delle ricette in modalità differita. Il Sistema Erogatore dovrà trasmette in differita i dati della ricetta erogata sulla base del flusso di trasmissione delle ricette in differita, decritta nei capitoli successivi e utilizzando il numero di malfunzionamento in suo possesso. Nel caso in cui il malfunzionamento del Sistema Erogatore si fosse presentato solo per la registrazione dell erogazione, ma la presa in carico della ricetta fosse stata eseguita correttamente, il Sistema Erogatore dovrà eseguire l erogazione sulla base del promemoria cartaceo dell assistito e dei dati registrati nel proprio sistema. In seguito il Sistema Erogatore dovrà trasmettere l erogazione della ricetta in differita. 26

27 Nel caso in cui il Sistema Erogatore non avesse trasmesso la presa in carico della ricetta a causa di malfunzionamenti (sia del proprio sistema sia del sistema SAR), lo stesso dovrà trasmettere sia la presa in carico che l erogazione della ricetta in differita, anche se al momento dell erogazione non fossero presenti malfunzionamenti. Il Sistema Erogatore dovrà trasmette in differita i dati della ricetta presa in carico ed erogata sulla base del flusso di trasmissione delle ricette in differita, descritto nei capitoli successivi. sd 14 - Flusso Erogazione - Malfunzionamento Sistema Erogatore Sistema Erogatore SAR WS Invoca WS RicettaDifferitaService(InvioSegnalazione) InvioSegnalazioneRicevuta(Numero Malfunzionamento) Erogazione Ricetta(in base promemoria cartacea) Processo Trasmissione in deferita() sd 15 - Flusso Erogazione - Malfunzionamento Sistema Erogatore Sistema Erogatore Help Desk SAR Segnalazione Malfunzionamento() Comunicazione Numero Malfunzionamento() Erogazione Ricetta(in base promemoria cartacea) Processo Trasmissione in deferita() 27

28 4.3 Processo Annullamento Erogazione Ricetta Dematerializzata Il Processo di annullamento dell erogazione della ricetta Dematerializzata può essere eseguita dai seguenti attori: CUP di un azienda privata (Sistema Erogatore) - la gestione della ricetta dematerializzata in questo caso avviene tramite i servizi d integrazione esposti dal Sistema SAR. Il processo di annullamento dell erogazione della ricetta dematerializzata e della presa in carico ed erogazione della ricetta dematerializzata deve essere eseguita dallo stesso soggetto erogatore. La registrazione dell annullamento dell erogazione tramite Servizi Web del SAR può essere registrata solo nel caso in cui, precedentemente, sia stata registrata l erogazione della ricetta tramite Servizi Web SAR. Nel caso in cui non sia stato possibile registrare l erogazione tramite i Servizi Web a causa di malfunzionamenti, l annullamento dell erogazione dovrà avvenire obbligatoriamente in modalità differita tramite appositi servizi. Le modalità di invio e di annullamento delle ricette in differita sono descritti nei capitoli successivi. Nella gestione di questo evento possono essere presenti le seguenti possibilità: Annullamento Erogazione della ricetta dematerializzata senza revoca di presa in carico con esito positivo. Annullamento Erogazione della ricetta dematerializzata con revoca di presa in carico con esito positivo. Annullamento Erogazione della ricetta dematerializzata con esito negativo causa errore formale della ricetta. Annullamento Erogazione della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema SAR. Annullamento Erogazione non può essere eseguita causa malfunzionamento del Sistema Erogatore. Il Sistema SAR provvederà a comunicare al Sistema SAC l annullamento erogazione della ricetta dematerializzata da parte di una azienda/struttura regionale. Il Servizio esposto dal SAR è AnnullaErogatoService. Il Servizio di annullamento di erogazione della ricetta dematerializzata prevede la gestione delle seguenti operazioni: operazione 2 - comunicazione dell annullamento dell erogazione della ricetta dematerializzata senza revoca di presa in carico da parte di Sistema Erogatore. Tramite questa operazione viene comunicato l annullamento della erogazione di tutte le prestazioni della ricetta. In questo caso la ricetta rimane in carico del Sistema Erogatore, che successivamente può trasmettere una nuova erogazione per la stessa ricetta. 28

29 operazione 3 - comunicazione dell annullamento dell erogazione della ricetta dematerializzata con revoca di presa in carico da parte di Sistema Erogatore. Tramite questa operazione viene comunicato l annullamento della erogazione di tutte le prestazioni della ricetta. In questo caso la ricetta viene rilasciata da parte del Sistema Erogatore e può essere presa in carico da un altro Sistema Erogatore. In seguito sono riportati i processi per la gestione dell erogazione della ricetta dematerializzata Annullamento Erogazione della ricetta dematerializzata senza revoca di presa in carico con esito positivo Questo flusso prevede la registrazione dell annullamento dell erogazione della ricetta da parte del Sistema Erogatore senza revocare la propria presa in carico della ricetta. In questo caso la registrazione dell annullamento dell erogazione nel DB del Sistema Erogatore avviene solo dopo aver ricevuto l esito positivo del Sistema SAR. La ricetta in questo caso potrà essere di nuovo registrata come erogata dallo stesso Sistema Erogatore. sd 16 - Flusso Annullamento Erogazione senza revoca presa in carico - Esito Positivo Sistema Erogatore SAR WS SAC Invoca WS AnnullaErogatoService(Operazione 2) Invoca WS AnnullaErogatoRichiesta(Operazione 3) AnnullaErogatoRicevuta(Positivo) AnnullaErogatoRicevuta(Positivo) Registrazione Annullamento Erogazione() Annullamento Erogazione della ricetta dematerializzata con revoca di presa in carico con esito positivo Questo flusso prevede la registrazione dell annullamento dell erogazione della ricetta da parte del Sistema Erogatore con revoca della propria presa in carico della ricetta. In questo caso la registrazione dell annullamento dell erogazione nel DB del Sistema Erogatore avviene solo dopo aver ricevuto l esito positivo del Sistema SAR. La ricetta in questo caso sarà disponibile per la presa in carico dall altro Sistema Erogatore. 29

30 sd 17 - Flusso Annullamento Erogazione con revoca presa in carico - Esito Positivo Sistema Erogatore SAR WS SAC Invoca WS AnnullaErogatoService(Operazione 3) Invoca WS AnnullaErogatoRichiesta(Operazione 2) AnnullaErogatoRicevuta(Positivo) AnnullaErogatoRicevuta(Positivo) Registrazione Annullamento Erogazione() Annullamento Erogazione della ricetta dematerializzata con esito negativo causa errore formale. Nel caso in cui il Servizio SAR per la registrazione dell annullamento di erogazione, per qualsiasi operazione, dia esito ad errori formali a causa dei quali l annullamento dell erogazione della ricetta non possa essere registrata, il Sistema Erogatore deve provvedere a correggere gli errori ed inviare nuovamente l annullamento dell erogazione della ricetta al Sistema SAR. Solo in seguito la registrazione dell annullamento dell erogazione può essere conclusa nel Sistema Erogatore Erogazione della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema SAR Nel caso di malfunzionamento del Sistema SAR, il Sistema Erogatore deve attendere la risoluzione del malfunzionamento e ritrasmettere l annullamento di erogazione. Non è prevista la trasmissione in differita dell annullamento di erogazione Erogazione della ricetta dematerializzata con esito negativo causa malfunzionamento del Sistema Erogatore Nel caso di malfunzionamento del proprio sistema l Erogatore deve attendere la risoluzione del malfunzionamento e ritrasmettere l annullamento dell erogazione. Non è prevista la trasmissione in differita dell annullamento dell erogazione. 4.4 Processo di Registrazione Erogazione in Differita Il Sistema Erogatore, se a causa di malfunzionamenti propri oppure del Sistema SAR è impossibilitato ad erogare secondo le regole stabilite dal decreto della ricetta dematerializzata, in modo particolare non è in grado di visualizzare quanto inserito elettronicamente nel sistema dal medico prescrittore, deve basarsi su quanto indicato 30

31 nel promemoria cartaceo presentatogli dall assistito, sulla base di quanto stabilito dal comma 7, art. 1 del DM 2 nov L erogatore al termine del malfunzionamento è tenuto a trasmettere informaticamente i dati dell erogazione avvenuta sulla base del promemoria cartaceo il prima possibile e in maniera differita rispetto alla reale erogazione. Nel caso di malfunzionamenti del Sistema SAR, tale informazione sarà resa disponibile tramite avviso inviato a tutti i responsabili delle Aziende tramite . Il Processo di registrazione di erogazione della ricetta Dematerializzata in differita può essere eseguita dai seguenti attori: CUP di un azienda privata (Sistema Erogatore) - la gestione della ricetta dematerializzata in questo caso avviene tramite i servizi d integrazione esposti dal Sistema SAR. Nella gestione di questo evento possono essere presenti le seguenti possibilità: Comunicazione del malfunzionamento del proprio sistema da parte Sistema Erogatore. Ricerca del malfunzionamento segnalato da parte Sistema Erogatore. Trasmissione dell erogazione delle ricette in differita causa malfunzionamento SAR per le ricetta senza comunicazione di presa in carico tramite Servizi. Trasmissione dell erogazione delle ricette in differita causa malfunzionamento SAR per le ricetta con la precedente presa in carico comunicata tramite Servizi. Trasmissione dell erogazione delle ricette in differita causa malfunzionamento Sistema Erogatore per le ricetta senza comunicazione di presa in carico tramite Servizi. Trasmissione dell erogazione delle ricette in differita causa malfunzionamento Sistema Erogatore per le ricetta con la precedente presa in carico comunicata tramite Servizi. Visualizzare le ricette erogate in differita. Ricercare le ricette erogate in differita. Annullamento erogazione della ricetta in differita. I Servizi esposti dal SAR sono: Servizio relativo all invio delle ricette in differita RicettaDifferitaService che prevede i seguenti metodi: InvioSegnalazione RicercaSegnalazioni InvioErogatoDiff VisualizzaErogatoDiff 31

32 RicercaErogatoDiff Servizio di annullamento dell erogazione della ricetta in differita AnnullaErogatoDiff. Servizio per la richiesta degli errori relativi di elaborazione delle ricette in differita VisualizzaErroriErogatoDiff. Il Sistema SAR provvederà a comunicare al Sistema SAC l avvenuta erogazione in differita delle ricette dematerializzate da parte di un azienda/struttura regionale Comunicazione del malfunzionamento del Sistema Erogatore al Sistema SAR Il sistema di tracciatura dei malfunzionamenti ha come scopo principale quello di consentire all erogatore la trasmissione in differita delle informazioni inerenti le prestazioni erogate sulla base del promemoria cartaceo vista la mancanza di collegamento con il Sistema che permette la visualizzazione informatica dei dati di prescrizione. A seguito di tale premessa risulta indispensabile la comunicazione del malfunzionamento preventiva rispetto all erogazione della prima ricetta dematerializzata effettuata sulla base dei dati del promemoria cartaceo. Il Sistema Centrale che registra la comunicazione di apertura malfunzionamento tiene conto dell orario in cui l erogatore effettua tale segnalazione. La comunicazione di malfunzionamento deve quindi essere inviata ogni qualvolta non possono essere visualizzati informaticamente i dati della ricetta inseriti dal medico, per cui l erogazione avviene unicamente in base a quanto riportato nel promemoria cartaceo. La comunicazione si intende per evento (cumulativa di più ricette) e mai per singola ricetta. Il Sistema Erogatore può segnalare il malfunzionamento del proprio sistema tramite invocazione del WS RicettaDifferitaService.InvioSegnalazione. Questo servizio deve essere invocato ogni volta che si presenta il malfunzionamento. Alla chiusura del malfunzionamento non deve essere eseguita nessuna operazione di chiusura. Il Sistema SAR espone anche il servizio per richiedere la lista dei malfunzionamenti segnalati dal Sistema Erogatore (RicettaDifferitaService.RicercaSegnalazioni). Per segnalare un malfunzionamento il Sistema Erogatore, nel caso in cui non è possibile invocare il servizio, può effettuare la segnalazione tramite la maschera funzionale messa a disposizione del Sistema SAR Trasmissione dell erogazione delle ricette in differita causa malfunzionamento SAR senza precedente comunicazione di presa in carico tramite i Servizi In questo caso non è stata effettuata da parte del Sistema Erogatore la segnalazione del malfunzionamento in quanto la causa dello stesso è il Sistema SAR. Il codice di malfunzionamento che deve essere utilizzato per la trasmissione in differita è DIFFSAR2. 32

33 Il primo passo che deve eseguire in questo caso il Sistema Erogatore è verificare che le ricette erogate sulla base del promemoria cartaceo sono veramente presenti nel Sistema SAR e non sono stati ancora erogati dagli altri Sistemi Erogatori. Per eseguire la verifica il Sistema deve invocare il WS VisualizzaErogatoService per tutti gli NRE delle ricette che sono stati erogati sulla base del promemoria cartaceo. Successivamente sono presentati tre casi di risposta del WS VisualizzaErogatoService: sd 18 - Flusso Invio Differita - Malfunzionamento - 1 passo Sistema Erogatore SAR WS SAC Prenotazione Ricetta(sulla base della promemoria cartacea) Erogazione Ricetta(sulla base della promemoria cartacea) Invoca WS VisualizzaErogatoService(Opzione 1 per ogni ricetta) Primo Caso VisualizzaErogatoRicevuta(Dati Ricetta - Ricetta può essere erogata) Invoca WS VisualizzaErogatoRichiesta(Opzione 1) VisualizzaErogatoRicevuta(Dati Ricetta - Ricetta può essere erogata) Controllo corrispondenza dei Dati Ricetta e Promemoria() Invoca WS VisualizzaErogatoService(Opzione 1 per ogni ricetta) Secondo Caso VisualizzaErogatoRicevuta(Errore Ricetta esiste nel Sistema, ma è stata presa in carico da altro Sistema - Dati ricetta vuoti) Invoca WS VisualizzaErogatoRichiesta(Opzione 1) VisualizzaErogatoRicevuta(Errore Ricetta esiste nel Sistema, ma è stata presa in carico da altro Sistema - Dati ricetta vuoti) Verifica interna della Struttura Erogatrice(Ricetta sarà trasmessa in deferita solo con i dati indicati nel dettaglio di WS) Invoca WS VisualizzaErogatoService(Opzione 1 per ogni ricetta) Terzo Caso VisualizzaErogatoRicevuta(Errore Ricetta non esiste nel Sistema - Dati ricetta vuoti) Invoca WS VisualizzaErogatoRichiesta(Opzione 1) VisualizzaErogatoRicevuta(Errore Ricetta non esiste nel Sistema - Dati ricetta vuoti) Verifica interna della Struttura Erogatrice(Ricetta sarà trasmessa in deferita solo con i dati indicati nel dettaglio di WS) Il secondo passo di trasmissione delle ricette in differita viene eseguito: per il Primo Caso e consiste nella verifica dei dati presenti sul promemoria cartaceo (acquisita nel Sistema Erogatore) e dei dati della ricetta risituati dal WS VisualizzaErogatoService e successiva trasmissione al Sistema SAR tramite il WS RicettaDifferitaService.InvioErogatoDiff. per il Secondo e Terzo caso i dati della ricetta che devono essere tramessi sono indicati nel dettaglio del WS RicettaDifferitaService.InvioErogatoDiff. In seguito sono presentati due casi da eseguire sulla base della verifica dei dati del promemoria e dei dati della ricetta. 33

34 In tutti e due i casi presentati è necessario, successivamente, invocare il WS VisualizzaErroriErogatoDiffService.VisualizzaErroriErogatoDiffRichiesta ai fini di ricevere da parte del SAR gli errori e i warning delle elaborazioni effettuate per le ricette trasmesse in differita. sd 19 - Flusso Inv io Differita - Malfunzionamento SAR - 2 passo Sistema Erogatore Primo Caso SAR WS SAC Controllo Dati Ricetta e Promemoria() Tutti Dati coincidano() Invoca WS RicettaDifferitaService.InvioErogatoDiff(DIFSAR2, senza dati ricetta) InvioErogatoDiffRicevuta(ID Ricetta SAR) Invoca WS InvioErogatoDiffRichiesta(DIFSAR2) Secondo Caso InvioErogatoDiffRicevuta(ID Ricetta SAC) Controllo Dati Ricetta e Promemoria() Dati non coincidano() Invoca WS RicettaDifferitaService.InvioErogatoDiff(DIFSAR2, con dati ricetta che non coincidano) InvioErogatoDiffRicevuta(ID Ricetta SAR) Invoca WS InvioErogatoDiffRichiesta(DIFSAR2) InvioErogatoDiffRicevuta(ID Ricetta SAC) Invoca WS Invoca WS RicettaDifferitaService.RichiestaErroriErogatoDiff() RichiestaErroriErogatoRicevuta(elenco errori e warning) Trasmissione dell erogazione delle ricette in differita causa malfunzionamento SAR con precedente comunicazione di presa in carico tramite i Servizi In questo caso non è stata effettuata da parte del Sistema Erogatore la segnalazione del malfunzionamento in quanto la causa di malfunzionamento è il Sistema SAR. Il codice di malfunzionamento che deve essere utilizzato per la trasmissione in differita è DIFFSAR2. In questo caso, a differenza di quello precedente, le ricette sono già state prese correttamente in carico da parte del Sistema Erogatore. Per queste ricette non serve effettuare la verifica tramite il servizio VisualizzaErogatoService, ma basta invocare direttamente RicettaDifferitaService.InvioErogatoDiff. Deve essere eseguito direttamente l invio dell erogazione in differita di queste ricette. È necessario, successivamente, invocare il WS RicettaDifferitaService.VisualizzaErroriErogatoDiff ai fini di ricevere da parte del SAR gli errori e i warning delle elaborazioni effettuate per le ricette trasmesse in differita. 34

35 sd 20 - Flusso Invio Differita - Malfunzionamento SAR Sistema Erogatore SAR WS SAC Invoca WS RicettaDifferitaService.InvioErogatoDiff(DIFSAR2, senza dati ricetta) InvioErogatoRicevuta(ID Ricetta SAR) Invoca WS InvioErogatoDiffRichiesta(DIFSAR2) InvioErogatoRicevuta(ID Ricetta SAC) Invoca WS Invoca WS RicettaDifferitaService.RichiestaErroriErogatoDiff() RichiestaErroriErogatoRicevuta(elenco errori e warning) Trasmissione di erogazione delle ricette in differita causa malfunzionamento del Sistema Erogatore senza precedente comunicazione di presa in carico tramite i Servizi In questo caso è stata effettuata da parte del Sistema Erogatore la segnalazione del malfunzionamento o tramite WS del Sistema SAR o tramite maschera funzionale messa a disposizione dal Sistema SAR. Il codice di malfunzionamento che deve essere utilizzato per la trasmissione in differita è Codice attribuito al malfunzionamento dal Sistema SAR. Il primo passo, che deve eseguire in questo caso il Sistema Erogatore, che coincide con il procedimento che viene eseguito anche nel caso di malfunzionamento del SAR, consiste nella verifica che le ricette erogate sulla base del promemoria cartaceo siano veramente presenti Sistema SAR e che non siano state ancora erogate da altri Sistemi Erogatori. Per eseguire la verifica il Sistema Erogatore deve invocare il WS VisualizzaErogatoService per tutti gli NRE delle ricette che sono stati erogate sulla base della promemoria cartaceo. In seguito sono presentati tre casi di risposta del WS VisualizzaErogatoService: 35

36 sd 18 - Flusso Invio Differita - Malfunzionamento - 1 passo Sistema Erogatore SAR WS SAC Prenotazione Ricetta(sulla base della promemoria cartacea) Erogazione Ricetta(sulla base della promemoria cartacea) Invoca WS VisualizzaErogatoService(Opzione 1 per ogni ricetta) Primo Caso VisualizzaErogatoRicevuta(Dati Ricetta - Ricetta può essere erogata) Invoca WS VisualizzaErogatoRichiesta(Opzione 1) VisualizzaErogatoRicevuta(Dati Ricetta - Ricetta può essere erogata) Controllo corrispondenza dei Dati Ricetta e Promemoria() Invoca WS VisualizzaErogatoService(Opzione 1 per ogni ricetta) Secondo Caso VisualizzaErogatoRicevuta(Errore Ricetta esiste nel Sistema, ma è stata presa in carico da altro Sistema - Dati ricetta vuoti) Invoca WS VisualizzaErogatoRichiesta(Opzione 1) VisualizzaErogatoRicevuta(Errore Ricetta esiste nel Sistema, ma è stata presa in carico da altro Sistema - Dati ricetta vuoti) Verifica interna della Struttura Erogatrice(Ricetta sarà trasmessa in deferita solo con i dati indicati nel dettaglio di WS) Invoca WS VisualizzaErogatoService(Opzione 1 per ogni ricetta) Terzo Caso VisualizzaErogatoRicevuta(Errore Ricetta non esiste nel Sistema - Dati ricetta vuoti) Invoca WS VisualizzaErogatoRichiesta(Opzione 1) VisualizzaErogatoRicevuta(Errore Ricetta non esiste nel Sistema - Dati ricetta vuoti) Verifica interna della Struttura Erogatrice(Ricetta sarà trasmessa in deferita solo con i dati indicati nel dettaglio di WS) Il secondo passo di trasmissione delle ricette in differita viene eseguito: per il Primo Caso e consiste nella verifica dei dati presenti sul promemoria cartaceo (acquisito nel Sistema Erogatore) e dei dati della ricetta restituiti dal WS VisualizzaErogatoService e nella successiva tramessine al Sistema SAR tramite il WS RicettaDifferitaService.InvioErogatoDiff per il Secondo e Terzo caso i dati della ricetta che devono essere tramesse sono indicati nel dettaglio del WS RicettaDifferitaService.InvioErogatoDiff. Successivamente sono presentati due casi da eseguire sulla base della verifica dei dati di promemoria e dati della ricetta. È necessario, successivamente, invocare il WS RicettaDifferitaService.VisualizzaErroriErogatoDiff ai fini di ricevere da parte del SAR gli errori e i warning delle elaborazioni effettuate per le ricette trasmesse in differita. 36

37 sd 21 - Flusso Invio Differita - Malfunzionamento Sistema Erogatore - 2 passo Sistema Erogatore Primo Caso SAR WS SAC Controllo Dati Ricetta e Promemoria() Tutti Dati coincidano() Invoca WS RicettaDifferitaService.InvioErogatoDiff(Codice Malfunzionamento, senza dati ricetta) InvioErogatoDiffRicevuta(ID Ricetta SAR) Invoca WS InvioErogatoDiffRichiesta(DIFFSAR1) Secondo Caso InvioErogatoDiffRicevuta(ID Ricetta SAC) Controllo Dati Ricetta e Promemoria() Dati non coincidano() Invoca WS RicettaDifferitaService.InvioErogatoDiff(Codice Malfunzionamento, con dati ricetta che non coincidano) InvioErogatoDiffRicevuta(ID Ricetta SAR) Invoca WS InvioErogatoDiffRichiesta(DIFFSAR1) InvioErogatoDiffRicevuta(ID Ricetta SAC) Invoca WS Invoca WS RicettaDifferitaService.RichiestaErroriErogatoDiff() RichiestaErroriErogatoRicevuta(elenco errori e warning) Trasmissione dell erogazione delle ricette in differita causa malfunzionamento del Sistema Erogatore con precedente comunicazione di presa in carico tramite i Servizi In questo caso è stata effettuata da parte del Sistema Erogatore la segnalazione del malfunzionamento o tramite WS del Sistema SAR o tramite maschera funzionale. Il codice di malfunzionamento che deve essere utilizzato per la trasmissione in differita è il Codice attribuito al malfunzionamento dal Sistema SAR. In questo caso, ian differenza del quello precedente, le ricette sono già state prese correttamente in carico da parte del Sistema Erogatore. Per queste ricette non serve eseguire la verifica tramite il servizio VisualizzaErogatoService. Deve essere eseguito direttamente l invio dell erogazione in differita di queste ricette. È necessario, successivamente, invocare il WS RicettaDifferitaService.VisualizzaErroriErogatoDiff ai fini di ricevere da parte del SAR gli errori e i warning delle elaborazioni effettuate per le ricette trasmesse in differita. 37

38 sd 22 - Flusso Invio Differita - Malfunzionamento Sistema Erogatore Sistema Erogatore SAR WS SAC Invoca WS RicettaDifferitaService.InvioErogatoDiff(Codice Malfunzionamento, senza dati ricetta) InvioErogatoDiffRIcevuta(ID Ricetta SAR) Invoca WS InvioErogatoDiffRichiesta(DIFFSAR1) InvioErogatoDiffRicevuta(ID Ricetta SAC) Invoca WS Invoca WS RicettaDifferitaService.RichiestaErroriErogatoDiff() RichiestaErroriErogatoRicevuta(elenco errori e warning) Visualizzazione ricette trasmesse in differita In questo caso è possibile richiedere i dati della ricetta trasmessa in differita da parte del Sistema Erogatore, utilizzando il NRE della ricetta tramite il WS RicettaDifferitaService.VisualizzaErogatoDiff Ricerca ricette trasmesse in differita In questo caso è possibile richiedere i dati di più ricette trasmesse in differita da parte del Sistema Erogatore, utilizzando un insieme di parametri, tramite il WS RicettaDifferitaService.RicercaErogatoDiff Annullamento erogazione ricette trasmesse in differita In questo caso il Sistema Erogatore può effettuare l annullamento dell erogazione della ricetta trasmessa in differita tramite il WS AnnullaErogatoDiffService. In seguito il Sistema Erogatore potrà trasmettere la nuova erogazione della stessa ricetta. È necessario, successivamente, invocare il WS RicettaDifferitaService.VisualizzaErroriErogatoDiff ai fini di ricevere da parte del SAR gli errori e warning delle elaborazioni effettuate per le ricette trasmesse in differita. 38

39 sd 23 - Flusso Invio Differita - Annullamento Erogazione Sistema Erogatore SAR WS SAC Invoca WS RicettaDifferitaService.AnnullaErogatoDiff(ID Ricetta SAR) AnnullaErogatoDiffRIcevuta(Codice Autorizzazione) Invoca WS InvioErogatoDiffRichiesta(ID Ricetta SAC) InvioErogatoDiffRicevuta(Codice Autorizzazione) Invoca WS Invoca WS RicettaDifferitaService.RichiestaErroriErogatoDiff() RichiestaErroriErogatoRicevuta(elenco errori e warning) 39

40 5 Servizi Disponibili Erogazione 5.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 la richiesta e il rilascio, da parte del Sistema SAR delle credenziali per singola Azienda, Struttura e Ambulatorio, che effettueranno l invocazione dei servizi. 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. 5.2 Autenticazione per l accesso alle maschere funzionale del Sistema SAR L accesso alla maschera applicativa avviene tramite l autenticazione nel sistema regionale di OpenSSO. Per ogni operatore che dovrà avere accesso a queste funzionalità, l azienda o struttura di riferimento dovrà richiedere le credenziali di accesso, utilizzando la modulistica attuale. 5.3 Gestione credenziali scadute o invalide per WS Nel caso in cui vengono inserite le credenziali invalide o scadute per accedere ai Servizi Web, il Sistema SAR restituisce l errore: http status code 401 unauthorized. Nel testo del messaggio, formato XML, sarà possibile individuare la causa esatta della mancata autenticazione. Il formato XML del messaggio è il seguente: <?xml version="1.0" encoding="utf-8"?> <error> <code>...</code> <message>...</message> <exception>...</exception> </error> Nel tag <code> possono essere presenti i seguenti valori: Valore Descrizione 0 Autenticazione fallita 40

41 Valore Descrizione 1 Credenziali errate 2 Password errata 3 Password scaduta Sulla base di questo errore il sistema che invoca il Servizio Web deve comunicare al medico che le credenziali inserite non sono valide o sono scadute. 5.4 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 SismedCF.cer -certin -pkcs in cui il file CF.txt contiene il codice fiscale in chiaro, il file SismedCF.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) per poter essere inseriti nel file XML da inviare telematicamente al SAR. Il certificato SismedCF.cer è disponibile su richiesta. 5.5 Visualizzazione e Presa in carico della ricetta dematerializzata Descrizione Servizio Il servizio permette alle Strutture Erogatrici delle prestazioni specialistiche, in maniera esclusiva rispetto a tutti gli altri erogatori, di: visualizzare il contenuto di una ricetta dematerializzata inserita elettronicamente da un medico prescrittore; prenderla in carico ai fini di successiva erogazione. Inoltre: visualizzare i dati completi della ricetta indipendentemente dallo stato della ricetta stessa (anche per le erogate) 41

42 rilasciare la ricetta presa in carico, nel caso in cui ancora non è erogata. visualizzare i dati oscurati anagrafici della ricetta. Le due azioni di visualizzazione e presa in carico si realizzano contemporaneamente con un unica chiamata tramite web service: a seguito di ciò, ogni altro erogatore che nello stesso momento provasse ad interrogare la stessa ricetta, avrebbe come risposta che la stessa è in corso di erogazione. La struttura di erogazione dei servizi sanitari per visualizzare e prendere in carico una ricetta dematerializzata inserita elettronicamente dal medico prescrittore comunica al SAR il Numero di Ricetta Elettronica (NRE) unitamente al codice fiscale dell assistito per cui è stata compilata elettronicamente la ricetta dematerializzata, prelevandolo dalla Tessera Sanitaria. Nel caso di assistiti del Servizio Sanitario Nazionale provvisti di Tessera Sanitaria, i dati per il recupero di una prescrizione sono entrambi presenti. Per i soggetti sprovvisti di codice fiscale, come gli stranieri, l informazione del codice fiscale non può essere fornita e la prescrizione viene recuperata solo tramite l NRE. Si ricorda comunque che in entrambi i casi il recupero di una prescrizione dematerializzata deve controllare negli archivi delle ricette prescritte i due valori contemporaneamente (condizione in and ), ed essi devono coincidere con i dati inseriti dal medico (NRE presente and CF presente oppure NRE presente and CF assente). La presa in carico esclusiva è condizionata dal fatto che la ricetta sia ancora da erogare (Stato Processo Ricetta =3). Nel caso in cui l erogatore, dopo avere visualizzato elettronicamente la ricetta dematerializzata, riservandosela esclusivamente, si accorga che l erogazione non può essere da lui effettata, deve revocare tramite l apposito tipo operazione, la ricetta che aveva visualizzato in maniera esclusiva, in modo che sia nuovamente disponibile agli altri erogatori: in tal caso la ricetta dematerializzata torna nello stato ricetta da erogare (Stato Processo Ricetta = 3). L erogatore, nel caso in cui l assistito abbia richiesto al medico in fase di compilazione della ricetta dematerializzata di oscurare il suo cognome e nome e il suo indirizzo, deve appositamente richiedere al SAR, di consultare tali dati, come previsto dalla legge. Il SAR tiene conto di tale richiesta nei propri archivi. L azione di visualizzazione esclusiva della ricetta da parte dell erogatore e la presa in carico eseguita con successo imposta lo Stato Processo Ricetta al valore 5 ricetta in corso di erogazione. Solo l erogatore, che con la sua richiesta di visualizzazione e presa in carico esclusiva ha fatto sì che venisse impostato tale stato, può effettuare le operazioni possibili successivamente, valendo la regola che un unico erogatore tratta tutto il ciclo di erogazione specialistica. 42

43 Modalità utilizzo Opzione 1 e 2 del Servizio: se utilizzato per la prima volta con tipo operazione 1 oppure 2 il servizio effettua la visualizzazione e la presa in carico in esclusiva di una ricetta da parte di una struttura di erogazione, gli utilizzi del servizio successivi alla presa in carico servono solo per visualizzare la ricetta, indipendentemente dallo stato in cui si trova, sempre utilizzando il tipo operazione 1 (ossia l utilizzo del servizio non cambia lo Stato Processo Ricetta della ricetta rispetto al valore che ha assunto). Modalità utilizzo opzione 5 del Servizio: deve essere utilizzata dall erogatore nel caso in cui nella fase della prenotazione non è possibile conoscere ancora la struttura di erogazione della prestazione, ma serve visualizzare i dati della ricetta e prenderla in carico indicando solo l azienda regionale di erogazione. dopo aver effettuato la prenotazione e aver individuato anche la struttura, l erogatore deve obbligatoriamente invocare di nuovo il servizio utilizzando opzioni 1 o 2. nel caso in cui la struttura non è stata individuata, l erogatore deve obbligatoriamente rilasciare la ricetta, invocando il servizio con opzione 3. Impostazione dei campi per opzione 5 del Servizio: codiceregioneerogatore: il dato è obbligatorio. codiceaslerogatore: il dato è obbligatorio. codicessaerogatore: il dato non deve mai essere impostato in tale fase, perché ancora non conosciuto, ma lo sarà solo quando si arriverà alla prenotazione da parte del CUP per una specifica struttura. Quindi il dato va impostato sempre a Modalità utilizzo opzione 4 del Servizio: può essere utilizzata dall erogatore nel caso in cui la ricetta ha i dati oscurati dal medico nella fase della prescrizione. può essere utilizzata solo dopo aver preso in carico la ricetta tramite le opzioni 1,2 e 5. come risposta riporta solo i dati anagrafici dell assistito Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione. 43

44 5.5.3 Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di visualizzazione e presa in carico ricetta VisualizzaErogatoRichiesta. Nome Campo Contenuto Caratteristiche pincode Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codiceregioneerogatore Codice della regione della struttura erogatrice. Elemento obbligatorio codiceaslerogatore Codice della ASL della struttura erogatrice. Elemento obbligatorio codicessaerogatore Codice identificativo della struttura erogatrice. Codici delle Elemento obbligatorio strutture erogatrici saranno verificati al momento di attivazione e comunicati dal SAR. Pwd Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo Nre Numero Ricetta Elettronico 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 SismedCF.cer. tipooperazione Valori possibili sono: 1,2,3,4,5. Il significato delle opzioni sono descritti nei capitoli precedenti relativi al servizio Descrizione messaggio di output Elemento obbligatorio Elemento obbligatorio Per ogni richiesta, il sistema risponde con un messaggio di tipo VisualizzaErogatoRicevuta, contenente l'esito della trasmissione. Formato dell'elemento VisualizzaErogatoRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note Dati della ricetta inserita dal medico prescrittore (dati comuni a tutta la ricetta). Per conoscere la lista dei dati che vengono restituiti, consultare il tracciato dei dati inviati dal medico prescrittore. Per dati comuni a tutta la ricetta si intendono i dati riferiti a tutta la ricetta prescritta e non quelli delle singole prescrizioni/prestazioni specialistiche in essa contenute, che sono riportati più avanti in questo tracciato con la dizione dati di dettaglio delle prescrizioni. Cognome e nome del medico: il campo testata1 contiene il cognome e nome del medico prescrittore, da mostrare a video all erogatore. Tali dati 44

45 Nome Campo Contenuto Note statoprocesso ChiusuraDiff chiusuraforzata prescrizionefruita tipoerogazionespec Ticket quotafissa Franchigia galdirchiamaltro dataspedizione dispric1 dispric2 dispric3 Stato Processo Ricetta: 3= ricetta da erogare 4= ricetta annullata dal prescrittore 5= ricetta in corso di erogazione 7= Singola prescrizione erogata 8= Ricetta erogata 9= Ricetta annullata e/o nuovamente erogata a seguito di annullamento Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Dichiarazione di effettiva fruizione della prestazione specialistica: 1- prescrizione fruita Tipologia di erogazione di ricette specialistiche. Valori ammessi: A="Accesso Diretto", P="Pronto Soccorso", D="Ricetta specialistica interna Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Ammontare della quota fissa che l assistito deve pagare per le prestazioni specialistiche secondo normativa nazionale e regionale. Ammontare della franchigia che l assistito deve pagare per le prestazioni specialistiche. Ammontare del prezzo per prestazioni di assistenza specialistica. Data di spedizione (ossia di erogazione) della ricetta Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Il campo di futuro utilizzo da parte del SAR. sono anche riportati sul promemoria cartaceo. Corrisponde alla firma che viene apposta dall assistito sul retro della ricetta cartacea al momento della fruizione delle prestazioni specialistiche. Impostato dall erogatore solo per ricette di specialistica. Impostato dall erogatore solo per ricette farmaceutiche. Impostato dall erogatore solo per ricette di specialistica. Impostato dall erogatore solo per ricette di specialistica. Elemento facoltativo Per ogni prescrizione ripetizione di DettaglioPrescrizioneVisualErogato statopresc Stato in cui si trova la singola prescrizione di una ricetta con seguenti valori: Indica se la singola prescrizione/prestazione specialistica è stata erogata oppure no. 45

46 Nome Campo Contenuto Note codprodpresterog descrprodpresterog flagerog motivazsostprod targa DichTargaDoppia codbranca tipoerogazionefarm 1 = Prescrizione da erogare 2 = Prescrizione erogata 3 = Prescrizione non erogata (per volontà dell assistito) facente parte di una ricetta le cui altre prestazioni sono state erogate e che risulta quindi chiusa totalmente Dati della ricetta inserita dal medico prescrittore (dati di dettaglio delle prescrizioni). Codice della prestazione specialistica effettivamente erogata, come da nomenclatore regionale. Descrizione della prestazione specialistica effettivamente erogata, come da nomenclatore regionale / catalogo regionale. Il flag assume diversi valori, ed è riferito a ciò che è stato inserito nel campo codprodpresterog: V = il codice prestazione inserito nel campo è stato variato dall erogatore specialistico rispetto a quanto prescritto dal medico. Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Codice della branca specialistica della prestazione, come da nomenclatore regionale. Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Tariffa della prestazione specialistica Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Per conoscere la lista dei dati che vengono restituiti, consultare il tracciato dei dati inviati dal medico prescrittore. Per dati di dettaglio delle prescrizioni si intendono i dati riferiti ad ognuna delle singole prescrizioni/prestazioni specialistiche della ricetta e non quelli della parte comune che sono riportati in questo tracciato con la dizione dati comuni a tutta la ricetta. Impostato dall erogatore solo per ricette farmaceutiche. Impostato dall erogatore solo per ricette farmaceutiche. Impostato dall erogatore solo per ricette farmaceutiche. Prezzo ticketconfezione Impostato dall erogatore solo per ricette farmaceutiche. diffgenerico Impostato dall erogatore solo per ricette farmaceutiche. quantitaerogata Quantità effettivamente erogata Il numero l effettivo di prestazioni 46

47 Nome Campo Contenuto Note erogate (attenzione: per le prestazioni cicliche, inserite dal medico come numero di cicli da n sedute, è indicato l effettivo numero di sedute erogate) datainierog Data inizio erogazione Data di inizio erogazione (sia di prestazioni cicliche che non cicliche). datafineerog Data fine erogazione Data di fine erogazione (sia di prestazioni cicliche che non cicliche). prezzorimborso Prezzo rimborso al laboratorio Solo per prestazioni specialistiche onereprod Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Impostato dall erogatore solo per ricette farmaceutiche. scontossn Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Impostato dall erogatore solo per ricette farmaceutiche. extrascontoindustria Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Impostato dall erogatore solo per ricette farmaceutiche. extrascontopayback Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Impostato dall erogatore solo per ricette farmaceutiche. extrascontodl Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Impostato dall erogatore solo per ricette farmaceutiche. codpresidio Presidio di erogazione della prestazione Solo per prestazioni specialistiche codreparto Codice del reparto di erogazione della prestazione dispfust1 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. dispfust2 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. dispfust3 Il campo di futuro utilizzo da parte del SAR. codcatalogoprescr Il campo è di output per l erogatore ed è impostato dal medico prescrittore unicamente per prescrizioni specialistiche; contiene il codice del catalogo regionale della prestazione prescritta. tipoaccesso Il campo è di output per l erogatore ed è impostato dal prescrittore, unicamente per prescrizioni specialistiche del PNGLA, indica se la prestazione richiesta si riferisce: ad un primo accesso (prima visita o primo esame di diagnostica strumentale, visita o prestazione di approfondimento erogati da specialista diverso dal primo osservatore e nel caso di un paziente cronico, si considera primo accesso, la visita o l esame strumentale, necessari in seguito ad un peggioramento del quadro 47

48 Nome Campo Contenuto Note clinico), codnomenclnaz codcatalogoerog garanziatempimax ad un accesso successivo (visita o prestazione di approfondimento, per pazienti presi in carico dal primo specialista,, controllo, follow up). Valori ammessi: 1= primo accesso, 0= altra tipologia di accesso Il campo è di output per l erogatore ed è impostato dal SAR; è valorizzato unicamente per prescrizioni specialistiche e può contenere: il valore del codice prestazione secondo il nomenclatore nazionale (nel caso di quelle prestazioni prescritte secondo il nomenclatore regionale che trovano corrispondenza nel nomenclatore nazionale; il campo viene valorizzato sia nel caso in cui il codice prestazione secondo il tariffario nazionale sia uguale o sia diverso da quello secondo il tariffario regionale) oppure il valore NONCODIF (nel caso di quelle prestazioni regionali che non trovano corrispondenza nel nomenclatore nazionale, in quanto Non Codificate, come sono ad esempio prestazioni ospedaliere passate al regime ambulatoriale (esempio: cataratta), prestazioni riconducibili a prestazioni del nomenclatore nazionale, nuovi LEA nazionali o prestazioni introdotte per adeguamento della tecnologia ma che sono riconosciute in altre regioni e possono essere erogate ad assistiti residenti anche in altre regioni) oppure il valore LAR (nel casi di prestazioni relative a livelli aggiuntivi regionali) Il campo, valorizzato unicamente per prescrizioni specialistiche, contiene il codice del catalogo regionale della prestazione erogata. Il campo, presente unicamente per prescrizioni specialistiche, è valorizzato con: 1 = utente a cui devono essere garantiti i Elemento facoltativo; obbligatorio per le prestazioni del PNGLA 48

49 Nome Campo Contenuto Note dataprenotazione codautenticazionemedico codautenticazioneerogatore codesitovisualizzazione tempi massimi di attesa; 0= utente che non rientra nella categoria precedente; Il campo, presente unicamente per prescrizioni specialistiche, è valorizzato con la data nel formato aaaammgg. Come da definizione del PNGLA la data è riferita all assegnazione di una disponibilità di prestazione susseguente ad una specifica richiesta. Codice di autenticazione fornito al medico prescrittore che certifica l avvenuta transazione sul SAR Codice di autenticazione fornito all erogatore che certifica l avvenuta transazione sul SAR Codice esito dell operazione di visualizzazione: 0000 = visualizzazione andata a buon fine senza presenza di segnalazioni = visualizzazione andata a buon fine ma con presenza di segnalazioni = visualizzazione non avvenuta. Elemento facoltativo; obbligatorio per le prestazioni del PNGLA Codice dell esito dell inserimento. Ripetizione di ErroreRicetta codesito Codice esito Per i valori si faccia riferimento al documento specifico. Esito Descrizione esito Per i valori si faccia riferimento al documento specifico progrpresc Progressivo prescrizione. Valori: 0= il codice esito vale per tutta la ricetta >0= indica la prescrizione a cui si fa riferimento, secondo l ordine in cui era stata inviata tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto Ripetizione di Comunicazione codice Codice dell eventuale messaggio di servizio messaggio Testo dell eventuale messaggio di servizio codesenaz Il campo è di output per l erogatore ed impostato dal Sistema SAR; è valorizzato solo se è stato inserito un codice esenzione nella prescrizione; può contenere: 49

50 Nome Campo Contenuto Note il valore riconosciuto a livello nazionale del codice esenzione regionale, (nel caso di quelle esenzioni con codifica regionale che hanno corrispondenza con la codifica nazionale; il campo viene sempre valorizzato sia nel caso in cui il codice erogazione regionale sia uguale o diverso da quello nazionale) il valore LAR (nel casi di esenzioni relative a livelli aggiuntivi regionali che non hanno corrispondenza con valori nazionali) N.B.: nel caso il prescrittore abbia utilizzato un codice esenzione composto (ad es. patologia + reddito), in tale campo codesenaz vengono restituiti i singoli codici riconosciuti a livello nazionale separati tra loro dal carattere pipe ( ) ad es. il codice 123XYZ viene restituito come 123 XYZ 5.6 Comunicazione dell erogazione e chiusura della ricetta Descrizione Servizio Il servizio permette alle strutture di erogazione dei servizi sanitari specialistici di trasmettere elettronicamente al SAR le informazioni inerenti la chiusura dell erogazione delle ricette dematerializzate registrate dai medici prescrittori; preventivamente le ricette devono essere state visualizzate e prese in carico in maniera esclusiva dalla struttura erogatrice (Stato Processo Ricetta=5). La presa in carico di una ricetta in maniera esclusiva e la chiusura dell erogazione devono essere effettuate dallo stesso soggetto erogatore. Per il servizio sono previste le operazioni descritte nei capitoli precedenti in funzione del processo. Al termine di queste operazioni, ossia quando risulta completamente lavorata, la ricetta passa allo Stato Processo Ricetta=8 ricetta erogata. Qualsiasi operazione sia stata effettuata, al momento dell erogazione e, di conseguenza, dell invio dei dati al SAR, la struttura di erogazione trasmette, tra l altro, il codice della prestazione erogata, oltre ai dati contabili derivanti dall erogazione. Dichiara inoltre, tramite la valorizzazione di un apposito campo, che l assistito attesta di avere fruito della prestazione specialistica. 50

51 Nel caso di Laboratorio di Analisi al momento di comunicazione delle prestazioni erogati per la ricetta può essere aggiunta anche la prestazione relativa al prelievo. Il codice della prestazione che deve essere comunicato in questo caso è obbligatoriamente _ Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di comunicazione della chiusura dell erogazione della ricetta InvioErogatoRichiesta. Tutti i campi riguardanti la Prescrizione devono essere trasmessi con i stessi valori con cui sono stati inseriti in fase della prescrizione. Nome Campo Contenuto Caratteristiche pincode Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codiceregioneerogatore Codice della regione della struttura erogatrice. Elemento obbligatorio codiceaslerogatore Codice della ASL della struttura erogatrice. Elemento obbligatorio codicessaerogatore Codice identificativo della struttura erogatrice. Codici delle Elemento obbligatorio strutture erogatrici saranno verificati al momento di attivazione e comunicati dal SAR. Pwd Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo Nre Numero Ricetta Elettronico 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 SismedCF.cer. tipooperazione Valori possibili sono: 1,2,3,6 Il significato delle opzioni sono descritti nei capitoli precedenti relativi al servizio. prescrizionefruita Dichiarazione di effettiva fruizione della prestazione specialistica, corrisponde alla firma che viene apposta dall assistito sul retro della ricetta cartacea al momento della fruizione delle prestazioni specialistiche: 1- prescrizione fruita Elemento obbligatorio Elemento obbligatorio Elemento obbligatorio tipoerogazionespec Tipologia di erogazione di ricette specialistiche. Valori ammessi: Elemento facoltativo 51

52 Nome Campo Contenuto Caratteristiche A="Accesso Diretto", P="Pronto Soccorso", D="Ricetta specialistica interna Ticket Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo quotafissa Ammontare della quota fissa che l assistito deve pagare Elemento facoltativo per le prestazioni specialistiche secondo normativa nazionale e regionale. Franchigia Ammontare della franchigia che l assistito deve pagare per le prestazioni specialistiche. Elemento obbligatorio (se assente indicare 0) galdirchiamaltro Ammontare del prezzo per prestazioni di assistenza Elemento obbligatorio specialistica. (se assente indicare 0) reddito Campo non è utilizzato. Il campo deve essere vuoto e Elemento non fa fede il codice di esenzione della ricetta prescritta. utilizzato dataspedizione Data di spedizione (ossia di erogazione) della ricetta Elemento obbligatorio dispric1 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric2 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric3 Il campo di futuro utilizzo da parte del SAR. Elemento facoltativo Elementi possono essere ripetuti più volte nell ambito della stessa ricetta, coerentemente con le regole di compilazione. codprodprest codgruppoequival descrtestoliberonote Codice della prestazione specialistica come indicato in prescritto. Codice del gruppo di equivalenza per la prescrizione con principio attivo come indicato nel prescritto Descrizione in testo libero da inserire solo per prestazioni specialistiche Elemento obbligatorio Elemento facoltativo Elemento facoltativo, ma obbligatorio se inserito in fase di prescrizione Elemento obbligatorio codprodpresterog Codice della prestazione specialistica effettivamente erogata, come da nomenclatore regionale descrprodpresterog Descrizione della prestazione specialistica effettivamente Elemento obbligatorio erogata, come da nomenclatore regionale flagerog Il flag assume diversi valori, ed è riferito a ciò che è stato Elemento facoltativo inserito nel campo codprodpresterog. V = il codice prestazione inserito nel campo è stato variato dall erogatore specialistico rispetto a quanto prescritto dal medico, con un altra prestazione appartenente alla stessa branca motivazsostprod Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo targa Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo DichTargaDoppia Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codbranca Codice della branca specialistica della prestazione, come Elemento obbligatorio da nomenclatore regionale. tipoerogazionefarm Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo Prezzo Tariffa della prestazione specialistica Elemento obbligatorio ticketconfezione Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) diffgenerico Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) 52

53 Nome Campo Contenuto Caratteristiche quantitaerogata Quantità effettivamente erogata. (Attenzione: per le Elemento obbligatorio prestazioni cicliche, inserite dal medico come numero di cicli da n sedute, è indicato l effettivo numero di sedute erogate) datainierog Data di inizio erogazione (sia di prestazioni cicliche che non Elemento obbligatorio cicliche). datafineerog Data di fine erogazione (sia di prestazioni cicliche che non Elemento obbligatorio cicliche). prezzorimborso Prezzo rimborso al laboratorio Elemento obbligatorio onereprod Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) scontossn Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) extrascontoindustria Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) extrascontopayback Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) extrascontodl Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) codpresidio Presidio di erogazione della prestazione Elemento facoltativo codreparto Codice del reparto di erogazione della prestazione Elemento facoltativo dispfust1 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispfust2 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispfust3 Il campo di futuro utilizzo da parte del SAR. Elemento facoltativo codcatalogoprescr codcatalogoerog Il campo è di output per l erogatore ed è impostato dal medico prescrittore unicamente per prescrizioni specialistiche; contiene il codice del catalogo regionale della prestazione prescritta. Il campo deve contenere il codice del catalogo regionale della prestazione effettivamente erogata. Elemento facoltativo, ma obbligatorio se inserito in fase di prescrizione Elemento facoltativo. garanziatempimax dataprenotazione Il campo, presente unicamente per prescrizioni specialistiche, è valorizzato con: 1 = utente a cui devono essere garantiti i tempi massimi di attesa; 0= utente che non rientra nella categoria precedente; Il campo, presente unicamente per prescrizioni specialistiche, è valorizzato con la data nel formato aaaammgg. Come da definizione del PNGLA la data è riferita all assegnazione di una disponibilità di prestazione susseguente ad una specifica richiesta. Elemento facoltativo; obbligatorio per le prestazioni del PNGLA Elemento facoltativo; obbligatorio per le prestazioni del PNGLA 53

54 5.6.4 Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo VisualizzaErogatoRicevuta, contenente l'esito della trasmissione. Formato dell'elemento InvioErogatoRicevuta in caso di corretta ricezione: nre Nome Campo Contenuto Note dataricezione codautenticazione codesitovisualizzazione NRE in caso di inserimento andato a buon fine, sia nel caso in cui la ricetta già lo contenga sia nel caso in cui venga trasmesso dal SAR. data di ricezione Codice di autenticazione dell avvenuta transazione Codice esito dell operazione di visualizzazione: 0000 = visualizzazione andata a buon fine senza presenza di segnalazioni = visualizzazione andata a buon fine ma con presenza di segnalazioni = visualizzazione non avvenuta. Ripetizione di ErroreRicetta codesito Codice esito Per i valori si faccia riferimento al documento specifico. Esito Descrizione esito Per i valori si faccia riferimento al documento specifico. progrpresc Progressivo prescrizione. Valori: 0= il codice esito vale per tutta la ricetta >0= indica la prescrizione a cui si fa riferimento, secondo l ordine in cui era stata inviata il campo indica il progressivo di ogni singola prescrizione/prestazione specialistica presente in una ricetta dematerializzata, secondo l ordine con cui ognuna è stata scritta nella richiesta SOAP inviata in fase di chiusura erogazione. Per le prestazioni specialistiche invece il progressivo viene impostato per ogni prestazione prescritta, indipendentemente dalla quantità. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto Ripetizione di Comunicazione codice Codice dell eventuale messaggio di servizio messaggio Testo dell eventuale messaggio di servizio 54

55 5.7 Annullamento dell erogazione della ricetta Descrizione Servizio Nel caso in cui l erogatore si accorga di avere commesso errori nella trasmissione dei dati di una ricetta dematerializzata che è stata erogata (Stato Processo Ricette=8), può comunicare al sistema che intende annullare quanto inserito ed inviare nuovamente i dati corretti con gli appositi web services Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di visualizzazione e presa in carico ricetta AnnullaErogatoRichiesta. Nome Campo Contenuto Caratteristiche pincode Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codiceregioneerogatore Codice della regione della struttura erogatrice. Elemento obbligatorio codiceaslerogatore Codice della ASL della struttura erogatrice. Elemento obbligatorio codicessaerogatore Codice identificativo della struttura erogatrice. Codici delle Elemento obbligatorio strutture erogatrici saranno verificati al momento di attivazione e comunicati dal SAR. Pwd Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo Nre Numero Ricetta Elettronico 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 SismedCF.cer. codannullamento Valori possibili sono: 2,3. Il significato dei codici sono descritti nei capitoli precedenti relativi al servizio. Elemento obbligatorio Elemento obbligatorio Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo AnnullaErogatoRicevuta, contenente l'esito della trasmissione. 55

56 Formato dell'elemento AnnullaErogatoRicevuta in caso di corretta ricezione: nre Nome Campo Contenuto Note dataricezione codautenticazione codesitoannullamento NRE in caso di inserimento andato a buon fine, sia nel caso in cui la ricetta già lo contenga sia nel caso in cui venga trasmesso dal SAR. data di ricezione Codice di autenticazione dell avvenuta transazione Codice esito dell operazione di visualizzazione: 0000 = visualizzazione andata a buon fine senza presenza di segnalazioni = visualizzazione andata a buon fine ma con presenza di segnalazioni = visualizzazione non avvenuta. Ripetizione di ErroreRicetta codesito Codice esito Per i valori si faccia riferimento al documento specifico. Esito Descrizione esito Per i valori si faccia riferimento al documento specifico. progrpresc Progressivo prescrizione. Valori: 0= il codice esito vale per tutta la ricetta >0= indica la prescrizione a cui si fa riferimento, secondo l ordine in cui era stata inviata il campo indica il progressivo di ogni singola prescrizione/prestazione specialistica presente in una ricetta dematerializzata, secondo l ordine con cui ognuna è stata scritta nella richiesta SOAP inviata in fase di chiusura erogazione. Per le prestazioni specialistiche invece il progressivo viene impostato per ogni prestazione prescritta, indipendentemente dalla quantità. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto Ripetizione di Comunicazione codice Codice dell eventuale messaggio di servizio messaggio Testo dell eventuale messaggio di servizio 56

57 5.8 Comunicazione di malfunzionamento del Sistema Erogatore Descrizione Servizio Il sistema di tracciatura dei malfunzionamenti ha come scopo principale quello di consentire all erogatore la trasmissione in differita delle informazioni inerenti le prestazioni erogate sulla base del promemoria, vista la mancanza di collegamento con il Sistema che permette la visualizzazione informatica dei dati di prescrizione. A seguito di tale premessa risulta indispensabile la comunicazione del malfunzionamento preventiva rispetto all erogazione della prima ricetta dematerializzata effettuata sulla base dei dati del promemoria cartaceo. Il Sistema SAR, che registra la comunicazione di apertura malfunzionamento, tiene conto dell orario in cui l erogatore effettua tale segnalazione. La comunicazione di malfunzionamento deve quindi essere inviata ogni qualvolta non possono essere visualizzati informaticamente i dati della ricetta inseriti dal medico, per cui l erogazione avviene unicamente in base a quanto riportato nel promemoria cartaceo. La comunicazione si intende per evento (cumulativa di più ricette) e mai per singola ricetta. Una segnalazione di malfunzionamento è valida fino alla prima spedizione di dati in differita, che la chiude automaticamente. Quindi se una segnalazione di malfunzionamento risulta ancora aperta, non se ne può comunicare un altra Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di invio della segnalazione di malfunzionamento. InvioSegnalazioneRichiesta. Nome Campo Contenuto Caratteristiche pincode Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codiceregioneerogatore Codice della regione della struttura erogatrice. Elemento obbligatorio codiceaslerogatore Codice della ASL della struttura erogatrice. Elemento obbligatorio codicessaerogatore Codice identificativo della struttura erogatrice. Codici delle Elemento obbligatorio strutture erogatrici saranno verificati al momento di attivazione e comunicati dal SAR. Pwd Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codmotivazione Codice associato alla motivazione di apertura guasto. Il guasto deve obbligatoriamente essere aperto solo per motivazioni imputabili all erogatore. Elemento obbligatorio 57

58 Nome Campo Contenuto Caratteristiche Valore ammesso: 1 =malfunzionamento attribuibile al sistema dell erogatore datadal Data da cui si deve fare iniziare il periodo di Elemento obbligatorio malfunzionamento nel formato aaaa-mm-gg hh24:mm:ss. Attenzione: la dichiarazione da parte dell erogatore dell ora e dei minuti d inizio malfunzionamento risulta indispensabile ai fini della corretta rilevazione dell anomalia, come da regole esposte in tale capitolo. Note Campo a disposizione per eventuali note testuali, che non Elemento facoltativo costituiscono ulteriori causali di motivazione oltre quella codificata. dispric1 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric2 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric3 Il campo di futuro utilizzo da parte del SAR. Elemento facoltativo Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo InvioSegnalazione, contenente l'esito della trasmissione. Formato dell'elemento InvioSegnalazioneRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note numsegnalazioneanomalia Numero che viene restituito dal SAR per ogni apertura segnalazione malfunzionamento attribuibile all erogatore. Tale numero deve essere utilizzato per la trasmissione in differita delle ricette erogate. dataricezione Data in cui è stata ricevuta dal SAR la segnalazione di malfunzionamento. codesitosegnalazione Codice esito dell operazione di visualizzazione: 0000 = visualizzazione andata a buon fine senza presenza di segnalazioni = visualizzazione andata a buon fine ma con presenza di segnalazioni = visualizzazione non avvenuta. Ripetizione di ErroreRicetta codesito Codice esito Per i valori si faccia riferimento al documento specifico. Esito Descrizione esito Per i valori si faccia riferimento al documento specifico. progrpresc Progressivo prescrizione. Valori: 0= il codice esito vale per tutta la ricetta >0= indica la prescrizione a cui si fa riferimento, secondo l ordine in cui era il campo indica il progressivo di ogni singola prescrizione/prestazione specialistica presente in una ricetta dematerializzata, secondo l ordine con cui ognuna è stata scritta nella richiesta 58

59 Nome Campo Contenuto Note stata inviata SOAP inviata in fase di chiusura erogazione. Per le prestazioni specialistiche invece il progressivo viene impostato per ogni prestazione prescritta, indipendentemente dalla quantità. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto Ripetizione di Comunicazione codice Codice dell eventuale messaggio di servizio messaggio Testo dell eventuale messaggio di servizio 5.9 Ricerca segnalazione del malfunzionamento Descrizione Servizio Con tale tipo di interrogazioni si ottengono delle liste (da 1 a n elementi) di numeri segnalazione anomalia e dati ad essi associati. Le interrogazioni possibili sono le seguenti: per un determinato numero segnalazione malfunzionamento valorizzare: numsegnalazioneanomalia per mese ed anno valorizzare: meseanno Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di ricerca di segnalazione di malfunzionamento. RicercaSegnalazioniRichiesta. Nome Campo Contenuto Caratteristiche pincode Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codiceregioneerogatore Codice della regione della struttura erogatrice. Elemento obbligatorio codiceaslerogatore Codice della ASL della struttura erogatrice. Elemento obbligatorio 59

60 Nome Campo Contenuto Caratteristiche codicessaerogatore Codice identificativo della struttura erogatrice. Codici Elemento obbligatorio delle strutture erogatrici saranno verificati al momento di attivazione e comunicati dal SAR. Pwd Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo numsegnalazioneanomalia Numero che viene restituito dal SAR per ogni apertura Elemento obbligatorio segnalazione malfunzionamento attribuibile all erogatore. meseanno Mese e anno di cui si vuole ottenere una lista di numeri Elemento obbligatorio segnalazione. Formato mm-aaaa dispric1 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric2 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric3 Il campo di futuro utilizzo da parte del SAR. Elemento facoltativo Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo RicercaSegnalazioniRicevuta, contenente l'esito della trasmissione. Formato dell'elemento RicercaSegnalazioniRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note codesitoricercasegnalazioni Codice esito dell operazione di visualizzazione: 0000 = visualizzazione andata a buon fine senza presenza di segnalazioni = visualizzazione andata a buon fine ma con presenza di segnalazioni = visualizzazione non avvenuta. totalesegnalazioni Numero delle segnalazioni trovate a seguito del parametro di ricerca adottato. Ripetizione di DettaglioSegnalazione numsegnalazioneanomalia Numero di segnalazione anomalia datainizio Data di inizio segnalazione guasto. datafine motivazione Data di fine segnalazione guasto. Campo che indica la motivazione della segnalazione. Ripetizione di ErroreRicetta codesito Codice esito Per i valori si faccia riferimento al documento specifico. Esito Descrizione esito Per i valori si faccia riferimento al documento specifico. progrpresc Progressivo prescrizione. Valori: 0= il codice esito vale per tutta la ricetta >0= indica la prescrizione a cui si fa riferimento, secondo l ordine in cui era il campo indica il progressivo di ogni singola prescrizione/prestazione specialistica presente in una ricetta dematerializzata, secondo l ordine con cui ognuna è stata scritta nella 60

61 Nome Campo Contenuto Note stata inviata richiesta SOAP inviata in fase di chiusura erogazione. Per le prestazioni specialistiche invece il progressivo viene impostato per ogni prestazione prescritta, indipendentemente dalla quantità. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto. Ripetizione di Comunicazione codice Codice dell eventuale messaggio di servizio messaggio Testo dell eventuale messaggio di servizio 5.10 Comunicazione Erogazione delle ricette in differita Descrizione Servizio Il Servizio deve seguire le regole del processo descritto nei capitoli precedenti per l invio delle ricette in differita Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di invio in differita di erogazione delle ricette dematerializzate InvioErogatoDiffRichiesta. Nome Campo Contenuto Caratteristiche pincode Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codiceregioneerogatore Codice della regione della struttura erogatrice. Elemento obbligatorio codiceaslerogatore Codice della ASL della struttura erogatrice. Elemento obbligatorio codicessaerogatore Codice identificativo della struttura erogatrice. Codici Elemento obbligatorio delle strutture erogatrici saranno verificati al momento di attivazione e comunicati dal SAR. Pwd Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo 61

62 Nome Campo Contenuto Caratteristiche numsegnalazioneanomalia Può contenere diversi codici; per sapere quale, leggere le istruzioni riportate in questo paragrafo alla voce: Cosa Elemento obbligatorio deve essere indicato nel campo numsegnalazioneanomalia? nre Numero Ricetta Elettronico Elemento obbligatorio cfmedico1 cfassistito tiporic cognnome indirizzo Codice fiscale del medico che appare sul promemoria cartaceo dal quale si è erogato senza visualizzare i dati elettronici. Codice fiscale dell assistito che appare sul promemoria cartaceo dal quale si è erogato senza visualizzare i dati elettronici. Tale campo deve essere inserito criptato tramite l utilizzo del certificato SismedCF.cer. codesenzione Codice esenzione come appare sul promemoria cartaceo dal quale si è erogato senza visualizzare i dati elettronici. nonesente Codice biffatura NON ESENTE come appare sul promemoria cartaceo dal quale si è erogato senza visualizzare i dati elettronici. Impostare sempre con uno dei due Valori ammessi: null = ricetta per assistito esente, 1= ricetta per assistito non esente. coddiagnosi descrizionediagnosi datacompilazione tipovisita dispreg provassistito aslassistito Elemento obbligatorio Elemento obbligatorio (solo se presente su promemoria). Se il cfassistito non è presente sul promemoria, perché la ricetta è prescritta ad uno straniero, non è necessario indicare i dati del soggetto assicurato da istituzioni estere (vedi di seguito), se coincidono tra dato elettronico visualizzato e dato del promemoria. Elemento facoltativo Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. 62

63 Nome Campo Contenuto Caratteristiche indicazioneprescr altro classepriorita Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. statoestero Stato del soggetto assicurato da istituzioni estere Elemento facoltativo. istituzcompetente Istituzione competente del soggetto Elemento facoltativo. assicurato da istituzioni estere numidentpers Numero di identificazione personale del soggetto Elemento facoltativo. assicurato da istituzioni estere numidenttess Numero di identificazione della tessera del soggetto Elemento facoltativo. assicurato da istituzioni estere datanascitaestero Data di nascita del soggetto assicurato da istituzioni Elemento facoltativo. estere nel formato Aaaa-mm-gg datanascitaestero Data di nascita del soggetto assicurato da istituzioni Elemento facoltativo. estere nel formato Aaaa-mm-gg prescrizionefruita Dichiarazione di effettiva fruizione della prestazione Elemento obbligatorio specialistica, corrisponde alla firma che viene apposta dall assistito sul retro della ricetta cartacea al momento della fruizione delle prestazioni specialistiche: 1- prescrizione fruita tipoerogazionespec Tipologia di erogazione di ricette specialistiche. Elemento facoltativo Valori ammessi: A="Accesso Diretto", P="Pronto Soccorso", D="Ricetta specialistica interna Ticket Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (se assente indicare 0) quotafissa Ammontare della quota fissa che l assistito deve pagare per le prestazioni specialistiche secondo normativa nazionale e regionale. Elemento obbligatorio (se assente indicare 0) Franchigia galdirchiamaltro Ammontare della franchigia che l assistito deve pagare per le prestazioni specialistiche. Ammontare del prezzo per prestazioni di assistenza specialistica. Elemento obbligatorio (se assente indicare 0) Elemento obbligatorio (se assente indicare 0) reddito Campo non è utilizzato. Il campo deve essere vuoto e fa fede il codice di esenzione della ricetta prescritta. Elemento non utilizzato. dataspedizione Data di spedizione (ossia di erogazione) della ricetta Elemento obbligatorio codautenticazione Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric1 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric2 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric3 Il campo per le indicazione dei risultati di verifica effettuati dal Sistema Erogatore prima di effettuare l invio di erogazione di ricetta in differita tramite il servizio VisualizzaErogatoService. I valori possibili sono: Elemento obbligatorio 63

64 Nome Campo Contenuto Caratteristiche Nel caso in cui la verifica tramite il servizio di visualizzazione è andata a buon fine i valori da inserire sono: A i dati della ricetta visualizzata tramite il servizio coincidono completamente con promemoria cartacea. B i dati della ricetta visualizzata tramite il servizio non coincidono completamente con promemoria cartacea. Nel caso in cui la verifica tramite il servizio di visualizzazione ha segnalato che la ricetta è stata presa in carico da un altra struttura erogatrice il valore da inserire è: Nel caso in cui la verifica tramite il servizio di visualizzazione ha segnalato che la ricetta non esiste il valore da inserire è: dispric4 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric5 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo Elementi possono essere ripetuti per un numero maggiore di volte nell ambito della stessa ricetta. codprodprest Codice della prestazione specialistica come indicato Elemento facoltativo nella promemoria descrprodprest Elemento facoltativo codgruppoequival Codice del gruppo di equivalenza per la prescrizione con Elemento facoltativo principio attivo come indicato nella promemoria descrgruppoequival Elemento facoltativo descrtestoliberonote Descrizione in testo libero da inserire solo per prestazioni Elemento facoltativo specialistiche. nonsost Elemento facoltativo motivaznote Elemento facoltativo codmotivazione Elemento facoltativo notaprod Elemento facoltativo quantita Elemento facoltativo prescrizione1 Elemento facoltativo prescrizione2 Elemento facoltativo codprodpresterog Codice della prestazione specialistica effettivamente Elemento obbligatorio erogata, come da nomenclatore regionale descrprodpresterog Descrizione della prestazione specialistica effettivamente Elemento obbligatorio erogata, come da nomenclatore regionale flagerog Il flag assume diversi valori, ed è riferito a ciò che è stato Elemento facoltativo inserito nel campo codprodpresterog. V = il codice prestazione inserito nel campo è stato variato dall erogatore specialistico rispetto a quanto prescritto dal medico, con un altra prestazione appartenente alla stessa branca motivazsostprod Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo targa Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo DichTargaDoppia Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codbranca Codice della branca specialistica della prestazione, come da nomenclatore regionale. Elemento obbligatorio 64

65 Nome Campo Contenuto Caratteristiche tipoerogazionefarm Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo Prezzo Tariffa della prestazione specialistica Elemento obbligatorio ticketconfezione Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) diffgenerico Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) quantitaerogata Quantità effettivamente erogata. (Attenzione: per le Elemento obbligatorio prestazioni cicliche, inserite dal medico come numero di cicli da n sedute, è indicato l effettivo numero di sedute erogate) datainierog Data di inizio erogazione (sia di prestazioni cicliche che Elemento obbligatorio non cicliche). datafineerog Data di fine erogazione (sia di prestazioni cicliche che Elemento obbligatorio non cicliche). prezzorimborso Prezzo rimborso al laboratorio Elemento obbligatorio onereprod Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) scontossn Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) extrascontoindustria Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) extrascontopayback Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) extrascontodl Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) codpresidio Presidio di erogazione della prestazione Elemento facoltativo codreparto Codice del reparto di erogazione della prestazione Elemento facoltativo dispfust1 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispfust2 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispfust3 Il campo di futuro utilizzo da parte del SAR. Elemento facoltativo dispfust4 Il campo di futuro utilizzo da parte del SAR. Elemento facoltativo dispfust5 Il campo di futuro utilizzo da parte del SAR. Elemento facoltativo codcatalogoprescr Il campo è di output per l erogatore ed è impostato dal Elemento facoltativo medico prescrittore unicamente per prescrizioni specialistiche; contiene il codice del catalogo regionale della prestazione prescritta. tipoaccesso Il campo, da utilizzarsi unicamente per prescrizioni specialistiche del PNGLA, indica se la prestazione richiesta si riferisce: ad un primo accesso (prima visita o primo esame di diagnostica strumentale, visita o prestazione di approfondimento erogati da specialista diverso dal primo osservatore e nel caso di un paziente cronico, si considera primo accesso, la visita o l esame strumentale, necessari in seguito ad un peggioramento del quadro clinico), ad un accesso successivo (visita o prestazione di Elemento facoltativo 65

66 Nome Campo Contenuto Caratteristiche codcatalogoerog garanziatempimax dataprenotazione approfondimento, per pazienti presi in carico dal primo specialista,, controllo, follow up). Valori ammessi: 1= primo accesso, 0= altra tipologia di accesso Il campo contiene il codice del catalogo regionale della prestazione erogata. Il campo, presente unicamente per prescrizioni specialistiche, è valorizzato con: 1 = utente a cui devono essere garantiti i tempi massimi di attesa; 0= utente che non rientra nella categoria precedente; Il campo, presente unicamente per prescrizioni specialistiche, è valorizzato con la data nel formato aaaammgg. Come da definizione del PNGLA la data è riferita all assegnazione di una disponibilità di prestazione susseguente ad una specifica richiesta. Elemento facoltativo Elemento facoltativo; obbligatorio per le prestazioni del PNGLA Elemento facoltativo; obbligatorio per le prestazioni del PNGLA Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo InvioErogatoDiffRicevuta, contenente l'esito della trasmissione. Formato dell'elemento InvioErogatoDiffRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note idricetta nre dataricezione codautenticazione Numero univoco che viene assegnato dal SAR ad ogni ricetta trasmessa in differita: potendo essere trasmesse anche più di una ricetta in differita con uguale NRE sia da parte dello stesso erogatore che da erogatori diversi (si ricorda che l erogazione è avvenuta in assenza di accesso al dato elettronico e quindi non è stato possibile il controllo di univocità dell NRE), il sistema assegna sempre un numero univoco a ciascuna ricetta in differita, che deve essere utilizzato per le interrogazioni puntuali. I sistemi gestonali devono quindi tenere traccia di tale numero assegnato in fase di registrazione ricetta in differita. NRE in caso di inserimento andato a buon fine, sia nel caso in cui la ricetta già lo contenga sia nel caso in cui venga trasmesso dal SAR. data di ricezione Codice di autenticazione dell avvenuta 66

67 Nome Campo Contenuto Note transazione codesitoinserimento Codice esito dell operazione di visualizzazione: 0000 = visualizzazione andata a buon fine senza presenza di segnalazioni = visualizzazione andata a buon fine ma con presenza di segnalazioni = visualizzazione non avvenuta. Ripetizione di ErroreRicetta codesito Codice esito Per i valori si faccia riferimento al documento specifico. Esito Descrizione esito Per i valori si faccia riferimento al documento specifico. progrpresc Progressivo prescrizione. Valori: 0= il codice esito vale per tutta la ricetta >0= indica la prescrizione a cui si fa riferimento, secondo l ordine in cui era stata inviata il campo indica il progressivo di ogni singola prescrizione/prestazione specialistica presente in una ricetta dematerializzata, secondo l ordine con cui ognuna è stata scritta nella richiesta SOAP inviata in fase di chiusura erogazione. Per le prestazioni specialistiche invece il progressivo viene impostato per ogni prestazione prescritta, indipendentemente dalla quantità. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto Ripetizione di Comunicazione codice Codice dell eventuale messaggio di servizio messaggio Testo dell eventuale messaggio di servizio 5.11 Visualizzazione Erogazioni delle ricette in differita Descrizione Servizio Il Servizio deve seguire le regole del processo descritto nei capitoli precedenti per l invio delle ricette in differita Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione. 67

68 Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di visualizzazione delle ricette erogate in differita VisualizzaErogatoDiffRichiesta. Nome Campo Contenuto Caratteristiche pincode Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codiceregioneerogatore Codice della regione della struttura erogatrice. Elemento obbligatorio codiceaslerogatore Codice della ASL della struttura erogatrice. Elemento obbligatorio codicessaerogatore Codice identificativo della struttura erogatrice. Codici Elemento obbligatorio delle strutture erogatrici saranno verificati al momento di attivazione e comunicati dal SAR. Pwd Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo idricetta Numero univoco che viene assegnato dal SAR ad ogni Elemento obbligatorio ricetta trasmessa in differita: potendo essere trasmesse anche più di una ricetta in differita con uguale NRE sia da parte dello stesso erogatore che da erogatori diversi (si ricorda che l erogazione è avvenuta in assenza di accesso al dato elettronico e quindi non è stato possibile il controllo di univocità dell NRE), il sistema assegna sempre un numero univoco a ciascuna ricetta in differita, che deve essere utilizzato per le interrogazioni puntuali. I sistemi gestonali devono quindi tenere traccia di tale numero assegnato in fase di registrazione ricetta in differita. Nre Numero Ricetta Elettronico Elemento obbligatorio cfassistito Codice fiscale dell assistito. Se l assistito è provvisto di Elemento obbligatorio 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 SismedCF.cer. numsegnalazioneanomalia Numero segnalazione anomalia Elemento facoltativo disp1 Campo a disposizione per futuro utilizzo Elemento facoltativo disp2 Campo a disposizione per futuro utilizzo Elemento facoltativo disp3 Campo a disposizione per futuro utilizzo Elemento facoltativo Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo VisualizzaErogatoDiffRicevuta, contenente l esito della richiesta. Formato dell elemento VisualizzaErogatoDiffRicevuta in caso di corretta ricezione: Nome Campo Contenuto Caratteristiche 68

69 Nome Campo Contenuto Caratteristiche idricetta Numero univoco che viene assegnato dal SAR ad ogni Elemento obbligatorio ricetta trasmessa in differita: potendo essere trasmesse anche più di una ricetta in differita con uguale NRE sia da parte dello stesso erogatore che da erogatori diversi (si ricorda che l erogazione è avvenuta in assenza di accesso al dato elettronico e quindi non è stato possibile il controllo di univocità dell NRE), il sistema assegna sempre un numero univoco a ciascuna ricetta in differita, che deve essere utilizzato per le interrogazioni puntuali. I sistemi gestonali devono quindi tenere traccia di tale numero assegnato in fase di registrazione ricetta in differita. nre Numero Ricetta Elettronico Elemento obbligatorio cfmedico1 cfassistito tiporic cognnome indirizzo Codice fiscale del medico che appare sul promemoria cartaceo dal quale si è erogato senza visualizzare i dati elettronici. Codice fiscale dell assistito che appare sul promemoria cartaceo dal quale si è erogato senza visualizzare i dati elettronici. Tale campo deve essere inserito criptato tramite l utilizzo del certificato SismedCF.cer. codesenzione Codice esenzione come appare sul promemoria cartaceo dal quale si è erogato senza visualizzare i dati elettronici. nonesente Codice biffatura NON ESENTE come appare sul promemoria cartaceo dal quale si è erogato senza visualizzare i dati elettronici. Impostare sempre con uno dei due Valori ammessi: null = ricetta per assistito esente, 1= ricetta per assistito non esente. coddiagnosi descrizionediagnosi Elemento facoltativo Elemento obbligatorio (solo se presente su promemoria). Se il cfassistito non è presente sul promemoria, perché la ricetta è prescritta ad uno straniero, non è necessario indicare i dati del soggetto assicurato da istituzioni estere (vedi di seguito), se coincidono tra dato elettronico visualizzato e dato del promemoria. Elemento facoltativo Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. 69

70 Nome Campo Contenuto Caratteristiche datacompilazione tipovisita dispreg provassistito aslassistito indicazioneprescr altro classepriorita Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. Elemento facoltativo. statoestero Stato del soggetto assicurato da istituzioni estere Elemento facoltativo. istituzcompetente Istituzione competente del soggetto Elemento facoltativo. assicurato da istituzioni estere numidentpers Numero di identificazione personale del soggetto Elemento facoltativo. assicurato da istituzioni estere numidenttess Numero di identificazione della tessera del soggetto Elemento facoltativo. assicurato da istituzioni estere datanascitaestero Data di nascita del soggetto assicurato da istituzioni Elemento facoltativo. estere nel formato Aaaa-mm-gg datanascitaestero Data di nascita del soggetto assicurato da istituzioni Elemento facoltativo. estere nel formato Aaaa-mm-gg prescrizionefruita Dichiarazione di effettiva fruizione della prestazione Elemento obbligatorio specialistica, corrisponde alla firma che viene apposta dall assistito sul retro della ricetta cartacea al momento della fruizione delle prestazioni specialistiche: 1- prescrizione fruita tipoerogazionespec Tipologia di erogazione di ricette specialistiche. Elemento facoltativo Valori ammessi: A="Accesso Diretto", P="Pronto Soccorso", D="Ricetta specialistica interna Ticket Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (se assente indicato 0) quotafissa Ammontare della quota fissa che l assistito deve pagare per le prestazioni specialistiche secondo normativa Elemento obbligatorio (se assente indicato 0) nazionale e regionale. Franchigia Ammontare della franchigia che l assistito deve pagare per le prestazioni specialistiche. Elemento obbligatorio (se assente indicato 0) galdirchiamaltro Ammontare del prezzo per prestazioni di assistenza Elemento obbligatorio reddito specialistica. Campo che indica se l assistito è esente per reddito oppure no. Corrisponde al campo R (REDDITO) della ricetta cartacea, che con nuove regole sui codici esenzione non viene più compilato. Valori ammessi: null = ricetta per assistito non esente per reddito; 1= ricetta per assistito esente per reddito (se assente indicato 0) Elemento facoltativo 70

71 Nome Campo Contenuto Caratteristiche dataspedizione Data di spedizione (ossia di erogazione) della ricetta Elemento obbligatorio codautenticazione Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric1 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric2 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric3 Il campo per le indicazioni dei risultati di verifica effettuati Elemento obbligatorio dal Sistema Erogatore prima di effettuare l invio di erogazione di ricetta in differita tramite il servizio VisualizzaErogatoService. I valori possibili sono: Nel caso in cui la verifica tramite il servizio di visualizzazione è andata a buon fine i valori da inserire sono: A i dati della ricetta visualizzata tramite il servizio coincidono completamente con promemoria cartacea. B i dati della ricetta visualizzata tramite il servizio non coincidono completamente con promemoria cartacea. Nel caso in cui la verifica tramite il servizio di visualizzazione ha segnalato che la ricetta è stata presa in carico da un altra struttura erogatrice il valore da inserire è: Nel caso in cui la verifica tramite il servizio di visualizzazione ha segnalato che la ricetta non esiste il valore da inserire è: dispric4 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispric5 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo Elementi possono essere ripetuti per un numero maggiore di volte nell ambito della stessa ricetta. codprodprest Codice della prestazione specialistica come indicato Elemento facoltativo nella promemoria descrprodprest Elemento facoltativo codgruppoequival Codice del gruppo di equivalenza per la prescrizione con Elemento facoltativo principio attivo come indicato nella promemoria descrgruppoequival Elemento facoltativo descrtestoliberonote Descrizione in testo libero da inserire solo per prestazioni Elemento facoltativo specialistiche. nonsost Elemento facoltativo motivaznote Elemento facoltativo codmotivazione Elemento facoltativo notaprod Elemento facoltativo quantita Elemento facoltativo prescrizione1 Elemento facoltativo prescrizione2 Elemento facoltativo codprodpresterog Codice della prestazione specialistica effettivamente Elemento obbligatorio erogata, come da nomenclatore regionale descrprodpresterog Descrizione della prestazione specialistica effettivamente Elemento obbligatorio erogata, come da nomenclatore regionale flagerog Il flag assume diversi valori, ed è riferito a ciò che è stato inserito nel campo codprodpresterog. V = il codice prestazione inserito nel campo è stato Elemento facoltativo 71

72 Nome Campo Contenuto Caratteristiche variato dall erogatore specialistico rispetto a quanto prescritto dal medico, con un altra prestazione appartenente alla stessa branca motivazsostprod Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo targa Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo DichTargaDoppia Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codbranca Codice della branca specialistica della prestazione, come Elemento obbligatorio da nomenclatore regionale. tipoerogazionefarm Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo Prezzo Tariffa della prestazione specialistica Elemento obbligatorio ticketconfezione Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) diffgenerico Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) quantitaerogata Quantità effettivamente erogata. (Attenzione: per le Elemento obbligatorio prestazioni cicliche, inserite dal medico come numero di cicli da n sedute, è indicato l effettivo numero di sedute erogate) datainierog Data di inizio erogazione (sia di prestazioni cicliche che Elemento obbligatorio non cicliche). datafineerog Data di fine erogazione (sia di prestazioni cicliche che Elemento obbligatorio non cicliche). prezzorimborso Prezzo rimborso al laboratorio Elemento obbligatorio onereprod Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) scontossn Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) extrascontoindustria Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) extrascontopayback Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) extrascontodl Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento obbligatorio (impostare 0) codpresidio Presidio di erogazione della prestazione Elemento facoltativo codreparto Codice del reparto di erogazione della prestazione Elemento facoltativo dispfust1 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispfust2 Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo dispfust3 Il campo di futuro utilizzo da parte del SAR. Elemento facoltativo dispfust4 Il campo di futuro utilizzo da parte del SAR. Elemento facoltativo dispfust5 Il campo di futuro utilizzo da parte del SAR. Elemento facoltativo codcatalogoprescr Il campo è di output per l erogatore ed è impostato dal Elemento facoltativo medico prescrittore unicamente per prescrizioni specialistiche; contiene il codice del catalogo regionale della prestazione prescritta. tipoaccesso Il campo, da utilizzarsi unicamente per prescrizioni Elemento facoltativo specialistiche del PNGLA, indica se la prestazione richiesta si riferisce: 72

73 Nome Campo Contenuto Caratteristiche codcatalogoerog garanziatempimax dataprenotazione ad un primo accesso (prima visita o primo esame di diagnostica strumentale, visita o prestazione di approfondimento erogati da specialista diverso dal primo osservatore e nel caso di un paziente cronico, si considera primo accesso, la visita o l esame strumentale, necessari in seguito ad un peggioramento del quadro clinico), ad un accesso successivo (visita o prestazione di approfondimento, per pazienti presi in carico dal primo specialista,, controllo, follow up). Valori ammessi: 1= primo accesso, 0= altra tipologia di accesso Il campo contiene il codice del catalogo regionale della prestazione erogata. Il campo, presente unicamente per prescrizioni specialistiche, è valorizzato con: 1 = utente a cui devono essere garantiti i tempi massimi di attesa; 0= utente che non rientra nella categoria precedente; Il campo, presente unicamente per prescrizioni specialistiche, è valorizzato con la data nel formato aaaammgg. Come da definizione del PNGLA la data è riferita all assegnazione di una disponibilità di prestazione susseguente ad una specifica richiesta. Elemento facoltativo Elemento facoltativo; obbligatorio per le prestazioni del PNGLA Elemento facoltativo; obbligatorio per le prestazioni del PNGLA Ripetizione di ErroreRicetta codesito Codice esito Per i valori si faccia riferimento al documento specifico. Esito Descrizione esito Per i valori si faccia riferimento al documento specifico. progrpresc Progressivo prescrizione. Valori: 0= il codice esito vale per tutta la ricetta >0= indica la prescrizione a cui si fa riferimento, secondo l ordine in cui era stata inviata il campo indica il progressivo di ogni singola prescrizione/prestazione specialistica presente in una ricetta dematerializzata, secondo l ordine con cui ognuna è stata scritta nella richiesta SOAP inviata in fase di chiusura erogazione. Per le prestazioni specialistiche invece il progressivo viene impostato per ogni prestazione prescritta, indipendentemente dalla quantità. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto Ripetizione di Comunicazione codice Codice dell eventuale messaggio di servizio messaggio Testo dell eventuale messaggio di servizio 73

74 5.12 Ricerca Erogazione delle ricette in differita Descrizione Servizio Con tale tipo di interrogazioni si ottengono delle liste (da 1 a n elementi) di ricette trasmesse in differita. Le interrogazioni possibili sono le seguenti: per un determinato numero segnalazione anomalia valorizzare: numsegnalazioneanomalia per NRE valorizzare con le seguenti possibilità: o o o o o o nre; nre + idricetta; nre + cfassistito; nre + idricetta + cfassistito; idricetta; idricetta + cfassistito; per periodo temporale valorizzare con le seguenti possibilità: o Accesso al servizio dataperiododal + dataperiodoal + tipodata L indirizzo per raggiungere il servizio in ambiente di test: Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di ricerca delle ricette erogate in differita RicercaErogatoDiffRichiesta. Nome Campo Contenuto Caratteristiche pincode Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codiceregioneerogatore Codice della regione della struttura erogatrice. Elemento obbligatorio codiceaslerogatore Codice della ASL della struttura erogatrice. Elemento obbligatorio codicessaerogatore Codice identificativo della struttura erogatrice. Codici Elemento obbligatorio delle strutture erogatrici saranno verificati al momento di attivazione e comunicati dal SAR. Pwd Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo numsegnalazioneanomalia Numero segnalazione anomalia Elemento facoltativo idricetta Numero univoco che viene assegnato dal SAR ad ogni Elemento facoltativo ricetta trasmessa in differita: potendo essere trasmesse anche più di una ricetta in differita con uguale NRE sia da parte dello stesso erogatore che da erogatori diversi (si ricorda che l erogazione è avvenuta in assenza di 74

75 Nome Campo Contenuto Caratteristiche accesso al dato elettronico e quindi non è stato possibile il controllo di univocità dell NRE), il sistema assegna sempre un numero univoco a ciascuna ricetta in differita, che deve essere utilizzato per le interrogazioni puntuali. I sistemi gestonali devono quindi tenere traccia di tale numero assegnato in fase di registrazione ricetta in differita. Nre Numero Ricetta Elettronico Elemento facoltativo cfassistito Codice fiscale dell assistito. Se l assistito è provvisto di Elemento facoltativo 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 SismedCF.cer. dataperiododal Data dalla quale fare partire la ricerca delle ricette in Elemento facoltativo differita. Costituisce una delle possibili opzioni di ricerca: l inserimento di tale parametro deve essere combinato con dataperiodoal e tipodata e restituisce la lista degli NRE, ognuno associato al proprio idricetta, delle ricette trasmesse in difefrita nel periodo. Formato: aaaa-mm-gg dataperiodoal Data fino alla quale fare terminare la ricerca delle ricette Elemento facoltativo in differita. Costituisce una delle possibili opzioni di ricerca: l inserimento di tale parametro deve essere combinato con dataperiododal e tipodata e restituisce la lista degli NRE del periodo associati al proprio idricetta. Formato: aaaa-mm-gg tipodata Indica se le le date indicate in dataperiododal e Elemento facoltativo dataperiodoal sono riferite alla data di trasmissione della ricetta in differita (valore: T) oppure alla data di erogazione della ricetta (valore: E) disp1 Campo a disposizione per futuro utilizzo Elemento facoltativo disp2 Campo a disposizione per futuro utilizzo Elemento facoltativo disp3 Campo a disposizione per futuro utilizzo Elemento facoltativo Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo RicercaErogatoDiffRicevuta, contenente l'esito della trasmissione. Formato dell'elemento RicercaErogatoDiffRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note 75

76 Nome Campo Contenuto Note totalericette Numero delle ricette che derivano dalla interrogazione effettuata Ripetizione di DettaglioSinteticoRicettaDiff idricetta Numero univoco che viene assegnato dal SAR ad ogni ricetta trasmessa in differita. nre NRE in caso di inserimento andato a buon fine, sia nel caso in cui la ricetta già lo contenga sia nel caso in cui venga trasmesso dal SAR. dataerogazione Data di erogazione della ricetta datatrasmissione Data di trasmissione al SAC della ricetta differita numsegnalazioneanomalia Numero segnalazione guasto associato alla ricetta codesitoricercaerogatodiff Codice esito dell operazione di visualizzazione: 0000 = visualizzazione andata a buon fine senza presenza di segnalazioni = visualizzazione andata a buon fine ma con presenza di segnalazioni = visualizzazione non avvenuta. Ripetizione di ErroreRicetta codesito Codice esito Per i valori si faccia riferimento al documento specifico. Esito Descrizione esito Per i valori si faccia riferimento al documento specifico. progrpresc Progressivo prescrizione. Valori: 0= il codice esito vale per tutta la ricetta >0= indica la prescrizione a cui si fa riferimento, secondo l ordine in cui era stata inviata il campo indica il progressivo di ogni singola prescrizione/prestazione specialistica presente in una ricetta dematerializzata, secondo l ordine con cui ognuna è stata scritta nella richiesta SOAP inviata in fase di chiusura erogazione. Per le prestazioni specialistiche invece il progressivo viene impostato per ogni prestazione prescritta, indipendentemente dalla quantità. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto Ripetizione di Comunicazione codice Codice dell eventuale messaggio di servizio messaggio Testo dell eventuale messaggio di servizio 76

77 5.13 Comunicazione Annullamento Erogazione delle ricette in differita Descrizione Servizio Le ricette inviate in differita possono essere annullate se l erogatore si accorge di avere commesso un qualsiasi errore, sia nei singoli dati di una ricetta che nell invio della ricetta stessa nel suo complesso. All annullamento può seguire una nuova trasmissione in differita dei dati di chiusura erogazione, seguendo le istruzioni dell apposito capitolo, oppure nessun altra operazione Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di annullamento delle ricette erogate in differita AnnullaErogatoDiffRichiesta. Nome Campo Contenuto Caratteristiche pincode Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo codiceregioneerogatore Codice della regione della struttura erogatrice. Elemento obbligatorio codiceaslerogatore Codice della ASL della struttura erogatrice. Elemento obbligatorio codicessaerogatore Codice identificativo della struttura erogatrice. Codici Elemento obbligatorio delle strutture erogatrici saranno verificati al momento di attivazione e comunicati dal SAR. Pwd Il campo non è utilizzato ai fini di utilizzo dei servizi SAR. Elemento facoltativo idricetta Numero univoco che viene assegnato dal SAR ad ogni Elemento facoltativo ricetta trasmessa in differita: potendo essere trasmesse anche più di una ricetta in differita con uguale NRE sia da parte dello stesso erogatore che da erogatori diversi (si ricorda che l erogazione è avvenuta in assenza di accesso al dato elettronico e quindi non è stato possibile il controllo di univocità dell NRE), il sistema assegna sempre un numero univoco a ciascuna ricetta in differita, che deve essere utilizzato per le interrogazioni puntuali. I sistemi gestonali devono quindi tenere traccia di tale numero assegnato in fase di registrazione ricetta in differita. Nre Numero Ricetta Elettronico Elemento facoltativo 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 Elemento facoltativo 77

78 Nome Campo Contenuto Caratteristiche 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 SismedCF.cer. codannullamentodiff Motivazione dell annullamento. Elemento obbligatorio Valore ammesso: 1 (annullamento di tutta la ricetta in differita) disp1 Campo a disposizione per futuro utilizzo Elemento facoltativo disp2 Campo a disposizione per futuro utilizzo Elemento facoltativo disp3 Campo a disposizione per futuro utilizzo Elemento facoltativo Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo AnnullaErogatoDiffRicevuta, contenente l'esito della trasmissione. Formato dell'elemento AnnullaErogatoDiffRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note idricetta nre dataricezione codautenticazione codesitoannullamento Ripetizione di ErroreRicetta Numero univoco che viene assegnato dal SAR ad ogni ricetta trasmessa in differita: potendo essere trasmesse anche più di una ricetta in differita con uguale NRE sia da parte dello stesso erogatore che da erogatori diversi (si ricorda che l erogazione è avvenuta in assenza di accesso al dato elettronico e quindi non è stato possibile il controllo di univocità dell NRE), il sistema assegna sempre un numero univoco a ciascuna ricetta in differita, che deve essere utilizzato per le interrogazioni puntuali. I sistemi gestonali devono quindi tenere traccia di tale numero assegnato in fase di registrazione ricetta in differita. NRE in caso di inserimento andato a buon fine, sia nel caso in cui la ricetta già lo contenga sia nel caso in cui venga trasmesso dal SAR. data di ricezione Codice di autenticazione dell avvenuta transazione Codice esito dell operazione di visualizzazione: 0000 = visualizzazione andata a buon fine senza presenza di segnalazioni = visualizzazione andata a buon fine ma con presenza di segnalazioni = visualizzazione non avvenuta. 78

79 Nome Campo Contenuto Note codesito Codice esito Per i valori si faccia riferimento al documento specifico. Esito Descrizione esito Per i valori si faccia riferimento al documento specifico. progrpresc Progressivo prescrizione. Valori: 0= il codice esito vale per tutta la ricetta >0= indica la prescrizione a cui si fa riferimento, secondo l ordine in cui era stata inviata il campo indica il progressivo di ogni singola prescrizione/prestazione specialistica presente in una ricetta dematerializzata, secondo l ordine con cui ognuna è stata scritta nella richiesta SOAP inviata in fase di chiusura erogazione. Per le prestazioni specialistiche invece il progressivo viene impostato per ogni prestazione prescritta, indipendentemente dalla quantità. tipoerrore Indica la gravità dell errore BLOCCANTE=errore scartante, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto Ripetizione di Comunicazione codice Codice dell eventuale messaggio di servizio messaggio Testo dell eventuale messaggio di servizio 5.14 Richiesta Errori Comunicazione Erogazione delle ricette in differita Descrizione Servizio Con tale tipo di interrogazioni si ottengono delle liste (da 1 a n elementi) degli errori e warning che sono stati rilevati per le ricette trasmesse da Sistema Erogatore in differita.. Le interrogazioni possibili sono le seguenti: per un determinato numero segnalazione anomalia valorizzare: numsegnalazioneanomalia per NRE valorizzare con le seguenti possibilità: o nre; o nre + idricetta; o idricetta; Accesso al servizio L indirizzo per raggiungere il servizio in ambiente di test: Sarà comunicato in seguito l indirizzo per raggiungere i servizi esposti in ambiente di produzione. 79

80 Descrizione messaggio di input Descrizione degli elementi costitutivi del messaggio di ricerca degli errori delle ricette erogate in differita VisualizzaErroriErogatoDiffRichiesta. Nome Campo Contenuto Caratteristiche codiceregioneerogatore Codice della regione della struttura erogatrice. Elemento obbligatorio codiceaslerogatore Codice della ASL della struttura erogatrice. Elemento obbligatorio codicessaerogatore Codice identificativo della struttura erogatrice. Codici Elemento obbligatorio delle strutture erogatrici saranno verificati al momento di attivazione e comunicati dal SAR. numsegnalazioneanomalia Numero segnalazione anomalia Elemento facoltativo idricetta Numero univoco che viene assegnato dal SAR ad ogni Elemento facoltativo ricetta trasmessa in differita: potendo essere trasmesse anche più di una ricetta in differita con uguale NRE sia da parte dello stesso erogatore che da erogatori diversi (si ricorda che l erogazione è avvenuta in assenza di accesso al dato elettronico e quindi non è stato possibile il controllo di univocità dell NRE), il sistema assegna sempre un numero univoco a ciascuna ricetta in differita, che deve essere utilizzato per le interrogazioni puntuali. I sistemi gestionali devono quindi tenere traccia di tale numero assegnato in fase di registrazione ricetta in differita. Nre Numero Ricetta Elettronico Elemento facoltativo disp1 Campo a disposizione per futuro utilizzo Elemento facoltativo disp2 Campo a disposizione per futuro utilizzo Elemento facoltativo disp3 Campo a disposizione per futuro utilizzo Elemento facoltativo Descrizione messaggio di output Per ogni richiesta, il sistema risponde con un messaggio di tipo VisualizzaErroriErogatoDiffRicevuta, contenente l'esito della trasmissione. Formato dell'elemento VisualizzaErroriErogatoDiffRicevuta in caso di corretta ricezione: Nome Campo Contenuto Note codesitoricercaerrorierogatodiff Ripetizione di ErroreRicettaDiff idricetta Codice esito dell operazione di visualizzazione: 0000 = visualizzazione andata a buon fine senza presenza di segnalazioni = visualizzazione andata a buon fine ma con presenza di segnalazioni = visualizzazione non avvenuta. Numero univoco che viene assegnato dal SAR ad ogni ricetta trasmessa in 80

81 Nome Campo Contenuto Note differita. nre NRE in caso di inserimento andato a buon fine, sia nel caso in cui la ricetta già lo contenga sia nel caso in cui venga trasmesso dal SAR. dataelaborazione Data di elaborazione della ricetta da parte del SAR numsegnalazioneanomalia Numero segnalazione guasto associato alla ricetta Operazione Tipo operazione di trasmissione: EROGAZIONE ANNULLAMENTO 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, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto Ripetizione di ErroreRicetta 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, che non fa inserire la ricetta negli archivi del SAC AVVISO=warning, ossia avviso di dato non corretto, ma che non causa scarto 81

82 6 Ambiente di test e servizi 6.1 URL Servizi L URL di accesso ai servizi in ambiente di test è generalizzato a: Se l accesso è eseguito dal browser a questo indirizzo viene proposto elenco dei servizi disponibili: I nomi dei singoli servizi sono presenti nella tabella successiva: Servizio Visualizzazione Erogato (visualizzazione e presa in carico della ricetta) Invio Erogato (comunicazione erogazione della ricetta) Annullamento Erogato (comunicazione annullamento erogazione della ricetta) Comunicazione in differita (invio segnalazione Web Services Collaudo