INTRODUZIONE AL SISTEMA DI INVIO

Il Ministero dell’Economia e delle Finanze (MEF) mediante la propria rete telematica, cura il
collegamento senza oneri aggiuntivi, per l’accesso al servizio telematico per l’invio dei file da
parte delle aziende sanitarie locali, delle aziende ospedaliere, degli istituti di ricovero e di cura
a carattere scientifico, dei policlinici universitari, delle farmacie pubbliche e private, dei
presidi di specialistica ambulatoriale e degli altri presidi e strutture accreditate per
l’erogazione dei servizi sanitari.

In particolare è previsto che gli operatori sanitari coinvolti effettuino l’acquisizione, la

predisposizione e la trasmissione dei dati, mentre è a carico del MEF l’infrastruttura
tecnologica di trasmissione e l’intera organizzazione del Sistema TS.

Le SSA (Strutture Sanitarie Accreditate) per poter utilizzare il servizio telematico devono
essere preventivamente autorizzate dal MEF che già possiede l’elenco delle strutture
accreditate fornito e aggiornato dalle ASL (Ministero della Salute).

Il Ministero dell’Economia e delle Finanze provvede a recapitare al domicilio dell’interessato

una lettera contenente:

le informazioni anagrafiche dell’utente abilitato;

il ‘CODICE IDENTIFICATIVO’, la prima parte del ‘PINCODE’, e il
‘NOME UTENTE’;
l’invito a recarsi presso gli uffici territoriali di competenza, per l’autenticazione e
l’abilitazione al servizio.

Il MEF all’atto dell’abilitazione al servizio, fornisce al soggetto incaricato:

la ‘PAROLA CHIAVE’, la seconda parte del ‘PINCODE’, e la ‘PASSWORD’.
 INTRODUZIONE ALL’USO DEL PROGRAMMA

L’utente abilitato è tenuto a costituire un file in formato XML conforme alle specifiche
tecniche, contenente i dati relativi alle ricette da inviare, e ad utilizzare il software distribuito
dal MEF che provvede a:

Validare il file
Inviare il file
Visualizzare l’esito dell’invio
Visualizzare l’esito delle validazioni (log)

Prima di procedere alla trasmissione se nella struttura è presente un proxy di rete, sarà
necessario configurarlo.

Si sottolinea che il software fornito è autoaggiornante, al fine di sollevare l’utente da

operazioni di manutenzione e garantire una maggiore affidabilità del servizio.
L’utente verrà avvisato dell’aggiornamento attraverso una finestra di conferma.

2
 CONFIGURAZIONE DEL PROXY DI RETE

Attivare il programma e selezionare la voce “Proxy”, scegliendo la funzione

“Configurazione”.

Accesso al pannello di configurazione del proxy

3
Si attiva così un pannello che consente l’impostazione dei parametri richiesti:

Ip_Server: indirizzo di rete del server proxy

Porta: porta utilizzata per il collegamento con il server proxy
Nome_utente: utente abilitato presso il server proxy
Password: password associata all’utente abilitato presso il server proxy

I dati immessi nei vari campi del pannello, sono legati esclusivamente alla configurazione
locale del proprio proxy di rete e non dovranno essere necessariamente tutti impostati.
Al momento dell’installazione il proxy è disabilitato.

Pannello di configurazione del proxy

4
 VALIDARE I FILE

L’operazione di validazione effettua il controllo formale dei file XML, e tramite la

compressione e la cifratura dei file selezionati genera file con estensione “.SSA”, garantendo
così l’integrità e la riservatezza dei dati che verranno inviati.
I file XML elaborati verranno spostati dalla cartella sorgente, nella cartella proprietaria del
programma “fileValidati” (C:\RicetteSSNOnline\onLine\fileValidati), e verranno rinominati
aggiungendo in testa al nome, la data di validazione (es. “data_prova.xml”).
All'interno della voce “Operazioni” nel menu, è presente la funzione “Valida File” che
consente l’accesso alla funzione sopra descritta e costituisce la prima attività da effettuare per
poter inviare i file; tale funzione è attivabile anche in maniera diretta cliccando sul tasto
“Prepara” posto nel menù a sinistra della pagina.
Attenzione: ogni singolo file selezionato non deve superare i 500 Mbyte di dimensione.

Accesso al pannello di validazione dei file

5
A questo punto è possibile selezionare uno o più file XML contemporaneamente, sui quali
sarà effettuato il controllo strutturale e formale secondo i requisiti richiesti.
I file vanno cercati nella cartella in cui essi risiedono, attraverso il pannello di selezione
apposito.

Pannello di selezione dei file da validare

6
Nel caso in cui sia sottoposto ad elaborazione un solo file e l’esito della validazione dia un
risultato negativo, viene visualizzata automaticamente la finestra di log che segnalerà nel
particolare gli errori rilevati.
Se l’errore fosse bloccante si potrà procedere all’annullamento dell’operazione, oppure alla
validazione di una nuova fornitura; nel caso in cui l’errore fosse non bloccante, sarà
comunque possibile procedere nell’elaborazione mediante il tasto “Prosegui Elaborazione”.

Pannello di visualizzazione esito di validazione (log)

Nel caso in cui la validazione dia esito positivo, verrà richiesto direttamente il ‘PINCODE’
(figura successiva)

