Specifiche Integrazione SAR prescrizione elettronica

Transcript

Specifiche Integrazione SAR prescrizione elettronica
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Specifiche per l’integrazione delle
Aziende Regionali con i sistemi del
Sistema di Accoglienza Regionale
(SAR) della Regione Lazio
29/02/2016
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
1
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Status del Documento
Rev.
Data
Descrizione Modifica
Specifiche per l’integrazione delle Aziende Regionali con i sistemi del Sistema di
1
03/08/2012
Accoglienza Regionale (SAR) della Regione Lazio
2
08/10/2012
Aggiornamento servizio Richiesta Lotto NRE al SAR
Aggiornato il capitolo 4.1.6 della schema della ricetta con le disposizioni del MEF
relativi al Gruppo di Equivalenza per la prescrizione dei farmaci.
3
06/03/2013
Aggiunto il capitolo 6 con la descrizione degli errori che restituisce il SAR dopo
elaborazione delle ricetta inviati.
Aggiunto allegato con gli errori codificati dal SAC.
Aggiornato il capitolo 4.1.6 la tabelle di dettaglio della ricetta. La lunghezza del
campo CodEsenzione è di 10 caratteri.
Aggiornata la tabella AssistitoDTO del capitolo 4.5.2.2. Sostituita la descrizione
per i campi di ProvinciaNascita e ProvinciaResidenza. Nel tracciato viene gestita
5
18/07/2013
Sigla della provincia e non più la Descrizione.
Aggiunta una ulteriore spiegazione nel capitolo 4.5
Composizione Lotto NRE
Aggiunto il capitolo 4.1.7 relativo alla descrizione dei valori per le Disposizioni
Regionali
Modificato il capitolo 3.5. Aggiunta informazione per la gestione della password
invalida e scaduta
6
06/03/2014
Modificato il capitolo
4.1.7. Modificato obbligo di opposizione dei codici per
farmaci “Prazoli”, “Statine” e “Sartani”.
Aggiunto nel paragrafo 3.2 riferimento a UTF-8.
7
29/02/2016
Aggiunta del paragrafo 3.6 con indicazione del Contesto Lavorativo del Medico
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
2
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
INDICE
INDICE ...................................................................................................................................................................... 3
1
INTRODUZIONE ............................................................................................................................................. 5
1.1
GLOSSARIO .......................................................................................................................................................... 5
2
IL CONTESTO NORMATIVO ........................................................................................................................ 7
3
DESCRIZIONE GENERALE DEL SISTEMA ............................................................................................... 8
3.1
3.2
3.3
3.4
3.5
3.6
4
ARCHITETTURA DEL SISTEMA .............................................................................................................................. 8
DESCRIZIONE GENERALE DEI SERVIZI D’INTEGRAZIONE...................................................................................... 9
AUTENTICAZIONE PER L’ACCESSO AI SERVIZI .................................................................................................... 11
PROCEDURA DI RICHIESTA DEI CREDENZIALI ..................................................................................................... 11
GESTIONE CREDENZIALI SCADUTI O INVALIDI..................................................................................................... 11
INDICAZIONE STRUTTURA/AMBULATORIO DI RIFERIMENTO ............................................................................... 12
SERVIZI DISPONIBILI ..................................................................................................................................15
4.1 TRASMISSIONE DELLE RICETTE AL SAR ............................................................................................................ 15
4.1.1 Accesso al servizio ................................................................................................................................ 15
4.1.2 Certificato di Protezione ........................................................................................................................ 15
4.1.3 Descrizione messaggio di invio ............................................................................................................ 15
4.1.4 Descrizione ricevuta di accoglienza .................................................................................................... 16
4.1.5 Tabella decodifica esito trasmissione ................................................................................................. 16
4.1.6 Schema dati della ricetta ....................................................................................................................... 17
4.1.7 Disposizioni regionali ............................................................................................................................. 25
4.2 RICHIESTA STATO ELABORAZIONE DELLE RICETTE AL SAR ............................................................................ 26
4.2.1 Accesso al servizio ................................................................................................................................ 26
4.2.2 Descrizione messaggio ......................................................................................................................... 26
4.2.2.1
4.2.2.2
Campi di input.................................................................................................................................................26
Campi di output ..............................................................................................................................................27
4.3 RICHIESTA ESITO ELABORAZIONE DELLE RICETTA AL SAR ............................................................................. 27
4.3.1 Accesso al servizio ................................................................................................................................ 27
4.3.2 Descrizione messaggio ......................................................................................................................... 27
4.3.2.1
4.3.2.2
Campi di input.................................................................................................................................................27
Campi di output ..............................................................................................................................................28
4.4 RICHIESTA LOTTO NRE AL SAR ....................................................................................................................... 28
4.4.1 Accesso al servizio ................................................................................................................................ 28
4.4.2 Descrizione messaggio ......................................................................................................................... 29
4.4.2.1
4.4.2.2
Campi di input.................................................................................................................................................29
Campi di output ..............................................................................................................................................29
4.4.3 Composizione NRE ................................................................................................................................ 29
4.5 RICERCA ASSISTITO PER CODICE FISCALE ....................................................................................................... 30
4.5.1 Accesso al servizio ................................................................................................................................ 30
4.5.2 Descrizione messaggio ......................................................................................................................... 30
4.5.2.1
4.5.2.2
Campi di input.................................................................................................................................................30
Campi di output ..............................................................................................................................................31
4.6 INSERIMENTO NUOVO ASSISTITO ....................................................................................................................... 36
4.6.1 Accesso al servizio ................................................................................................................................ 36
4.6.2 Descrizione messaggio ......................................................................................................................... 37
4.6.2.1
4.6.2.2
4.7
Campi di input.................................................................................................................................................37
Campi di output ..............................................................................................................................................37
RICERCA ESENZIONI PER REDDITO DELL’ASSISTITO.......................................................................................... 37
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
3
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
4.7.1
4.7.2
Accesso al servizio ................................................................................................................................ 37
Descrizione messaggio ......................................................................................................................... 37
4.7.2.1
4.7.2.2
Campi di input.................................................................................................................................................37
Campi di output ..............................................................................................................................................38
4.8 RICERCA ESENZIONI PER PATOLOGIA DELL’ASSISTITO ..................................................................................... 38
4.8.1 Accesso al servizio ................................................................................................................................ 38
4.8.2 Descrizione messaggio ......................................................................................................................... 38
4.8.2.1
4.8.2.2
5
AMBIENTE DI TEST E SERVIZI ..................................................................................................................40
5.1
5.2
5.3
6
URL SERVIZI ...................................................................................................................................................... 40
ACCESSO SERVIZI .............................................................................................................................................. 41
DATI DB DI TEST................................................................................................................................................. 41
CODIFICA DEGLI ERRORI ELABORAZIONE RICETTE..........................................................................43
6.1
6.2
7
Campi di input.................................................................................................................................................39
Campi di output ..............................................................................................................................................39
ERRORI SAR ...................................................................................................................................................... 43
ERRORI SAC ...................................................................................................................................................... 46
ELENCO ALLEGATI .....................................................................................................................................47
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
4
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
1 Introduzione
Il presente documento descrive le specifiche tecniche per tutti gli attori interessati (produttori di software di Cartella
Clinica per le Aziende Regionali ) per l’integrazione con il Sistema di Accoglienza Regionale (di seguito SAR) della
Regione Lazio, tramite i servizi predisposti ai fini di trasmettere le ricette registrate dai propri sistemi informatici al SAR.
La Regione Lazio, con nota prot. n. 134162 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.
In questo scenario, il SAR costituisce il contenitore che accoglie tutte le prescrizioni elettroniche, farmaceutiche e
specialistiche, dei medici prescrittori della Regione Lazio. Le prescrizioni elettroniche in oggetto potranno essere così
prodotte:

Software terzi di Cartella Clinica, alle cui case produttrici verranno consegnate le specifiche tecniche per
l’integrazione con il SAR;

Portale di prescrizione elettronica predisposto da LAit nell’ambito della rimodulazione del progetto MeSIR

