{"id":611,"date":"2022-01-26T11:57:26","date_gmt":"2022-01-26T10:57:26","guid":{"rendered":"https:\/\/compliance.toscana.it\/wordpress\/?post_type=scenario&p=611"},"modified":"2023-11-21T15:58:52","modified_gmt":"2023-11-21T14:58:52","slug":"scenario-eprescription-hl7-ricetta-dematerializzata","status":"publish","type":"scenario","link":"https:\/\/compliance.toscana.it\/wordpress\/it\/scenari\/scenario-eprescription-hl7-ricetta-dematerializzata\/","title":{"rendered":"Scenario ePrescription Ricetta Dematerializzata (HL7)"},"content":{"rendered":"\n
In Evidenza: introdotti nello scenario i profili per la gestione della Ricetta Bianca elettronica e Trasporti Sanitari<\/strong><\/p>\n\n\n\n N.B. per le indicazioni sull’attivazione degli ambienti e servizi CART consultare il paragrafo “ATTIVAZIONE AMBIENTI STAGE E PRODUZIONE” e seguenti (vedi sotto)<\/strong><\/em><\/p>\n\n\n\n <\/p>\n\n\n\n Il presente scenario rappresenta la definizione della messaggistica informatizzata atta alla gestione dell’intero ciclo prescrittivo riferito alla prescrizione e all’annullamento prescrizione.<\/p>\n\n\n\n il DM 2 novembre 2011, il Ministero dell\u2019Economia e delle Finanze, in adempimento a quanto previsto dall\u2019articolo 50, comma 5 bis, del D.L. 269\/2003, introdotto dalla L.296\/2006 e dall\u2019art. 11 comma 16 del D.L. 78\/2010, ha dato avvio al processo di dematerializzazione della ricetta medica cartacea ed a tutto il suo ciclo di vita.<\/p>\n\n\n\n In attuazione di tali normative, Regione Toscana ha predisposto tutta l\u2019infrastruttura tecnica, atta a consentire al medico prescrittore l\u2019invio della prescrizione elettronica al MEF, agendo direttamente sulla connettivit\u00e0 e gli add-on software del prescrittore, sulla infrastruttura centrale e sugli standard regionali.<\/p>\n\n\n\n Il sistema di seguito illustrato rappresenta lo strumento regionale attraverso il quale i medici MMG, PLS ed i medici degli ESTAV, eseguono l’invio, delle prescrizioni ed annullamento prescrizioni in formato elettronico secondo le specifiche HL7 CDA R2, verso i sistemi telematici di Regione Toscana e, di conseguenza, del MEF.<\/p>\n\n\n\n Da un punto di vista organizzativo, la gestione centralizzata a livello regionale, utile a fornire uno strumento unico (il SAR) delegato all’archiviazione dati sulle banche dati regionali e ad interagire con i servizi ministeriali (il SAC), porta a notevoli vantaggi, tra cui:<\/p>\n\n\n\n Il processo di prescrizione-erogazione prevede la gestione delle seguenti tipologie di prescrizioni :<\/p>\n\n\n\n Per l’identificazione del paziente, ovvero per avere garanzia della sua identit\u00e0 attraverso i tratti anagrafici ed il codice fiscale, e per il recupero dell’id universale regionale, \u00e8 necessario utilizzare l’API AnagrafeUnicaRegionale_Accesso v1 (ex RFC249). <\/p>\n\n\n\n Per il recupero delle esenzioni e delle fasce di reddito (quando in vigore secondo normativa) \u00e8 invece necessario utilizzare l’API FasceDiReddito v1 (ex RFC 198).<\/p>\n\n\n\n Gli attori coinvolti negli scenari di cooperazione sono:<\/p>\n\n\n\n Medico Prescrittore<\/strong>: medico di medicina generale \/ Pediatra di Libera scelta, medico specialista od ospedaliero convenzionato con il SSN abilitato alla prescrizione tramite ricettario SSN\/SASN.<\/p>\n\n\n\n [L\u2019attore Medico Prescrittore <\/strong>implementa il ruolo (Application Role) Document Originator RCMR_AR000001]<\/p>\n\n\n\n [L\u2019attore Regione Toscana<\/strong> implementa l\u2019attore (Application Role) Document Recipient RCMR_AR000004 e provvede ad inoltrare i dati ricevuti a SAC (SOGEI) secondo le scadenze definite dalla normativa.]<\/p>\n\n\n\n Operazione – inoltro prescrizione<\/strong><\/p>\n\n\n\n Operazione – inoltro annullamento prescrizione<\/strong><\/strong><\/p>\n\n\n\n Operazione – inoltro prescrizione Ricetta Bianca<\/strong><\/strong><\/p>\n\n\n\n Operazione – inoltro annullamento<\/strong><\/strong> prescrizione Ricetta Bianca<\/strong><\/strong><\/p>\n\n\n\n Le operazioni sono descritte formalmente all’interno del documento WSDL (ePrescription.wsdl) <\/p>\n\n\n\n N.B. – la descrizione delle interfacce applicative usate per l\u2019invio delle prescrizioni \u00e8 contenuta nel documento WSDL RFC123_AR000005UV02.wsdl) allegato alla API StorageGeograficoEventiSanitari v1.<\/strong><\/p>\n\n\n\n Per eseguire le operazioni previste il client del medico esegue l’accesso al sistema SAR ePrescriptionDM2011 al fine di inviare una prescrizione elettronica. Il sistema SAR, una volta archiviate le informazioni nelle banche dati regionali del SAR, provvede a gestire in modo asincrono rispetto alla ricezione delle prescrizioni da parte dei medici, l’interazione verso, provvede all’inoltro verso i sistemi ministeriali di accoglienza centrale (SAC).<\/p>\n\n\n\n “Richiesta di inoltro ePrescription verso il sistema SAR, UC161.1”<\/strong><\/p>\n\n\n\n L’attore principale produce un messaggio,\u201cRCMR_IN000002UV02_Message<\/em>\u201d, contenente le informazioni previste e dettagliate nel documento di guida all’implementazione della prescrizione elettronica. (vd. allegati API)<\/p>\n\n\n\n Attraverso l’operazione \u201cGestioneInvioPrescrizione<\/em>\u201d il messaggio giunge al sistema regionale il quale una volta ricevuto l’evento, traccia su base dati la richiesta giunta completa di tutte le sue informazioni inoltre applica al messaggio i controlli formali e di congruenza previsti per il tipo di messaggio.<\/p>\n\n\n\n In caso di esito positivo di tali controlli, il sistema procede con alla costruzione del messaggio di risposta da restituire al chiamante (MCCI_IN000002UV01_Message<\/em>) contenente l’esito dell’elaborazione da parte del SAR<\/p>\n\n\n\n Successivamente (ed in modo asincrono rispetto alla ricezione del messaggio da parte dei medici) il sistema SAR effettua l’interazione verso i servizi del SAC per comunicare loro le prescrizioni presenti sul SAR e non ancora inviate verso il sistema di accoglienza centrale.<\/p>\n\n\n\n In caso di esito negativo dei controlli (messaggio di richiesta non conforme allo schema o attribuzione di valori formalmente non corretti) il servizio risponde al chiamante sempre con un messaggio MCCI_IN000002UV01_Message <\/em>contenente un codice ed una descrizione dell’errore prodotta dal sistema di accoglienza regionale.<\/p>\n\n\n\n <\/p>\n\n\n\n Il formato di ciascun messaggio \u00e8 definito dagli xsd allegati: <\/strong>Schema\/<\/strong>CDA_ePrescription.xsd, xsd schema che definisce la grammatica del CDA R2 di HL7;<\/p>\n\n\n\n Si tenga presente che se si sta inviando un evento di prescrizione verso il sistema ePrescriptionDPCM2008 (utilizzando il webservice opportuno, esposto ad un endpoint diverso rispetto a quello relativo al DM2011) il \u201cClinicalDocument<\/em>\u201d del CDA R2 di HL7 va codificato in base64 , e la rappresentazione in base64 del CDA dovr\u00e0 essere usata per valorizzare l’elemento seguente del messaggio RCMR_IN000002UV02:<\/p>\n\n\n\n \/RCMR_IN000002UV02\/controlActProcess\/subject\/clinicalDocument\/text<\/p>\n\n\n\n mentre se si sta inviando un evento di prescrizione verso il sistema ePrescriptionDM2011 (utilizzando il webservice opportuno, esposto ad un endpoint diverso rispetto a quello relativo al DM2008) , la rappresentazione XML del \u201cClinicalDocument<\/em>\u201d del CDA R2 di HL7 dovr\u00e0 essere utilizzata per valorizzare il seguente elemento messaggio RCMR_IN000002UV02:<\/p>\n\n\n\n \/RCMR_IN000002UV02\/controlActProcess\/subject\/clinicalDocument\/text\/xmlbody<\/p>\n\n\n\n Per tutti i restanti messaggi utilizzati nello scenario di ePrescription fare riferimento agli xsd allegati alla API StorageGeograficoEventiSanitari v1<\/strong><\/p>\n\n\n\n <\/p>\n\n\n\n Per dettagli circa la descrizione dei messaggi usati per l’annullamento della prescrizione si faccia riferimento all’interazione n\u00b09 \u201cNotifica di annullamento dell’indicizzazione di un evento\u201d definita nella API StorageGeograficoEventiSanitari v1<\/strong>.<\/p>\n\n\n\n E’ importante notare che la API StorageGeograficoEventiSanitari v1<\/strong>. contiene due interazioni di annullamento :<\/p>\n\n\n\n Tale interazione prevede l’utilizzo di un messaggio la cui struttura e’ definita nello schema RCMR_IN000023UV02.xsd, con le specificit\u00e0 elencate nella tabella seguente. Nella tabella gli xpath degli elementi da valorizzati sono relativi a \u201cRCMR_IN000023UV02\/controlActProcess\/subject\u201d.<\/p>\n\n\n\n Il messaggio, a differenza dell’interazione di invio, non contiene il documento CDA che rappresenta la prescrizione da annullare.<\/p>\n\n\n\n L’elemento univoco che identifica la prescrizione da annullare \u00e8 l’attributo \/ClinicalDocument\/relatedDocument\/ParentDocument\/id@extension<\/em> che contiene l’NRE ( in caso di Ricetta Bianca l\u2019NRBE) della prescrizione annullata.<\/strong><\/p>\n\n\n\n In caso di annullamento per idClinicalDocument non sar\u00e0 presente l\u2019NRE o NRBE come indicato sopra, ma l\u2019Id \u00e8 riportato nell\u2019attributo ClinicalDocument\/id@extension<\/em> come indicato nella tabella seguente.<\/p>\n\n\n\n __________<\/strong><\/p>\n\n\n\n <\/p>\n\n\n\n Gli applicativi fruitori si autenticano attraverso l\u2019uso di credenziali TLS, fornite direttamente dal client tramite protocollo HTTPS (MTLS).<\/p>\n\n\n\n L\u2019accesso, mediante protocollo HTTPS, prevede che sussista una relazione di trust tra applicativo fruitore ed API Gateway del CART, che viene preventivamente stabilito in fase di richiesta di adesione al servizio tramite lo scambio dei certificati. Il CART \u00e8 cos\u00ec in grado di identificare puntualmente l\u2019applicativo ed applicare i criteri di autorizzazione previsti per l\u2019accesso alle API sulla base dell\u2019identit\u00e0 del client fruitore.<\/p>\n\n\n\n Per poter essere abilitati all’uso dei servizi, oggetto del presente documento, \u00e8 necessario avere fatto esplicita richiesta a Regione Toscana. In particolare \u00e8 necessario eseguire i seguenti passi:<\/p>\n\n\n\n Modalit\u00e0 di invio<\/strong><\/p>\n\n\n\n Richiesta di Adesione a CART in ambiente stage e produzione<\/strong><\/p>\n\n\n\n Per l\u2019apertura del canale HTTPS, dipendentemente dal tipo di software, devono essere usate le modalit\u00e0 previste dal CART: va richiesto a (cartdesk@regione.toscana.it<\/strong>)<\/p>\n\n\n\n Richiedere le URL di erogazione dei servizi (specificando l’ambiente stage o produzione<\/strong>) inviando il modulo compilato a: cartdesk@regione.toscana.it<\/strong><\/p>\n\n\n\n e per conoscenza a;<\/strong><\/p>\n\n\n\n omar.lorenzini@regione.toscana.it e grupposis@regione.toscana.it<\/strong><\/p>\n\n\n\n I Gateway del CART, per ogni richiesta gestita introducono alcuni header http, in particolare l\u2019header X-CART-id<\/strong> viene valorizzato con un identificativo unico di transazione generato dal CART che pu\u00f2 essere salvato per eventuali verifiche diagnostiche.<\/p>\n\n\n\n Ad ogni invio l\u2019infrastruttura CART restituisce al chiamate l’identificativo della chiamata\/transazione. Tale identificativo \u00e8 restituito nella variabile X-Cart-id <\/strong>posta nell’header HTTP.<\/p>\n\n\n\n Il valore della variabile X-Cart-id<\/strong> deve essere sempre salvato e custodito perch\u00e9 permettere di certificare l’avvenuta comunicazione del messaggio garantendone la tracciabilit\u00e0 all’interno dell’intero sistema. E’ importante osservare che tale identificativo viene sempre restituito dall’infrastruttura sia in caso di accettazione o meno del messaggio.<\/strong><\/p>\n\n\n\n Un esempio di valore della variabile X-Cart-id \u00e8 il seguente b7cad8e2-72c4-41ce-ac9a-24ff2b3f72a0.<\/strong><\/p>\n\n\n\n <\/p>\n\n\n\n Nell\u2019ambito del riordino dell\u2019organizzazione del sistema sanitario relativamente al trasporto sanitario, la Regione Toscana ha ritenuto opportuno procedere con la definizione delle competenze organizzative e l\u2019attribuzione degli oneri del servizio di trasporto sanitario rendendo omogenee, a livello regionale, le modalit\u00e0 operative. A tal fine viene introdotta la prescrizione dematerializzata della ricetta dei trasporti sanitari, definita tramite messaggistica informatizzata atta alla gestione dell\u2019intero ciclo prescrittivo. La tipologia di ricetta Trasporti si configura come prescrizione regionale, al momento, senza interazioni con il SAC.<\/p>\n\n\n\n Request_RCMR_IN000002UV02_ricetta-trasporto<\/p>\n\n\n\n le tabelle delle codifiche ammissibili relative al codesystem HL7 <\/p>\n\n\n\n 2.16.840.1.113883.2.9.2.90.4.99.07 Codice provvisorio per le condizioni cliniche nella ricetta Trasporti<\/p>\n\n\n\n 2.16.840.1.113883.2.9.2.90.4.99.08 Codice provvisorio utilizzato per identificare il motivo\/Causa del trasporto<\/p>\n\n\n\n 2.16.840.1.113883.2.9.2.90.4.99.09 Codice provvisorio utilizzato per identificare al tipologia di indirizzo di una destinazione di in una ricetta Trasporti<\/p>\n\n\n\n sono reperibili tramite il repository RCT regionale e le procedure pubblicate sul portale Open Data<\/a> di Regione Toscana. <\/p>\n\n\n\n Prescrizione Trasporti \u2013 Condizioni Cliniche<\/a><\/p>\n\n\n\nAttori<\/h2>\n\n\n\n
Nome servizio WSDL<\/strong><\/td> GestionePrescription_Service<\/td><\/tr> Nome operazione WSDL<\/strong><\/td> GestioneInvioPrescrizione<\/td><\/tr> Nome messaggio di richiesta<\/strong><\/td> RCMR_IN000002UV02_Message (RFC 123)<\/td><\/tr> Nome messaggio di risposta<\/strong><\/td> MCCI_IN000002UV01_Message (ack?)<\/td><\/tr> Profilo di collaborazione<\/strong><\/td> Richiesta\/Risposta Sincrono<\/td><\/tr><\/tbody><\/table> Nome servizio WSDL<\/strong><\/td> GestionePrescription_Service<\/td><\/tr> Nome operazione WSDL<\/strong><\/td> GestioneAnnullamentoPrescrizione<\/td><\/tr> Nome messaggio di richiesta<\/strong><\/td> RCMR_IN000023UV02_Message<\/td><\/tr> Nome messaggio di risposta<\/strong><\/td> MCCI_IN000002UV01_Message<\/td><\/tr> Profilo di collaborazione<\/strong><\/td> Richiesta\/Risposta Sincrono<\/td><\/tr><\/tbody><\/table> Nome servizio WSDL<\/strong><\/td> GestionePrescription_Service<\/td><\/tr> Nome operazione WSDL<\/strong><\/td> GestioneInvioPrescrizioneRicettaBianca<\/td><\/tr> Nome messaggio di richiesta<\/strong><\/td> RCMR_IN000002UV02_Message<\/td><\/tr> Nome messaggio di risposta<\/strong><\/td> MCCI_IN000002UV01_Message<\/td><\/tr> Profilo di collaborazione<\/strong><\/td> Richiesta\/Risposta Sincrono<\/td><\/tr><\/tbody><\/table> Nome servizio WSDL<\/strong><\/td> GestionePrescription_Service<\/td><\/tr> Nome operazione WSDL<\/strong><\/td> GestioneAnnullamentoPrescrizioneRicettaBianca<\/td><\/tr> Nome messaggio di richiesta<\/strong><\/td> RCMR_IN000023UV02_Message<\/td><\/tr> Nome messaggio di risposta<\/strong><\/td> MCCI_IN000002UV01_Message<\/td><\/tr> Profilo di collaborazione<\/strong><\/td> Richiesta\/Risposta Sincrono<\/td><\/tr><\/tbody><\/table> Utilizzo della API<\/h2>\n\n\n\n
Utilizzo dei Messaggi<\/h2>\n\n\n\n
ATTIVAZIONE AMBIENTI STAGE E PRODUZIONE<\/h2>\n\n\n\n
API A CUI SI RICHIEDE L\u2019ADESIONE<\/td> Nome API<\/td><\/tr> SOGGETTO EROGATORE:<\/td> Regione Toscana<\/td><\/tr> REFERENTE TECNICO APPLICATIVO (*)<\/td> Omar Lorenzini<\/td><\/tr> EMAIL<\/td> grupposis@regione.toscana.it<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Tracciatura delle comunicazioni<\/h1>\n\n\n\n
Prescrizione Elettronica -Profilo Gestione Ricetta Trasporti<\/h2>\n\n\n\n