7
E’ possibile a questo punto scegliere se inviare i file validati, oppure se validare ulteriori file,
tornando alla schermata precedente.
Per ogni file “.XML” validato correttamente, nella cartella “repository”
(C:\RicetteSSNOnline\onLine\repository) verrà generato un file con estensione “.SSA”.
I file “.SSA” inviati, verranno eliminati automaticamente al momento della conclusione
positiva del loro invio.

Pannello di inserimento del ‘PINCODE’

8
 INVIARE I FILE

All'interno della voce “Operazioni” nel menu, è presente la funzione “Connetti per Inviare”
che consente l’invio al MEF dei file precedentemente validati, tramite internet.

Accesso al pannello di invio dei file

9
La finestra invio visualizza tutti i file che hanno superato la validazione e che sono pronti
quindi per essere inviati.
Nel caso in cui si dovesse uscire dal programma, tali file rimarranno pronti per l’invio al
successivo avvio dell’applicazione.
Attenzione: i file che dovessero superare 1,5 Mbyte di dimensione, dovranno essere inviati
manualmente attraverso il portale di Sistema TS.

Pannello di gestione dell’invio dei file

10
Prima di procedere all’invio è necessario effettuare l’autenticazione attraverso i propri codici
‘CODICE IDENTIFICATIVO’ e ‘PAROLA CHIAVE’ (forniti dal MEF), e garantire che il
PC sia collegato ad internet, verificando ad esempio che si possa navigare attraverso un
qualsiasi browser.

Pannello di autenticazione pre-invio

A questo punto può venir richiesta conferma per l’autoaggiornamento del software

11
 VISUALIZZARE L’ESITO DELL’INVIO

L’esito della trasmissione viene “certificato” all’utente attraverso il numero di protocollo che
il sistema assegnerà ad ogni singolo file trasmesso.
Per ogni file inviato, il sistema produrrà una ricevuta in formato “.XML” che rimarrà sempre
disponibile sul proprio PC nella cartella proprietaria del programma “ricevute”
(C:\RicetteSSNOnline\onLine\ricevute).
L’elenco dei protocolli dei file trasmessi rimarrà anch’esso disponibile sul proprio PC nella
cartella “fileInviati” (C:\RicetteSSNOnline\onLine\fileInviati).

Pannello di gestione dell’invio dei file

12
Dal protale Sistema TS, previa autenticazione, sarà immediatamente possibile visualizzare la
ricevuta in formato pdf, che attesta il corretto invio del file.
Entro 5 giorni lavorativi, il file inviato verrà elaborato ed i campi della ricevuta verranno
valorizzati con l’esito dell’elaborazione del file.
Assieme alla ricevuta, sarà possibile prelevare anche un file di dettaglio in formato CSV, che
conterrà il riferimento puntuale alle eventuali incongruenze riscontrate nel contenuto del file.

Pagina web di dettaglio per gli invii effettuati

13
 VISUALIZZARE L’ESITO DELLE VALIDAZIONI (LOG)

L’esito di tutte le validazioni effettuate nel corso del tempo, è visualizzabile sul proprio pc
attraverso il menu “Applicazioni”, con la funzione “Visualizza Log”.

Accesso al pannello di visualizzazione del log

14
Attraverso tale pannello è possibile scegliere il log relativo al file validato.

Pannello di selezione dei file di log

15
In questa finestra è visualizzato l’esito di validazione di un file precedentemente processato.

Pannello di visualizzazione esito di validazione (log)

Cliccando sul tasto “Leggi log” verrà aperta una finestra che consentirà di stampare l’esito
visualizzato.

16
 LA PROCEDURA DI AUTOAGGIORNAMENTO

Al momento dell’invio dei file, viene confrontata automaticamente la versione del software
usata, con quella rilasciata sul portale di Sistema TS.
Nel caso in cui la versione utilizzata non sia identica a quella rilasciata, viene attivata la
procedura automatica di aggiornamento, che chiede conferma attraverso l’apposito pannello
di dialogo.

Pannello di richiesta aggiornamento client

In alcuni casi si potrà decidere se aggiornare o meno il software, mentre in altri casi
l’aggiornamento sarà obbligatorio.
Nel caso in cui si accetti di aggiornare il client, si dovrà attendere fino a quando non compaia
il pannello di conferma sottostante.

Pannello di conferma aggiornamento client

17
A questo punto il client risulterà aggiornato alla versione rilasciata sul portale di Sistema TS.
Per utilizzare la nuova versione basterà riavviare normalmente il programma.

PROCEDURA ALTERNATIVA IN CASO DI ERRORE:

Nel caso venga restituito un errore simile a quello visualizzato di nel pannello sottostante,
cliccare su ‘OK’.

Pannello di errore

E successivamente sul tasto ‘CLOSE’ del pannello di identificazione dell’errore.

18
 Pannello di identificazione dell’errore

A questo punto bisognerà confermare l’aggiornamento del client tramite l’apposito pannello,
per poter chiudere il programma.

Pannello di conferma aggiornamento client

19
Verificata la chiusura del programma, si dovrà aprire la cartella “RicetteSSNOnline”
(C:\RicetteSSNOnline), e lanciare il file “patch.exe”.
A questo punto il client risulterà aggiornato alla versione rilasciata sul portale di Sistema TS.
Per utilizzare la nuova versione basterà riavviare normalmente il programma.

20