SISMED Cartella Clinica Web (in seguito abbrev. Cartella Clinica Web), derivato dall’adattamento del
Sismed prodotto dal progetto MeSIR al nuovo scenario strategico - infrastrutturale, rivolto ai medici MMG
e PLS che, sulla base di un’adesione volontaria, potranno fare uso di questo strumento software che
dispone di tutte le funzionalità necessarie all’informatizzazione di uno studio medico e, in particolare,
abilita alla prescrizione elettronica
1.1 Glossario
ASUR
Anagrafe Sanitaria Unica Regionale
CNIPA
Centro Nazionale Informatica Pubblica Amministrazione
CNS
Carta Nazionale dei Servizi dei servizi
DIT
Dipartimento Innovazioni tecnologiche della Presidenza del consiglio dei ministri
DPCM
Decreto Presidente consiglio dei ministri
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
5
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
MEF
Ministero dell’economia e della finanze
NRE
Numero Ricetta Elettronica
RGS
Ragioneria Generale dello Stato
SAC
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.
SAR
Sistema di Accoglienza Regionale
SASN
Servizio Assistenza Sanitaria personale Navigante
SPC
Sistema Pubblico Connettività
SSN
Servizio Sanitario Nazionale
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
6
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
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 riferimento 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.
e)
Art. 5: definizione dei dati delle ricette.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
7
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
3 Descrizione generale del Sistema
3.1 Architettura del Sistema
La presentazione logica dei sottosistemi del progetto si definisce nella figura successiva:
Il sistema si compone dei seguenti moduli funzionali:
Cartella Clinica Web: il modulo realizza le funzioni di gestione dei dati clinici degli assistiti. Il modulo è accessibile ai
Medici di Medicina Generale e Pediatri di Libera Scelta (MMG e PLS) interessati per gli assistiti di propria competenza.
Portale dedicato ai Medici Prescrittori: il modulo mette a disposizione di tutti i prescrittori regionali (medici di guardia,
medici specialisti ecc. e anche dei Medici di Medicina Generale e Pediatri di Libera Scelta interessati) le funzionalità
riguardanti i certificati di malattia, la registrazione delle prescrizioni specialistiche e farmaceutiche e le operazioni di
verifica delle trasmissioni delle ricette della propria competenza inviate al sistema SAC del MEF.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
8
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Amministrazione: il modulo raggruppa tutte le funzioni necessarie per la gestione delle utenze che possono eseguire
l’accesso alla Cartella Clinica Web e al Portale dei Medici Prescrittori, i relativi profili e abilitazioni. Le funzionalità di
amministrazione sono accessibili esclusivamente agli amministratori del sistema. Inoltre, sono disponibili le funzionalità
di monitoraggio degli invii dei dati al SAC del MEF.
Servizi Web e Integrazioni: il modulo raggruppa tutti i servizi Web per la gestione sul sistema centrale delle prescrizioni
specialistiche e farmaceutiche. I servizi sono disponibili ai sistemi esterni abilitati che ne fanno richiesta. Il documento
successivamente descrive in dettaglio questo sottosistema del progetto.
Trasmissione dati al SAC del MEF: il modulo realizza le funzionalità di trasmissione delle ricette che si riferiscono alle
prescrizioni registrate nel database SISMED al sistema SAC del MEF e la gestione degli scarti prodotti. Le funzionalità
sono accessibili solo agli amministratori di sistema.
3.2 Descrizione generale dei Servizi d’integrazione
Il Sistema espone i servizi Web per dare la possibilità ai software delle Aziende di comunicare con il SAR.
I servizi esposti sono destinati ai seguenti attori:

Aziende Sanitarie Regionali, che utilizzano il proprio software per la gestione delle prescrizioni e che dovranno
comunicare al SAR i dati relativi alle ricette prodotte.
Tutti i servizi web del SAR sono sviluppati seguendo le linee guida e impostazioni tecniche prodotte dal MEF – SOGEI
riguardo al progetto Tessera Sanitaria Elettronica e Medici in Rete.
In particolare al fine della corretta gestione dei documenti, il file XML deve essere scritto utilizzando l’insieme di caratteri
UNICODE ISO 10646 e codificato con la codifica UTF-8 o, in alternativa, per i sistemi operativi che non supportano
questo standard, con la codifica ISO 8859-1 Latin 1.
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
http://sistemats1.sanita.finanze.it/.
I Servizi Web che il sistema SAR espone sono:
Servizio
Descrizione
Trasmissione delle ricette
Tramite questo servizio è possibile
al SAR
inviare al SAR della Regione Lazio
(4.1 Trasmissione delle
le ricette prodotte dai software delle
ricette al SAR)
Aziende Regionali. Il SAR provvede
Web Services
Nome Servizio
SAR-SAC
InvioRicettaService
all’invio delle ricette ricevute al SAC
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
9
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Servizio
Descrizione
e
alla
ricezione
Web Services
Nome Servizio
SAR
InvioStatoService
SAR
ElencoAnaliticoEsitoRicette
SAR
RichiestaLottoService
Sismed
RicercaAssistitoService
dell’esito
dell’elaborazione eseguita dal SAC.
Per ogni invio il SAR restituisce il
numero del protocollo con il quale è
possibile richiedere lo stato e l’esito
di elaborazione.
Richiesta
Stato
Tramite questo servizio è possibile
Elaborazione delle Ricette
richiedere
al SAR
dell’elaborazione
( 4.2 Richiesta Stato
facenti parte di un invio effettuato,
Elaborazione delle
utilizzando il numero del protocollo
Ricette al SAR)
fornito dal SAR.
Richiesta
Esito
al
SAR
lo
stato
delle
ricette
Tramite questo servizio è possibile
Elaborazione delle Ricetta
richiedere
al
SAR
l’esito
al SAR
eventuali
errori
( 4.3 Richiesta Esito
dell’elaborazione
Elaborazione delle
facenti parte di un invio effettuato,
Ricetta al SAR)
utilizzando il numero del protocollo
e/o
ed
warning
delle
ricette
fornito dal SAR.
Richiesta Lotto NRE al
Tramite questo servizio è possibile
SAR
richiedere al SAR un nuovo lotto
(
4.4
Richiesta
Lotto
NRE al SAR)
NRE
da
utilizzare
registrazione
per
delle
la
ricette
elettroniche nel proprio sistema. I
lotti che possono essere richiesti
sono
soltanto
di
tipo
2
che
contengono 1000 NRE disponibili.
Ricerca Assistito per il
Tramite questo servizio è possibile
Codice Fiscale
ricercare un assistito nel Sismed
(4.5
Ricerca
Assistito
per Codice Fiscale)
Centrale.
Se
non
è
presente
automaticamente effettua la ricerca
nell’
Anagrafe
Sanitaria
Centrale/ASUR
Unica
Regionale tramite il Codice Fiscale.
Il servizio risponde con un set di
dati
anagrafici
completi
dell’assistito.
Inserimento
nuovo
Tramite questo servizio è possibile
Assistito
comunicare all’ Anagrafe Sanitaria
(4.6 Inserimento nuovo
Unica Regionale l’inserimento di un
Assistito)
nuovo assistito. Il sistema provvede
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
ASUR
InserimentoAssistitoService
10
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Servizio
Descrizione
Web Services
Nome Servizio
POSLAZIO
RicercaAssistitoRedditoService
Sismed Centrale
RicercaAssistitoPatologiaService
a verificare se l’assistito da inserire
è
già
presente
nell’
Anagrafe
Sanitaria Unica Regionale.
Ricerca
esenzioni
per
Tramite questo servizio è possibile
reddito dell’Assistito
richiedere l’esenzioni per reddito di
(4.7 Ricerca esenzioni
un
per reddito
Fiscale.
assistito
tramite
il
Codice
dell’Assistito)
Ricerca
esenzioni
per
Tramite questo servizio è possibile
patologia dell’Assistito
richiedere l’esenzioni per patologia
(4.8 Ricerca esenzioni
di un assistito tramite il Codice
per patologia
Fiscale.
dell’Assistito)
3.3 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 nel caso di software di Aziende Regionali di utilizzare l’utente e
password del medico prescrittore configurato nel sistema regionale di Access Management OpenSSO.
3.4 Procedura di richiesta dei credenziali
In ambiente di produzione, per i software delle Aziende Regionali, le credenziali per accedere ai Servizi Web di
Integrazione sono le stesse che utilizza il medico per accedere al Portale Regionale della Sanità (www.poslazio.it).
In ambiente di collaudo 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.
3.5 Gestione credenziali scaduti o invalidi
Nel caso in cui vengono inseriti 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 di mancata autenticazione.
Il formato XML del messaggio è seguente:
<?xml version="1.0" encoding="UTF-8"?>
<error>
<code>...</code>
<message>...</message>
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
11
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
<exception>...</exception>
</error>
Nel tag <code> possono essere presenti I seguenti valori:
Valore
Descrizione
0
Autenticazione fallita
1
Credenziali errati
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 inseriti
non sono valide o sono scadute.
Sulla base di questo errore il sistema, che invoca il Servizio Web, deve comunicare al medico che le credenziali inseriti
non sono valide o sono scadute.
Nel caso in cui la password di autenticazione è scaduta il medico può procedere con le modalità usuali per il recupero
della propria password.
3.6 Indicazione Struttura/Ambulatorio di riferimento
Per indicare la Struttura/Ambulatorio di riferimento e la Specialità del medico prescrittore, che invia le ricette elettroniche
al SAR utilizzando le proprie credenziali dell’OpenSSO Regionale, è necessario specificare un HEADER HTTP con il
seguente nome: codiceContesto.
Il valore del HEADER HTTP deve essere composto con le seguente modalità (dove [..] indicano valori opzionali):
codiceRuolo.codiceAsl[.codiceStruttura[_subCodiceStruttura][.codiceUO]]
Definizione:
codiceRuolo – la Specialità del Medico Prescrittore, come dalla codifica di SOGEI, con la quale il Medico è registrato
nel Sistema TS. I valori sono riportati nella tabella sottostante. Il valore è obbligatorio.
codiceAsl – il Codice della ASL/AO di competenza del Medico Prescrittore, come da registrazione nel Sistema TS. I
valori sono riportati nella tabella sottostante. Il valore è obbligatorio.
codiceStruttura - il Codice Struttura di competenza del Medico Prescrittore. Nel caso delle strutture pubbliche il valore
è opzionale e si riferisce ai codici del Sistema QUASIAS. Nel caso delle Strutture Classificate, il dato è obbligatorio e
valori sono riportati nella tabella sottostante.
subCodiceStruttura – il Sub Codice della Struttura di competenza del Medico Prescrittore. Il valore è opzionale e si
riferisce ai codici del Sistema QUASIAS
codiceUO – il Codice del Ambulatorio di competenza del Medico Prescrittore. Il valore è opzionale e si riferisce ai codici
codificati nel Sistema RECUP.
Codici delle Specialità Medico da utilizzare per codiceRuolo.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
12
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Codice
Descrizione
A
Specialista Ambulatoriale (Ex Sumai)
B
Medico consulente
C
Specialista di struttura privata accreditata
D
Dipendente dei servizi territoriali ASL
F
Medico di medicina generale
G
Guardia medica
H
Ospedaliero
I
Medico INAIL
P
Pediatra di libera scelta
T
Guardia medica turistica
U
Medico di azienda ospedaliero - universitaria
X
Altro (tirocinanti, specializzandi, etc.)
Z
Altra specializzazione
Codici ASL/AO da utilizzare per codiceAsl. Questa tabella sarà aggiornata in breve sulla base dei nuovi codici delle ASL
Codice
Descrizione
120101
RM/A
120102
RM/B
120103
RM/C
120104
RM/D
120105
RM/E
120106
RM/F
120107
RM/G
120108
RM/H
120109
VITERBO
120110
RIETI
120111
LATINA
120112
FROSINONE
120901
AZ.OSP.SAN CAMILLO-FORLANINI
120902
AZIENDA OSP. S.GIOVANNI/ADDOLORATA
120906
AZIENDA POLICLINICO UMBERTO I
120908
ISTITUTI FISIOTERAPICI OSPITALIERI
120918
INMI "L.SPALLANZANI" - IRCCS
120919
AZIENDA OSPEDALIERA SANT`ANDREA
120920
AZ. OSP. UNIV. POLICLINICO TOR VERGATA
Codici Strutture Classificati da utilizzare per codiceStruttura.
Codice
120070
Descrizione
OSP. REGINA APOSTOLORUM ALBANO
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
13
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Codice
Descrizione
120071
OSPEDALE SAN PIETRO FATEBENEFRATELLI
120072
OSPEDALE FATEBENEFRATELLI
120074
OSP. GEN. DI ZONA 'CRISTO RE'
120075
OSPEDALE ISRAELITICO
120904
OSPEDALE PEDIATRICO BAMBINO GESU`
120905
POLICLINICO A. GEMELLI E C.I.C.
120915
POLICL. UNIV. CAMPUS BIO MEDICO
Esempi di valori di HEADER HTTP:
Minimo Obbligatorio per la Struttura Pubblica: Z.120101 - Medico Prescrittore ha la specialità Z – “Altre Specializzazioni”
e lavora presso l’ASL Roma/A.
Minimo Obbligatorio per la Struttura Classificata: H.120101.120904 - Medico Prescrittore ha la specialità H –
“Ospedaliero” e lavora presso struttura ‘OSPEDALE PEDIATRICO BAMBINO GESU`’ con riferimento all’ASL Roma/A.
Altri esempi:
Z.120102.120165 - Medico Prescrittore ha la specialità Z – “Altre Specializzazioni” e lavora presso l’ASL Roma/B al
POLICLINICO CASILINO.
Z.120102.120165.OCU7 - Medico Prescrittore ha la specialità Z – “Altre Specializzazioni” e lavora presso l’ASL Roma/B
al POLICLINICO CASILINO, presso Ambulatorio ‘Oculistica Casilino’.
H.120101.120905_02 - Medico Prescrittore ha la specialità H – “Ospedaliero” e lavora presso struttura ‘POLICLINICO
UNIVERSITARIO A. GEMELLI’ con riferimento all’ASL Roma/A e presidio ‘COMPLESSO INTEGRATO COLUMBUS
(C.I.C.)’.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
14
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
4 Servizi Disponibili
4.1 Trasmissione delle ricette al SAR
Questo servizio permette di inviare come allegato un singolo file compresso (in formato zip ) contenente i dati relativi ad
una o più ricette compilate dal medico per prescrizioni farmaceutiche o specialistiche, e di ricevere un numero di
protocollo attestante l’avvenuta ricezione.
Il contenuto del file compresso da inviare viene esposto nell’apposito paragrafo 4.1.6 Schema dati della ricetta.
4.1.1 Accesso al servizio
L’indirizzo per raggiungere il servizio in ambiente di test :
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/InvioRicettaService
Sarà comunicato successivamente l’indirizzo per raggiungere i servizi esposti in ambiente di produzione.
La cadenza temporale con la quale possono essere effettuati invii consecutivi non deve essere inferiore a 2 secondi. La
violazione di tale vincolo può comportare una sospensione temporanea del servizio.
La dimensione massima consentita per il file allegato è di 1 Mbyte.
4.1.2 Certificato di Protezione
Il software gestionale di terzi parti deve essere in grado di codificare il codice fiscale utilizzando tecniche di crittografia
con la chiave pubblica RSA contenuta nel certificato X.509 fornito dalla LAit 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 LAit, 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.
4.1.3 Descrizione messaggio di invio
Ogni messaggio deve includere il singolo file che si vuole inviare telematicamente per mezzo della tecnologia SOAP
with attachments , ed inoltre debbono essere valorizzati all’interno del body del messaggio SOAP, i seguenti campi:
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
15
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)

nomeFileAllegato (obbligatorio)

telematico1 (opzionale riservato)

telematico2 (opzionale riservato)

telematico3 (opzionale riservato)
Segue la descrizione dei campi con il dominio dei valori ammissibili:
Nome Campo
nomeFileAllegato
Contenuto
Dominio
Nome locale del file allegato. (senza path). Tale campo
Stringa da 6 a 60 caratteri
deve essere valorizzato con il nome tramite il quale
alfanumerici
l’utente identifica, sul proprio sistema informativo, il file
che viene inviato.
Si consiglia di scegliere il Nominativo del medico che
produce il file (massimo 10 caratteri) dopo underscore e
prima dell’estensione zip, senza utilizzare caratteri
speciali.
Ad es: file02ago2011_NomeCognomeMedico4.zip
telematico1
Per futuro utilizzo
lasciare vuoto
telematico2
Per futuro utilizzo
lasciare vuoto
telematico3
Per futuro utilizzo
lasciare vuoto
4.1.4 Descrizione ricevuta di accoglienza
Per ogni invio effettuato il sistema risponde con un messaggio contenente le seguenti informazioni:
Nome Campo
protocolloSAC
Contenuto
Numero di protocollo assegnato dal SAR al file
Dominio
Stringa numerica a 23 cifre
trasmesso
dataAccoglienza
Data ed ora di accoglienza del file
dd-MM-yyyy HH:mm:ss
nomeFileAllegato
Nome del file dichiarato nel messaggio di input
Stinga da 6 a 60 caratteri
alfanumerici
dimensioneFileAllegato
Dimensione del file trasmesso (in byte)
Max. 1 MByte
codiceEsito
Codifica dell’esito di invio
Di seguito la Tabella di
decodifica
descrizioneEsito
Descrizione dell’esito di invio
Di seguito la Tabella di
decodifica
4.1.5 Tabella decodifica esito trasmissione
Codice Esito
Descrizione Esito
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
Altri Campi
16
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
000
il file è stato accolto correttamente
Tutti riempiti
101
il campo 'nomeFileAllegato' deve essere di almeno 6
Tutti vuoti
caratteri: il file non è stato accolto
102
l'allegato non è un file di tipo zip: il file non è stato accolto
Tutti vuoti
103
il file non è stato accolto perché l'allegato è vuoto
Tutti vuoti
200
il
file
non
è
stato
accolto
perché
c’è
un
errore
Tutti vuoti
nell'applicazione ed è necessario contattare l'assistenza
4.1.6 Schema dati della ricetta
Di seguito viene riportata la lista dei campi per la costituzione del messaggio di invio telematico al MEF
valido per una ricetta del SSN/SASN compilata dal medico.
Per lo schema XSD dei dati della ricetta si veda quanto descritto in RicettaMIR.xsd e per la definizione dei
campi contenuti nello schema si veda quanto descritto in TipiDatiMIR.xsd . I due file vengono forniti insieme
alla firma WSDL presente all’indirizzo di invocazione del servizio.La struttura gerarchica del messaggio è la
seguente:
RICETTA MIR(1)
TESTATA (1)
RICETTA (n)
A scelta fra ricetta in inserimento, variazione o cancellazione
PRESCRIZIONE (m)
Segue la descrizione dei campi con il dominio dei valori ammissibili, specificando che dove la lunghezza
minima del campo è 0 , questo è da intendersi non obbligatorio :
Lunghezza
Element name
schema XSD
Campo
Nome TAG
Min
Descrizione
Max
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
17
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Lunghezza
Element name
schema XSD
Testata
Campo
Nome TAG
PinCode
Min
1
Descrizione
Max
256
Codice
PIN
criptato
in
possesso
del
soggetto abilitato. Nel caso di integrazione
con il SAR, questo campo non sarà
verificato da parte del Sistema. Saranno
verificate le credenziali di accesso al Web
Service.
Testata
TipoInvio
3
3
Valore di riconoscimento del progetto di
riferimento secondo il quale trattare i dati
della ricetta:
1) Ricette prescritte dai medici su ricettari
del SSN: RPS
2) Ricette elettroniche prescritte dai medici e
numerate con NRE:REL.
Testata
Testata1
0
256
Campo destinato a informazioni aggiuntive
Testata
Testata2
0
256
Campo destinato a informazioni aggiuntive
Ricetta
ProtocolloSAC
0
23
Indica il numero di protocollo assegnato
durante l’inserimento (I) e deve essere
impostato SOLO in caso di aggiornamento
(V) e cancellazione (C).
Il numero di protocollo si riferisce al numero
del protocollo restituito da SISMED al
momento della ricezione.
Ricetta
Bar1
5
5
L’elemento contiene la prima parte del
codice a barre stampato dal Poligrafico sulla
ricetta del SSN oppure la prima parte del
Numero di ricetta elettronica (NRE).
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
18
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Lunghezza
Element name
schema XSD
Ricetta
Campo
Nome TAG
Bar2
Min
10
Descrizione
Max
10
L’elemento contiene la seconda parte del
codice a barre stampato dal Poligrafico sulla
ricetta del SSN oppure la seconda parte
dell’Numero di ricetta elettronica (NRE).
Ricetta
Altro
0
1
Campo destinato a informazioni aggiuntive
Ricetta
NoteInvio
0
256
Campo destinato a informazioni aggiuntive
Ricetta
CodiceAss
0
256
CF/STP/ENI/altro. Da inserire criptato.
Ricetta
TipoPrescrizione
1
1
F – per la prescrizione farmaceutica;
P – per la prescrizione specialistica.
I valori sono esclusivi.
Ricetta
CodEsenzione
0
10
Codice esenzione riportato in ricetta
Ricetta
NonEsente
0
1
Campo di biffatura “non esente” , la cui
compilazione è a cura del medico.
“null”=
Casella
“N”
non
biffata,
con
significato di prescrizione per soggetto
esente;
1= Casella “N” biffata, con significato di
prescrizione per soggetto non esente.
Ricetta
Reddito
0
1
Campo di biffatura “reddito” .
“null”=
Casella
“R”
non
biffata,
con
significato di prescrizione per soggetto non
esente;
1= Casella “R” biffata, con significato di
prescrizione per soggetto esente ovvero
autocertificazione del soggetto esente.
Ricetta
CodDiagnosi
0
7
Codice diagnosi o del sospetto diagnostico
secondo la codifica ICD9-CM.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
19
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Lunghezza
Element name
schema XSD
Ricetta
Campo
Nome TAG
Min
DescrizioneDiagnosi 0
Descrizione
Max
256
Descrizione della diagnosi o del sospetto
diagnostico.
Ricetta
TotPezzi
1
3
Numero totale di confezioni / numero totale
di prestazioni della ricetta. E’ la somma dei
campi quantità.
Ricetta
TipoRic
0
2
EE
=
Assicurati
extra-
europei
in
temporaneo soggiorno
UE = Assicurati europei in temporaneo
soggiorno
NA = Assistiti SASN con visita ambulatoriale
ND = Assistiti SASN con visita domiciliare
NE = Assistiti da istituzioni europee;
NX = Assistiti SASN extraeuropei
ST = Stranieri in temporaneo soggiorno
Rcetta
DataCompilazione
Aaaa-mm-gg
Data di compilazione della ricetta da parte
del medico
Ricetta
TipoVisita
1
1
Tipologia della visita:
A = ambulatoriale.
D = domiciliare.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
20
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Lunghezza
Element name
schema XSD
Ricetta
Campo
Nome TAG
DispReg
Min
0
Descrizione
Max
8
Disposizioni regionali specifiche. In questo
spazio devono essere inseriti le indicazione
di prescrizione di “Prazzoli”, “Statine” e
“Sartani” per le ricette farmaceutiche sulla
base delle disposizioni regionali descritte nel
capitolo 4.1.7.
Nel caso in cui la ricetta contiene sia lettera
di
"Statine/Sartani"
che
la
lettera
di
"Prazolo", nel campo DispReg vengono
inserite tutte due in seguente modalità: A|B
dove:
la prima è la lettera di "Statine/Sartane"
la
seconda
è
la
lettera
di
"Prazoli"
Le lettere sono divise con il carattere: |
Ricetta
ProvAssistito
0
2
Provincia di residenza dell’assistito (il campo
deve essere compilato congiuntamente con
AslAssistito)
Ricetta
AslAssistito
0
3
Asl di residenza dell’assistito (il campo deve
essere
compilato
congiuntamente
con
ProvAssistito)
Ricetta
IndicazionePrescr
0
1
Tipologia della prescrizione
S= Suggerita,
H= Ricovero,
A=Altro
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
21
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Lunghezza
Element name
schema XSD
Ricetta
Campo
Nome TAG
ClassePriorita
Min
0
Descrizione
Max
1
U="
Nel
più
breve
tempo
possibile,
comunque, se differibile, entro 72 ore",
B="Entro 10 giorni",
D="Entro 30 (visite), entro 60 giorni (visite
strumentali)",
P="Senza priorità"
Ricetta
StatoEstero
0
2
Informazioni del retro della ricetta per i
Ricetta
IstituzCompetente
0
28
soggetti assicurati da istituzioni estere.
Ricetta
NumIdentPers
0
20
Ricetta
NumIdentTess
0
20
Ricetta
DataNascitaEstero Aaaa-mm-gg
Ricetta
DataScadTessera
Aaaa-mm-gg
Ricetta
Ricetta1
0
256
Il campo, non obbligatorio, è destinato a
contenere il numero assegnato dai sistemi
regionali alla ricetta, laddove in uso, con
l’unico scopo di permettere all’inviante di
avere un ulteriore parametro di ricerca del
dato inviato al SAC.
Ricetta
Ricetta2
1
256
Il campo obbligatorio
codice
fiscale
in
deve contenere il
chiaro
del
medico
prescrittore che sta compilando la ricetta di
cui si trasmettono i dati. Tale codice fiscale
deve coincidere con le informazioni riportate
nello spazio della ricetta cartacea del SSN
destinato al timbro e alla firma.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
22
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Lunghezza
Element name
schema XSD
Prescrizione
Campo
Nome TAG
CodProdPrest
Min
0 (*)
Descrizione
Max
9
Il campo può contenere:

Codice prodotto farmaceutico
(AIC) nel caso di prescrizione di
farmaco con nome commerciale;

Codice prestazione specialistica
secondo il tariffario della regione
del medico prescrittore.
(*) ATTENZIONE:
il codice AIC può essere assente nel caso di
prescrizione per solo principio attivo (o se il
farmaco non è codificato dall’AIFA), mentre
il codice prestazione specialistica deve
SEMPRE essere indicato: ciò spiega perché
la lunghezza minima del campo può essere
0.
Prescrizione
DescrProdPrest
0
256
Il campo deve contenere:

per la prescrizione farmaceutica, il
CODICE DEL GRUPPO
EQUIVALENTE

per la prescrizione specialistica, la
descrizione testuale della
prestazione specialistica.
Prescrizione
NotaProd
0
3
Nota AIFA (solo per farmaceutica)
Prescrizione
Quantita
1
3
Quantità
di
prodotto
o
di
prestazioni
prescritte.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
23
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Lunghezza
Element name
Campo
schema XSD
Prescrizione
Nome TAG
Prescrizione1
Min
0
Descrizione
Max
256
Il
campo
deve
contenere
il
CODICE
corrispondente alla sintetica motivazione di
non sostituibilità del farmaco indicato tramite
codice AIC nell’apposito campo, individuata
tra quelle descritte nella tabella allegata,
oppure
della
specificazione
della
non
applicabilità dell’art. 15, comma 11-bis,
descritta nel punto 2.3
Prescrizione
Prescrizione2
0
256
Campo destinato a informazioni aggiuntive.
Tabella dei codici corrispondenti alla sintetica motivazione per la prescrizione farmaceutica:
Codice
Motivazione Sintetica
Descrizione
Ricomprende le condizioni di ipersensibilità, intolleranza o
controindicazione, già note, ad eccipienti contenuti in altri
farmaci equivalenti a quello prescritto. L’indicazione può
provenire da precedenti ADR oppure da reazioni ad alimenti o
cosmetici oppure da specifiche condizioni patologiche del
paziente oppure dalla presenza, nella terapia del singolo
Ipersensibilità,
1
intolleranza,
interazione
o
controindicazione
ad
eccipienti
paziente, di farmaci interagenti con specifici eccipienti. A titolo
esemplificativo si ricordano le reazioni allergiche da parabeni,
da coloranti (ad esempio E102, E216, E218), da olio di
arachidi non raffinato, ecc. Si ricordano inoltre le condizioni di
intolleranza
al
fenilchetonuria.
lattosio,
Si
al
ricorda
glutine,
la
all’aspartame
nella
controindicazione
alla
somministrazione di glucosio e di saccarosio nei diabetici. Si
ricorda l’interazione dell’alcool etilico con disulfiram e con
metronidazolo
e
l’interazione
del
polipropilenglicole,
controindicato nell’insufficienza renale, con disulfiram e
metronidazolo.
Ricomprende situazioni di difficile palatabilità o analoghe
2
Obiettive
assunzione
difficoltà
di difficoltà connesse con le caratteristiche della specifica
specialità
medicinale, con particolare riguardo anche
all’ambito pediatrico.
3
Terapia
complessa Ricomprende situazioni di difficile gestione del paziente in
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
24
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Codice
Motivazione Sintetica
/Problematiche assistenziali
Descrizione
relazione al deficit cognitivo o sensoriale o di particolare
complessità della terapia che possano esporre i pazienti ad
errori di assunzione per confusione tra confezioni.
Non si applica l’art. 15, comma 11-bis, in quanto non si tratta
4
Non art. 15, comma 11-bis
di una prima prescrizione per una patologia cronica o di un
nuovo episodio di patologia non cronica.
4.1.7 Disposizioni regionali
Di seguito vengono riportati i valori accettati nel campo DispReg dello Schema di ricetta.
Per la prescrizione di “Statine” (i codici ATC del farmaco prescritto sono dei gruppi C10AA e C10BA) e la
prescrizione di “Sartani” (i codici ATC del farmaco sono dei gruppi C09C e C09D) sono obbligatori i valori
riportate nella tabella sottostante.
L’opposizione del codice per il “Statine” non è più obbligatorio. Per le “Statine” viene applicato il
controllo della prescrivibilità di una sola confezione per ricetta.
L’opposizione del codice per il “Sartani” è obbligatorio, nel caso in cui è assente la ricetta viene
scartata.
Codice
Descrizione per la prescrizione di farmaci appartenenti ad una specifica categoria
terapeutica omogenea
Documentata intolleranza ai farmaci di cui è scaduta la copertura brevettuale appartenenti alla
B
stessa categoria terapeutica omogenea.
Documentata allergia e /o interazioni con terapie concomitanti ai farmaci di cui è scaduta la
C
copertura brevettuale appartenenti alla stessa categoria terapeutica omogenea
Documentata non risposta /inefficacia ai farmaci di cui è scaduta la copertura brevettuale
D
appartenenti alla stessa categoria terapeutica omogenea.
E
Particolari esigenze terapeutiche per pazienti a rischio.
F
Pazienti in prosecuzione di terapia, in particolare ospedale-territorio.
Per la prescrizione di “Prazzoli” ( i codici ATC del farmaco prescritto sono del gruppo A02BC, escluso
Lansoprazolo) sono obbligatori i valori riportati nella tabella sottostante.
L’opposizione del codice per il “Prazolo” non è più obbligatorio.
Codice
C
Eccezioni al pagamento della differenza del prezzo di riferimento
Paziente allergico al Lansoprazolo.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
25
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Codice
Eccezioni al pagamento della differenza del prezzo di riferimento
B
Paziente intollerante al Lansoprazolo.
D
Paziente che non risponde al Lansoprazolo.
E
Concomitante terapia con teofillina o tacromilus (possibilità di interazione farmacologia).
F
X
Paziente già in trattamento con PPI diversi dal Lansoprazolo secondo indicazioni e limitazioni
temporali della nota 48 (fino al completamento del ciclo terapeutico).
Nessun codice.
4.2 Richiesta Stato Elaborazione delle Ricette al SAR
4.2.1 Accesso al servizio
L’indirizzo per raggiungere il servizio in ambiente di test :
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/InvioStatoService
Sarà comunicato successivamente l’indirizzo per raggiungere i servizi esposti in ambiente di produzione.
4.2.2 Descrizione messaggio
Questo servizio fornisce per ogni protocollo del SAR le informazioni sintetiche sullo stato degli invii dal punto di vista
dell'accoglienza e dei controlli formali e sostanziali.
Tutte la date presenti nel messaggio sono nel formato gg/mm/aaaa.
4.2.2.1 Campi di input
Nome Campo
pinCodeIn
Contenuto
Tipo
pincode cifrato del richiedente, in quanto autenticazione per accesso ai servizi
Non obbligatorio
esposti dal SAR è nominativa il campo non viene utilizzato
Obbligatorio almeno una delle alternative tra
protocolloSac
numero di protocollo dell’invio di cui si richiede lo stato. Deve essere
valorizzato con il numero del protocollo restituito dal SAR al momento di
accoglienza.
Oppure
dataIniRange
data inizio intervallo temporale di ricerca
dataFineRange
data fine intervallo temporale di ricerca
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
26
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
4.2.2.2 Campi di output
Nome Campo
Contenuto
ciascun elemento contiene i campi :
Array di

protocolloSac :protocollo rilasciato dal SAR
ElencoStatoInviiRecord

data Invio : data di accoglienza dell’invio dal SAR

stato Invio : stato dell’invio:
o
1= file in attesa di elaborazione;
o
2= file elaborato correttamente e privo di errori;
o
3= file elaborato correttamente con presenza di warning;
o
4= file elaborato correttamente con presenza di errori
scartanti;
o
5= file completamente scartato.
4.3 Richiesta Esito Elaborazione delle Ricetta al SAR
4.3.1 Accesso al servizio
L’indirizzo per raggiungere il servizio in ambiente di test :
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/ElencoAnaliticoEsitoRicette
Sarà comunicato successivamente l’indirizzo per raggiungere i servizi esposti in ambiente di produzione.
4.3.2 Descrizione messaggio
Questo servizio fornisce per ogni protocollo del SAR le informazioni sintetiche sullo stato degli invii dal punto di vista
dell'accoglienza e dei controlli formali e sostanziali.
Tutte la date presenti nel messaggio sono nel formato gg/mm/aaaa .
4.3.2.1 Campi di input
Nome Campo
Contenuto
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
Tipo
27
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Nome Campo
Contenuto
pincode cifrato del richiedente, in quanto autenticazione per accesso ai
pinCodeIn
Tipo
Non obbligatorio
servizi esposti dal SAR è nominativa.
Obbligatorio almeno una delle alternative tra
protocolloSac
numero di protocollo dell’invio di cui si richiede lo stato. Deve esser
valorizzato con il numero di protocollo restituito dal SAR al momento di
accoglienza
Oppure
dataIniRange
data inizio intervallo temporale di ricerca
dataFineRange
data fine intervallo temporale di ricerca
4.3.2.2 Campi di output
Nome Campo
Contenuto
ciascun elemento contiene i campi:
Array di

protocolloSac : protocollo rilasciato dal SAR
ElencoEsitoRicetteRecord

data Accoglienza : data di accoglienza della ricetta

codRicetta : codice a barre della ricetta

array di Errori :
o
codice: codice dell'esito del controllo;
o
descrizione: descrizione dell'esito del controllo
4.4 Richiesta Lotto NRE al SAR
4.4.1 Accesso al servizio
L’indirizzo per raggiungere il servizio in ambiente di test :
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/RichiestaLottoService
Sarà comunicato successivamente l’indirizzo per raggiungere i servizi esposti in ambiente di produzione
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
28
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
4.4.2 Descrizione messaggio
Tramite questo servizio è possibile richiedere al SAR un lotto NRE da utilizzare nel proprio sistema informatico.
I lotti che possono essere richieste possono essere soltanto di identificativo 1 da 1000 numeri disponibili.
Al momento di invio delle ricette al SAC da parte del SAR, lo stesso provvederà di comunicare associazione del NRE
con il Codice Fiscale del medico che ha prodotto la ricetta.
4.4.2.1 Campi di input
Nome Campo
Contenuto
Tipo
codice regione
deve essere specificato il valore 120
obbligatorio
identificativo del lotto
indica quanti NRE devono essere contenuti in esso, è accettato
obbligatorio
codice fiscale
soltanto il valore 1.
contiene il codice fiscale del medico a cui deve essere assegnato il
obbligatorio
lotto
4.4.2.2 Campi di output
Nome Campo
codice regione
Contenuto
codice regione indicato in input
codice raggruppamento lotto codice raggruppamento del lotto
identificativo del lotto
codice identificativo del lotto indicato in input
codice indicante
indica l’esito delle richiesta
4.4.3 Composizione NRE
La
struttura
dell’NRE,
come
dalla
documentazione
ufficiale
pubblicata
sul
sito
http://sistemats1.sanita.finanze.it, è la seguente :
AAA BB C DDDDDDD EE per un totale di 15 caratteri così suddivisi:
AAA = codice della Regione / Prov. Autonoma che richiede il lotto;
BB= codice raggruppamento lotto, ossia codice alfanumerico assegnato automaticamente dal SAC, che
contraddistingue ricette con protocolli uguali;
C = identificativo del lotto, in base al quale il richiedente decide quanti NRE deve contenere il lotto, da un
minimo di 100 ad un massimo di 1 miliardo di numeri;
DDDDDDD = codice del lotto assegnato dal SAC (nella sua lunghezza massima);
EE = numero di protocollo singolo all’interno del lotto (nella sua lunghezza minima).
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
29
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
La lunghezza totale di un NRE è sempre di 15 byte.
La somma dei campi DDDDDDD + EE è sempre di 9 byte, potendo DDDDDDD variare da un massimo di 7
cifre ad un minimo di 0 e di conseguenza potendo EE variare da un massimo di 9 cifre ad un minimo di 2, in
funzione del valore assunto dal campo C che indica quanti NRE sono richiesti in un lotto.
Il campo C può valere, nel caso della richiesta del lotto al SAR:
1 , vengono richiesti 1.000 NRE (composizione NRE: AAA BB C DDDDDD EEE).
Esempio dell’output di WS Richiesta Lotto NRE:
Codice regione (AAA):120
Codice raggruppamento lotto (BB): A0
Identificativo lotto (C): 1
Codice Lotto (DDDDDD): 000194
In questo caso i numero NRE disponibili sono dal: 120A01000194000 al 120A01000194999 in totale 1000
numeri.
4.5 Ricerca Assistito per Codice Fiscale
4.5.1 Accesso al servizio
L’indirizzo per raggiungere il servizio in ambiente di test :
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/RicercaAssistitoService
Sarà comunicato successivamente l’indirizzo per raggiungere i servizi esposti in ambiente di produzione.
4.5.2 Descrizione messaggio
Tramite questo servizio, a fronte della richiesta, vengono restituiti i dati anagrafici dell’assistito per il Codice Fiscale
richiesto.
Tutte la date presenti nel messaggio sono nel formato gg/mm/aaaa.
4.5.2.1 Campi di input
Nome Campo
Contenuto
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
Tipo
30
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Nome Campo
Codice Fiscale
Contenuto
Codice Fiscale dell’assistito
Tipo
Obbligatorio
4.5.2.2 Campi di output
Saranno restituiti i campi descritti nella tabella successiva e relativi all’oggetto AssistitiDTO :
Saranno restituiti i campi descritti nella tabella successiva e relativi all’oggetto AssistitiDTO :
Nome Campo
Contenuto
Utilizzato da
SAR
S
capResidenza
cap di residenza del soggetto
codiceAslAssistenza
ASL di assistenza del soggetto
S
codiceAslDestinazione
solo per un utente regione: è l'ASL in cui si vuole inserire o
N
trasferire l'assistito (è un campo necessario perché il codice
ASL associato ad un utente regione è 000)
codiceAslEmittente
codice della asl che ha emesso la TS
N
codiceAslResidenzaAsl
ASL di residenza del soggetto
S
codiceAslResidenzaAT
ASL di residenza del soggetto in Anagrafe Tributaria
N
codiceAslUtente
codice ASL associato all'utente che invoca il ws
N
codiceAssistito
è' il codice presente sul libretto sanitario cartaceo.
N
Se non si possiede questo codice durante l'inserimento, il
sistema ne attribuisce uno automaticamente.
codiceComuneResidenza
codice ISTAT del comune di residenza
S
codiceEsitoInserimento
campo non utilizzato
N
codiceFineValidita
campo impostato automaticamente, vale 0 se
S
dataFineValidita=31/12/9999 e
dataFineValiditaSSN=31/12/9999, vale 4 se
dataFineValidita<31/12/9999 e
dataFineValiditaSSN=31/12/9999, vale 5 se
dataFineValidita<31/12/9999 e
dataFineValiditaSSN<31/12/9999
codiceFiscale
CF del soggetto
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
S
31
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Nome Campo
Contenuto
codiceFiscaleMedico
CF del medico
codiceMunicipio
è un numero che identifica i municipi, che sono
Utilizzato da
SAR
S
S
le aree in cui si dividono le grandi città. Ad esempio, Roma ha
20 municipi. In tutti gli altri casi il valore di default è 00, ma
può accadere che ci siano dei record sporchi con valore null.
codiceRegioneAssistenza
regione di assistenza del soggetto
S
codiceRegioneEmittente
codice della regione che ha emesso la TS
N
codiceRegioneResidenzaAsl
regione di residenza del soggetto
S
codiceRegioneResidenzaAT
regione di residenza in AT
N
codiceRegioneUtente
codice regione associato all'utente che invoca il W-S
N
codiceRitornoCics
ved. Codici di ritorno CICS
N
codiceRitornoCicsIns
campo non utilizzato
N

1= assistito in asl di residenza
N

3= assistito in asl non di residenza

6= rifiuto assistenza medico

7= soggetto senza associazione medico

8= straniero temporaneamente presente

N= nuovo nato- inserito d'ufficio

null=soggetto presente in AT ma non assistito
codiceTipoAssistito
codiceValidate
campo non utilizzato
N
cognome
cognome del soggetto
S
cognomeMedico
cognome del medico
S
comuneNascita
descrizione del comune di nascita
S
comuneResidenza
descrizione del comune di residenza
S
dataAssociazioneMedico
data di scelta del medico
S
dataDecesso
data di decesso del soggetto
S
dataDissociazioneMedico
data di fine associazione con il medico
S
dataEmissioneTessera
data di emissione della tessera
N
dataFineValidita
data scadenza dell'assistenza presso l'ASL che eroga
S
l'assistenza
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
32
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Nome Campo
dataFineValiditaSSN
Contenuto
data scadenza del diritto di assistenza da parte del
Utilizzato da
SAR
S
Servizio Sanitario Nazionale. In generale, per i cittadini italiani
vale 31/12/9999, per gli extracomunitari è pari alla data di
scadenza del permesso di soggiorno
dataFinValCertificato
data fine validità del certificato sostitutivo TEAM
S
dataIniValCertificato
data inizio validità del certificato sostitutivo TEAM
S
dataInizioValidita
data di inizio assistenza presso l'ASL che eroga l'assistenza
S
dataNascita
data nascita del soggetto
S
dataRilascioCertificato
data di rilascio del certificato sostitutivo TEAM
S
dataScadenzaTessera
data di scadenza della tessera
N
dataSpedizioneTessera
data di spedizione della tessera
N
descrizioneAslAssistenza
denominazione dell'asl di assistenza
S
descrizioneAslEmittente
descrizione della asl che ha emesso la TS
N
descrizioneAslResidenzaAsl
denominazione dell'asl di residenza secondo la fonte asl
S
descrizioneAslResidenzaAT
denominazione dell'asl di residenza secondo la fonte
N
Anagrafe Tributaria
descrizioneCodiceRitornoCics
ved. Codici di ritorno CICS
N
descrizioneCodiceRitornoCicsIns
campo non utilizzato
N
descrizioneCodiceTipoAssisti
descrizione del campo codiceTipoAssistito
S
to
descrizioneCodiceValidate
campo non utilizzato
N
descrizioneEsitoAssistito
campo non utilizzato
N
descrizioneEsitoInserimento
campo non utilizzato
N
descrizioneEsitoRicerca
campo non utilizzato
N
descrizioneRegioneAssistenza
denominazione della regione di assistenza
S
descrizioneRegioneEmittente
descrizione della regione che ha emesso la TS
N
descrizioneRegioneResidenzaAs
denominazione della regione di residenza secondo
S
l
la fonte asl
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
33
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Nome Campo
Contenuto
descrizioneRegioneResidenzaA
T
denominazione della regione di residenza secondo
Utilizzato da
SAR
N
la fonte Anagrafe Tributaria
esenzioni
campo non utilizzato
N
esitoAssistito
campo non utilizzato
N
flgE111
campo non utilizzato
N
flgEsenzione
campo non utilizzato
N
zero=indirizzo di residenza restituito dal sistema è corretto e
N
flgPrenotazioneTS

la TS sarà spedita a questo indirizzo

1=il soggetto inserito si dovrà recare al più presto presso
l’agenzia delle Entrte per cambiare la residenza e solo in
seguito la TS sarà spedita a questo nuovo indirizzo
flgStorico
flag interno che indica se l'assistito è stato
N
flgTS
aggiornato (0) oppure no (1)
campo non utilizzato
N
identificazioneModulo
al momento questo campo è null
N
idUtenteRichiedente
identificativo dell’utente che invoca il
N
servizio web. E’ un campo necessario per la tracciabilità delle
operazioni, ed è responsabilità di chi usufruisce dei web
services indicare un id utile per risalire alla persona fisica che
compie l’operazione,in genere il campo idUtenteRichiedente
contiene il codice
dell’operatore.
indirizzoResidenza
indirizzo di residenza del soggetto
S
isDatFinSSNIllimitata
campo non utilizzato
N
isDatFinValIllimitata
campo non utilizzato
N
isOperazioneValida
Il parametro isOperazioneValida è un oggetto di
N
tipo Boolean, si riferisce all’operazione corrente (ricerca,
inserimento o trasferimento) e vale true se l’operazione è
andata a buon fine, false in tutti gli altri casi.
istituzioneCompetente
istituzione che ha la competenza del rilascio del
S
certificato sostitutivo TEAM
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
34
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Nome Campo
Contenuto
tutti i messaggi, sia che l’esito dell’operazione sia
listaMessaggi
Utilizzato da
SAR
N
positivo, sia negativo, si trovano nell’array di messaggi
(listaMessaggi)
Eseguendo la Ricerca Assistito, se va a buon fine ci sarà il
codice messaggio:

RM0 con la descrizione: Ricerca per codice fiscale OK.
Se il soggetto è un assistito ci sarà il codice messaggio:

RM3 con una descrizione del tipo: assistito in ASL di
residenza (questa situazione corrisponde ad un
codiceTipoAssistito nel DTO con valore 1)
Se il soggetto non è un assistito ci sarà il codice messaggio:

RM3 con la descrizione: Il soggetto non è un assistito. (questa
situazione corrisponde ad un codiceTipoAssistito nel DTO con
valore null)
motivazioneFineValidita
usato per segnalare l'eventuale decesso
N
dell'assistito, in questo caso deve essere impostato a "2".
nome
nome del soggetto
S
nomeMedico
nome del medico
S
numeroTessera
numero della tessera ricerca per codice fiscale, trasferimento,
S
ecc. inserimento,
provinciaNascita
sigla della provincia di nascita del soggetto
S
provinciaResidenza
sigla della provincia di residenza del
S
soggetto
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
35
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Nome Campo
pwd
Contenuto
Utilizzato da
token dell’operazione: è un identificativo univoco
SAR
N
che permette di risalire a chi ha compiuto la singola
operazione. E’ compito delle Regioni garantire l’univocità del
token e registrare la persona fisica che ha compiuto
l’operazione. Il token ha lunghezza obbligatoria di 16 caratteri
di cui i primi tre sono il codice regione e i successivi tredici
sono alfanumerici
recapitoTessera
indirizzo di recapito della tessera
N
sesso
sesso del soggetto
S
statoMembroRilasciante
sigla dello stato membro dell'unione Europea che
S
rilascia il certificato, nel nostro caso è sempre
"IT"
statoTessera
stato attuale della tessera (per es. in corso di
N
emissione, spedita)
tipoAssistito
descrizione di codiceTipoAssistito
S
tipoTessera
Tipo di tessera:
N

TS

CNS/CRS

CNS in prenotazione

Non emettibile
4.6 Inserimento nuovo Assistito
4.6.1 Accesso al servizio
L’indirizzo per raggiungere il servizio in ambiente di test :
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/InserimentoAssistitoService
Sarà comunicato successivamente l’indirizzo per raggiungere i servizi esposti in ambiente di produzione.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
36
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
4.6.2 Descrizione messaggio
Tramite questo servizio è possibile comunicare al SAR l’inserimento di un nuovo assistito. Sarà il compito del SAR di
effettuare il controllo della presenza dell’assistito nell’ Anagrafe Centrale.
Tutte la date presenti nel messaggio sono nel formato gg/mm/aaaa.
4.6.2.1 Campi di input
Devono essere valorizzati i campi obbligatori dell’oggetto AssistitoDTO come descritto nella tabella del paragrafo: 4.5.2.2
Campi di output ( pagina: 31)
4.6.2.2 Campi di output
Sarà restituito il risultato di elaborazione del messaggio come nelle tabella sotto riportata:
Codice
Descrizione messaggio
IM01
Inserimento assistito OK
IM02
Soggetto già inserito come assistito
IM03
Validazione dei dati in ingresso OK
4.7 Ricerca esenzioni per reddito dell’Assistito
4.7.1 Accesso al servizio
L’indirizzo per raggiungere il servizio in ambiente di test :
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/EsenzioniRedditoAssistitoService
Sarà comunicato successivamente l’indirizzo per raggiungere i servizi esposti in ambiente di produzione.
4.7.2 Descrizione messaggio
Tramite questo servizio, a fronte della richiesta, viene restituita una lista di tutte le esenzioni per reddito certificati e/o
autocertificati dell’ assistito.
Tutte la date presenti nel messaggio sono nel formato gg/mm/aaaa.
4.7.2.1 Campi di input
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
37
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Nome Campo
Codice Fiscale
Contenuto
codice Fiscale dell’assistito da interrogare
Tipo
Obbligatorio
4.7.2.2 Campi di output
Nome Campo
Codice di ritorno del servizio
Contenuto
codice di ritorno del servizio
Descrizione del codice di ritorno del descrizione di ritorno del servizio
servizio
Codice della regione dell’esente
codice Regionale dell’esente
Codice fiscale dell’assistito
codice Fiscale dell’assistito
Codice ASL dell’assistito
codice ASL dell’assistito
Cognome dell’assistito
cognome dell’assistito
Nome dell’assistito
nome dell’assistito
Codice esenzione
codice esenzione dell’assistito
Data di inizio dell’esenzione
data di inizio dell’ esenzione dell’assistito
Data di fine dell’esenzione
data di fine dell’ esenzione dell’assistito
Numero
 di protocollo della
numero di protocollo della certificazione/autocertificazione
certificazione
dell’assistito
/autocertificazione

4.8 Ricerca esenzioni per patologia dell’Assistito
4.8.1 Accesso al servizio
L’indirizzo per raggiungere il servizio in ambiente di test :
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/EsenzioniPatologiaAssistitoService
Sarà comunicato successivamente l’indirizzo per raggiungere i servizi esposti in ambiente di produzione.
4.8.2 Descrizione messaggio
Tramite questo servizio, a fronte della richiesta, viene restituita una lista di tutte le esenzioni per patologie dell’ assistito.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
38
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Tutte la date presenti nel messaggio sono nel formato gg/mm/aaaa.
4.8.2.1 Campi di input
Nome Campo
Codice Fiscale
Contenuto
codice Fiscale dell’assistito da interrogare
Tipo
Obbligatorio
4.8.2.2 Campi di output
Nome Campo
Contenuto
Username richiedente
UserName del medico
Codice Fiscale richiedente
Codice Fiscale del medico
Codice di ritorno del servizio
codice di ritorno del servizio
Descrizione del codice di ritorno
descrizione di ritorno del servizio
del servizio
Codice della regione dell’esente
codice Regionale dell’esente
Codice fiscale dell’assistito
codice Fiscale dell’assistito
Codice ASL dell’assistito
codice ASL dell’assistito
Cognome dell’assistito
cognome dell’assistito
Nome dell’assistito
nome dell’assistito
array di esenzioni dell’assistito
ciascun elemento contiene i campi :

Codice esenzione

data di inizio dell’ esenzione

data di fine dell’ esenzione
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
39
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
5 Ambiente di test e servizi
5.1 URL Servizi
URL di accesso ai servizi in ambiente di test è generalizzato a:
https://sismed-collaudo.test.laitspa.it/sismed-ws/
Se accesso eseguito dal browser in questo indirizzo viene proposto elenco dei servizi disponibili:
I nomi dei singoli servizi sono presenti nella tabella successiva:
Servizio
Trasmissione delle ricette al SAR
Web Services Collaudo
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/
InvioRicettaService
Richiesta Stato Elaborazione delle Ricette al SAR
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/
InvioStatoService
Richiesta Esito Elaborazione delle Ricetta al SAR
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/
ElencoAnaliticoEsitoRicette
Richiesta Lotto NRE al SAR
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/
RichiestaLottoService
Ricerca Assistito per il Codice Fiscale
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/
RicercaAssistitoService
Inserimento nuovo Assistito
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/
InserimentoAssistitoService
Ricerca esenzioni per reddito dell’Assistito
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/
EsenzioniRedditoAssistitoService
Ricerca esenzioni per patologia dell’Assistito
https://sismed-collaudo.test.laitspa.it/sismed-ws/service/
EsenzioniPatologiaAssistitoService
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
40
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
5.2 Accesso Servizi
Per effettuare l’accesso ai servizi esposti, tramite basic authentication è presente l’utenza valida per tutti gli attori
interessati all’integrazione:
Utente: mario.rossi.14
Password: WsSAR001
5.3 Dati DB di test
I dati presenti sul DB di test possono essere così riepilogati:
L’utente/medico mario.rossi.14 corrisponde al Codice Fiscale FGLMSM55B02H501Y, che ha sua volta viene accettato
dal DB di test di SOGEI come MMG con il contratto con ASL di RIETI – 120110. Il codice della regione 120 e dell’ASL
110 deve essere inserito nei parametri di input dei servizi che lo richiedono.
Il Sistema individuerà automaticamente il medico sulla base dell’autenticazione effettuata per accedere ai servizi. Anche
se il PIN del medico è richiesto nei WSDL dei servizi (come per le specifiche di SOGEI) il sistema SAR non terra conto di
questo dato.
Nella tabella successiva sono presenti alcuni di Codici Fiscali degli assistiti presenti sul DB di Test.
Codici Fiscali
MZZTZN78P52H501X
DNLRNT30R45I418T
BRNFNC70L61H501H
DRSMRS61P55H501B
FSTFDN29H21A746J
FRRGNI56A02G273S
MRNPLA49P24H501W
CLLRLB40E49F158K
SNTDNL53M62G601J
PTRMSM52D13E472R
CNGCNZ58B57H501N
RFFRZE69E43H501E
DRNMRC81A15B114I
MRTSDR65R24H501U
BRRNNZ38P50H501X
NGLMRP39A46A515Y
PSCMLS29H51F656G
AAXAAA00A50H5L1O
LTTGRG56T20Z336N
SNTFLC80A12H501S
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
41
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Codici Fiscali
CLLRSM27B10D708K
DRNPRZ61E53H501T
PRLCRM35E69F970Y
SNTCRL55B23H501D
RCCVLE20E57E799B
MRTVCN57C12F734X
CSSFRC78B21H501T
BNVNNA50S66H501S
LRTBRC44P54G232R
PTRBBR68D46H501N
DPLNDR48E21L120B
Anche se Codici Fiscali possono risultare corretti (ai fini di controlli che effettua SOGEI sulle ricette anche in ambiente di
Test), i dati anagrafici associati a questi assistiti sono di fantasia.
Per l’assistito con il Codice Fiscale DPLNDR48E21L120B possono essere richieste Esenzioni per reddito.
Per quasi tutti gli assistiti, con Codici Fiscali elencati, sono presenti le esenzioni per la patologia.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
42
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
6 Codifica degli errori elaborazione ricette
Gli errori, che vengono restituiti al software inviante, dopo l’elaborazione delle ricetta sono suddivisi nei seguenti gruppi:
Errori/Avvisi restituiti dal SAR così composti:

SAREXXXX – per gli errori scartanti.

SARWXXXX – per gli avvisi.
Errori/Avvisi restituiti dal SAC così composti:

SACEXXXX – per gli errori scartanti.

SACWXXXX – per gli avvisi.
6.1 Errori SAR
In dettaglio la descrizione degli errori SAR :
Codice
SARE0000
Descrizione
Commento
Errore scartante: tecnico in fase di elaborazione La descrizione degli errori più frequenti sono
ricetta
descritte nella tabella successiva
L’errore segnala che il medico che sta inviando le
SARE0016
Errore scartante: Nessun contratto MMG/PLS ricette non risulta il contratto con l’ASL regionale.
trovato col codice fiscale assegnato
Nel caso di questo errore deve essere contattato
il supporto tecnico.
Questo errore si presente nel caso in cui il
SARE0020
Errore
nel
tentativo
di
inviare
al
SAC servizio del SAC non è disponibile. Il SAR
l'associazione per la ricetta {0}
comunque effettua i tentativi ripetute dell’invio,
finche il servizio non sarà disponibile.
SARE1000
Errore scartante: Errore SAR nell'invio al SAC
SARE1010
Nessuno esito dell'invio trovato
Provincia di residenza dell’assistito (il campo
Errore scartante: Non sono stati impostati
SARE2011
contemporaneamente sigla provincia e codice
ASL
ProvAssistito ) e Asl di residenza dell’assistito (il
campo AslAssistito) devono essere valorizzati
contemporaneamente, nel caso in cui è previsto
dal Disciplinare tecnico della ricetta e descritto
nella Schema dati della ricetta.
SARE2016
SARE2104
SARE2105
SARE2106
Errore scartante: Codice fiscale medico non
valido
Errore scartante: l'elemento TipoRic non è Il campo deve avere i valori descritti nella
impostato correttamente
Schema dati della ricetta.
Errore scartante: l'elemento indicazionePrescr Il campo deve avere i valori descritti nella
non è impostato correttamente
Schema dati della ricetta.
Errore scartante: l''elemento ClassePriorita non Il campo deve avere i valori descritti nella
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
43
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Codice
Descrizione
Commento
è impostato correttamente
SARE2107
SARE2110
SARE2111
SARE2115
SARE2116
SARE2118
SARE2119
SARE2120
SARE2121
SARE2122
SARE2123
SARE2124
SARE2125
SARE2215
SARE2221
Errore scartante: l''elemento tipoVisita non è Il campo deve avere i valori descritti nella
impostato correttamente
Errore
scartante:
Schema dati della ricetta.
l'elemento
bar1
non
è
bar2
non
è
impostato correttamente
Errore
scartante:
l'elemento
impostato correttamente
Errore scartante: l'elemento dataCompilazione
non è impostato correttamente
Errore scartante: l'elemento CodiceDiagnosi
non è impostato correttamente
La prima parte di 5 byte di NRE.
La seconda parte di 10 byte di NRE.
Errore formale della data.
Il Codice ICD9-CM deve essere trasmesso
incluso i punti. La codifica completa di ICD9-CM
è pubblicata dal’ASP Lazio.
Errore scartante: l'elemento CodiceEsenzione Il Codice Esenzione impostato non è presente nel
non è impostato correttamente
Sistema.
Errore scartante: l'elemento Stato Estero non è Il Codice Stato Estero impostato non è presente
impostato correttamente
nel Sistema.
Errore scartante: l'elemento codice prodotto Il Codice Stato Estero impostato non è presente
non è impostato correttamente
nel Sistema.
Errore scartante: l'elemento nota prodotto non è Il codice della nota AIFA del farmaco non è
impostato correttamente
presente nel Sistema.
Errore scartante: l''elemento quantità prodotto
non è impostato correttamente
Errore formale della quantità.
Errore scartante: l'elemento provincia assistito Il Codice Provincia impostato non è presente nel
non è impostato correttamente
Sistema.
Errore scartante: l''elemento ASL assistito non Il Codice ASL
è impostato correttamente
impostato non è presente nel
Sistema.
Errore scartante: l''elemento DispReg non è
impostato correttamente
Errore formale.
Errore scartante: Impossibile trovare numero È stato inviato l’annullamento o la modifica della
ricetta da variare o cancellare
ricetta che non è stato trovato nel Sistema
Errore scartante: l'elemento DataNascitaEstero
non è impostato correttamente
Errore
SARE2231
Schema dati della ricetta.
scartante:
DataScadenzaTessera
non
Errore formale nella data (retro della ricetta).
l'elemento
è
impostato Errore formale nella data (retro della ricetta).
correttamente
Nel caso di tipologia della ricetta:
SARE2232
Errore scartante: Istituzione competente non
presente
EE = Assicurati extra- europei in temporaneo
soggiorno
UE = Assicurati europei in temporaneo soggiorno
NE = Assistiti da istituzioni europee;
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
44
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Codice
Descrizione
Commento
NX = Assistiti SASN extraeuropei
I campi di retro ricetta devono essere compilati
obbligatoriamente.
SARE2233
SARE2234
SARE2985
SARE5103
SARE5108
SARE5406
SARW5401
SARW5402
SARW5403
SARW5404
SARW5405
SCREEEA03
SCREEEA09
Errore
scartante:
Numero
identificazione
Personale non presente
Errore
scartante:
Numero
identificazione
Tessera non presente
Come sopra.
Errore scartante: La ricetta non contiene
prescrizioni
Errore scartante: Codice Fiscale non presente
in archivio assistiti
Errore scartante: Codice Fiscale assistito non
impostato
Errore
scartante:
Codice
prestazione
non Il Codice prestazione non è presente nel
presente nel tariffario regionale
Sistema.
Avviso: la lunghezza del codice prodotto è
errata
Avviso: codice AIC non presente nel prontuario
terapeutico
Avviso: codice AIFA del gruppo equivalenza
non presente in archivio
Avviso: motivazione di non sostituibilità assente
Avviso:
motivazione
di
non
sostituibilità
presente
Inserire il protocollo oppure un intervallo di date
La data fine deve essere maggiore della data
inizio
SCREEEA04
La data inizio non è valida
SCREEEA05
La data fine non è valida
SCIAMIM01
Inserimento assistito OK
SCIAMIM02
Soggetto già inserito come assistito
SCIAMIM03
Validazione dei dati in ingresso OK
SCIAEIE35
Inserire codice asl e codice regione residenza
SCIAEIE05
Si è verificato un errore durante l'inserimento
SCIAEIE57
Come sopra.
Problema nella verifica dei codici regione e asl
residenza
SMIAEIE80
Dati anagrafici mancanti
SMIAEIE81
Comune di nascita non presente nel database
SMIAEIE82
Codice comune di residenza errato o non
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
45
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
Codice
Descrizione
Commento
presente nel database
SMIAEIE83
Istituzione competente errata o non presente
SMIAEIE84
Codice identificativo modulo assente
SMIAEIE85
Stato certificato vuoto o non presente sul db
Data inizio e data fine certificato non presenti o
SMIAEIE86
errati
SMIAEIE87
Data fine precede la data inizio certificato team
SCRAMRM00
Ricerca per codice fiscale OK
SCRAERE00
Assistito non trovato
SCRAERE01
Codice fiscale mancante o formato errato
SCRAERE03
Errore nella ricerca nei database
SARE0000 – errore scartante del SAR, che corrisponde agli errori nella compilazione della ricetta relativi alle
disposizioni regionali e/o incongruenza grave nel dati che impediscono salvataggio della ricetta inviata nel DB del SAR.
In questo caso la descrizione dell’errore è esplicitamente descrive il problema.
Sulla base dei test effettuati gli esempi più frequenti di errori di questo tipo sono:
Descrizione
Commento
Questi errori sono dovute all’assenza della indicazione
“Prazolo e obbligatorio”, “Sartani e obbligatorio”, obbligatoria, prevista dalle disposizioni regionali, nel campo
“Statine e obbligatorio”.
Ricetta.DispReg del tracciato della ricetta, per le prescrizioni
farmaceutiche relativi ai farmaci di questi tipi.
Errori di questo tipo sono dovuti all’incompatibilità della
“La
prestazione
XX.XX
e
incompatibile
con prestazione con l’esenzione presente nella ricetta, sulla base
l'esenzione XXX.XX”.
delle regole regionali di compilazione della ricetta, che rende
invalida la ricetta
Errori di questo tipo sono dovuti all’incompatibilità del farmaco
“Il
prodotto
farmaceutico
XXXXXXXXX
non
compatibile con l'esenzione XXX”.
e con l’esenzione presente nella ricetta, sulla base delle regole
regionali di compilazione della ricetta, che rende invalida la
ricetta.
Impossibile
confermare
una
differente dalla data odierna.
ricetta
con
data La ricetta è stata inviata al SAR in data diversa dalla data
della compilazione.
6.2 Errori SAC
Gli errori restituiti dal SAC possono essere scaricati dal sito http://sistemats1.sanita.finanze.it/.
Il documento, scaricato dal sito, è allegato al presente documento.
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
46
Specifiche per l’integrazione dei software delle Aziende
Regionali con il Sistema di Accoglienza Regionale (SAR)
7 Elenco allegati
Nome Documento
descrizione+delle+anomalie+e+soluzioni+DPCM+26.03.2008.pdf
LAZIOcrea S.p.A. – Società a Socio unico Regione Lazio – Cap. Soc. € 924.400,00
Sede legale e amministrativa: Via del Serafico, 107 00142 Roma - T +39 06 515631 F +39 06 51563611
Uffici: Via Adelaide Bono Cairoli, 68 – Roma 00145 – T +39 06 51689800 – F +39 06 51892207
C.F./P.IVA 13662331001 – R.E.A. RM-1464288
Revisione
Data
Autore
SOGEI
47