SISTEMA TESSERA SANITARIA

SISTEMA TESSERA SANITARIA

Invio dei dati di spesa sanitaria di cui art. 3 comma 3 D.ls 175/2014

WEB SERVICE SINCRONO

(DECRETO 31 LUGLIO 2015)

VERSIONE 1.3 del 20 12 2020

Sistema Tessera Sanitaria

730 - Spese Sanitarie

Invio dei dati di spesa sanitaria di cui art. 3 comma 3 D.ls

175/2014 - WEB SERVICE SINCRONO

20/12/2020

Vers. 1.3

Pag. 2 di 25

INDICE

1. REVISIONI DEL DOCUMENTO 3

2. INTRODUZIONE 4

3. SERVIZIO PER LA GESTIONE DEL DOCUMENTO FISCALE 730 PRECOMPILATO 5

3.1 DESCRIZIONE DEGLI ELEMENTI COMUNI DEI MESSAGGI DI RICHIESTA PER I SERVIZI DOCUMENTO DI SPESA 6

3.2 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RICHIESTA PER L’INVIO DEL DOCUMENTO

DI SPESA: 17

3.3 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RISPOSTA PER L’INVIO DEL DOCUMENTO DI

SPESA: 18

3.4 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RICHIESTA PER LA VARIAZIONE DEL

DOCUMENTO DI SPESA: 18

3.5 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RISPOSTA PER LA VARIAZIONE DEL


3.6 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RICHIESTA PER LA CANCELLAZIONE DEL


3.7 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RISPOSTA DELLE PER LA CANCELLAZIONE

DEL DOCUMENTO DI SPESA: 20

3.8 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RICHIESTA PER IL RIMBORSO DEL


3.9 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RISPOSTA PER IL RIMBORSO DEL


4. ENDPOINT 23

4.1 ACCESSO IN BASIC AUTHENTICATION O CERTIFICATO CNS 23

4.2 ACCESSO CON CERTIFICATO CLIENT (PER REGIONI O ENTI INVIANTI) 23

4.3 ACCESSO CON CREDENZIALI ENTRATEL (PER INTERMEDIARI FISCALI) 24

5. SPECIFICHE TECNICHE 25





20/12/2020

Vers. 1.3

Pag. 3 di 25

1. REVISIONI DEL DOCUMENTO

VERSIONE DATA

MODIFICA

DESCRIZIONE

1.1 17/12/2019 Modifica tabella con nuovi soggetti obbligati e voci di spesa (pag.11)

Introduzione Flag sulla modalità di pagamento

pagamentoTracciato (pag. 12)

1.2 19/11/2020 Inserimento campi previsti dal DM 19 ottobre 2020

1.3 20/12/2020 Adeguamento nome campi e descrizioni





20/12/2020

Vers. 1.3

Pag. 4 di 25

2. INTRODUZIONE

Il seguente documento illustra le modalità con cui il Sistema TS rende disponibili ai soggetti invianti la possibilità di gestire e predisporre un documento di spesa.

L’invio al sistema TS di un documento di spesa può avvenire secondo 3 modalità:

1. Inviando un file con più documenti, allegato ad un messaggio SOAP (web service cosiddetto “asincrono”, perché la risposta dell’acquisizione del documento all’interno del file avviene in differita rispetto all’invio)

2. Inviando un messaggio con i dati di un singolo documento all’interno della request (web service “sincrono”)

3. Inserendo i dati del documento all’interno di una pagina web dedicata all’utente erogatore sul sito www.sistemats.it

In questo documento si tratterà della modalità di realizzazione del web service sincrono per la gestione del documento fiscale. Si precisa che la funzionalità descritta è anche sviluppata con le stesse regole come applicazione web (modalità 3).

http://www.sistemats.it/





20/12/2020

Vers. 1.3

Pag. 5 di 25

3. SERVIZIO PER LA GESTIONE DEL DOCUMENTO FISCALE 730 PRECOMPILATO

L’utilizzo dei web service è rivolto ai soggetti:

1. che sono provvisti di credenziali di accesso al Sistema TS;

2. con credenziali Entratel (intermediari fiscali)

Un documento fiscale può essere gestito attraverso diverse operazioni:

Inserimento (invio per la prima volta al Sistema TS)

Variazione (modifica dei suoi attributi, in caso di rettifica)

Cancellazione (eliminazione dal Sistema TS)

Rimborso (inserimento di un documento che rettifichi gli importi di uno precedentemente inviato - es. note di credito -)

La gestione dei documenti genera per ogni messaggio un numero di protocollo ed un esito dell’invio. E’ possibile interrogare anche successivamente l’esito di un messaggio mediante l’invocazione dell’altro web service (si veda il documento Web Services per la visualizzazione delle ricevute di attestazione degli invii dei documenti di spesa - 730 precompilato ) o tramitre l’applicazione web delle ricevute.





20/12/2020

Vers. 1.3

Pag. 6 di 25

3.1 DESCRIZIONE DEGLI ELEMENTI COMUNI DEI MESSAGGI DI RICHIESTA PER I SERVIZI

DOCUMENTO DI SPESA

Il messaggio da inviare si compone di due parti:

1. Sezione Proprietario. Tale sezione ha una composizione diversa a seconda del soggetto che emette i documenti fiscali attestanti la spesa sanitaria

• Struttura:

- Farmacia,

- Struttura sanitaria (accreditata o autorizzata),

- Struttura specialistica della Sanità Militare,

- Esercizi commerciali autorizzati alla vendita di farmaci (parafarmacie)

- Esercizi commerciali autorizzati alla vendita di dispositivi medici su misura (ottici)

- Farmacia assistenziale ANMIG

• Professionista:

- Medico Chirurgo/Odontoiatra,

- Medico Veterinario,

- Psicologo,

- Infermiere,

- Ostetrica/o,

- Tecnico sanitario di radiologia medica

- Nuovi ordini professioni sanitarie di cui al DM 8 agosto 2018

1. Tecnico sanitario di laboratorio biomedico;





20/12/2020

Vers. 1.3

Pag. 7 di 25

2. Tecnico audiometrista;

3. Tecnico audioprotesista;

4. Tecnico ortopedico;

5. Dietista;

6. Tecnico di neurofisiopatologia;

7. Tecnico fisiopatologia cardiocircolatoria e perfusione

8. Igienista dentale;

9. Fisioterapista;

10. Logopedista;

11. Podologo;

12. Ortottista e assistente di oftalmologia;

13. Terapista della neuro e psicomotricità dell’età evolutiva;

14. Tecnico della riabilitazione psichiatrica;

15. Terapista occupazionale;

16. Educatore professionale;

17. Tecnico della prevenzione nell’ambiente e nei luoghi di lavoro;

18. Assistente sanitario;

19. Biologi

2. Sezione Documento. Tale sezione non varia in base al soggetto emittente.





20/12/2020

Vers. 1.3

Pag. 8 di 25

Nella tabella seguente sono riportate, al fine di favorire una migliore interpretazione dei campi elementari definiti nel file XML da generare, le descrizioni e le regole di compilazione di ciascun elemento.

Tabella 1 Proprietario

Nome campo Descrizione Caratteristiche

codiceRegione Codice regione Codice regione della struttura che emette il documento fiscale (non previsto per il professionista)

codiceAsl Codice asl Codice della ASL della struttura che emette il documento fiscale (non previsto per il professionista)

codiceSSA Codice struttura Codice farmacia/struttura che emette il documento fiscale (non previsto per il professionista)

cfProprietario Codice fiscale del proprietario

Codice fiscale cifrato del soggetto di riferimento della struttura o del professionista

Tabella 2 numDocumentoFiscale


dispositivo Numero progressivo del dispositivo che genera il documento

Per dispositivo si intende il progressivo del registratore di cassa utilizzato dagli





20/12/2020

Vers. 1.3

Pag. 9 di 25


esercenti di beni sanitari che emettono documento commerciale; per l’emissione di fatture o ricevute fiscali il campo assume il valore consigliato = 1

numDocumento Numero identificativo del documento emesso

Univoco nell’ambito della data. E’ univoco per giornata (scontrini) o per anno (fattura)





20/12/2020

Vers. 1.3

Pag. 10 di 25

Tabella 3 idDocumentoFiscale


pIva Partita IVA della farmacia/struttura o medico che emette il documento fiscale

Obbligatorio

dataEmissione Data di emissione del “documento fiscale” relativo alla spesa sostenuta dal cittadino.

Obbligatorio

numDocumentoFiscale Vedi Tabella 2 numDocumentoFiscale

Tipo Complesso

Tabella 4 voceSpesa


tipoSpesa Il Campo assume i seguenti valori:

TK= Ticket (Quota fissa

e/o Differenza con il

prezzo di riferimento.

Franchigia. Pronto

Soccorso e accesso

diretto)

FC= Farmaco, anche

omeopatico. Dispositivi

medici CE

FV = Farmaco per uso

veterinario

AD= Acquisto o affitto

Obbligatorio





20/12/2020

Vers. 1.3

Pag. 11 di 25


di dispositivo medico

CE

AS= Spese sanitarie

relative ad ECG,

spirometria, Holter

pressorio e cardiaco,

test per glicemia,

colesterolo e trigliceridi

o misurazione della

pressione sanguigna,

prestazione previste

dalla farmacia dei

servizi e simili

sanguigna)

SR= prestazioni

sanitarie: assistenza

specialistica

ambulatoriale esclusi

interventi dichirurgia

estetica; visita medica

generica e specialistica

o prestazioni

diagnostiche

estrumentali;

prestazione chirurgica

ad esclusione della

chirurgia

estetica;certificazione

medica; ricoveri

ospedalieri ricollegabili

ad interventi chirurgici

o adegenza, ad





20/12/2020

Vers. 1.3

Pag. 12 di 25


esclusione della

chirurgia estetica, al

netto del comfort

CT= Cure Termali

PI= protesica e

integrativa

IC= Prestazioni di

chirurgia estetica e di

medicina estetica

(ambulatoriale o

ospedaliera)

SP = Prestazioni

sanitarie

SV = Spese veterinarie

AA = Altre spese

flagTipoSpesa Il campo è valorizzato al fine di evidenziare caratteristiche particolari di alcune tipologie di spesa.

Il campo vale:

“1” con tipo TK

(ticket di pronto

soccorso);

“2” con tipo SR (visita in intramoenia)

importo Importo di ogni singola spesa sostenuta dal cittadino / rimborso riconosciuto al cittadino a fronte di una spesa sostenuta.

Il campo deve assumere sempre valori positivi, anche in caso di rimborso

Valore da 5 + 2 decimali

aliquotaIVA Aliquota IVA relativa Impostata in





20/12/2020

Vers. 1.3

Pag. 13 di 25


all’importo della voce di spesa.

alternativa al campo naturaIVA

Valore da 2 + 2 decimali

naturaIVA Codice natura dell'operazione esente IVA.

Impostata in alternativa al campo aliquotaIVA.

Assume valori da N1 a N6 per tipoDocumento = D (2 caratteri)

Assume valori da N1 a N7 o sottovalori per tipoDocumento = F (max 4 caratteri)

Di seguito si rappresentano le possibili tipologie di spesa inviabili dai vari erogatori: INVIANTE Tipo voci di spesa

TK FC FV AD AS SR CT PI IC AA SV SP

Farmacia X X X X X X X

Struttura accreditata pubblica o privata o militare

X X X X X X





20/12/2020

Vers. 1.3

Pag. 14 di 25

Medico o Odontoiatra

X X X

Struttura Autorizzata

X X X X X

Parafarmacia X X X X X X

Farmacia ANMIG

X X X X X X

Ottico X X

Professionista sanitario

X

Veterinario X X X

Sogg. Di cui art. 70

X X





20/12/2020

Vers. 1.3

Pag. 15 di 25

Tabella 5 documentoSpesa


idSpesa Vedi Tabella 3 idDocumentoFiscale

Tipo Complesso

dataPagamento Data di pagamento afferente al “documento fiscale” emesso.

Deve essere coincidente o maggiore rispetto alla data di emissione. Può essere minore rispetto alla data di emissione solo se valorizzato a 1 il flag pagamento anticipato ( e comunque non minore del 01/01/2015)

flagPagamentoAnticipato

Il campo deve essere valorizzato a “1” per indicare il pagamento della spesa sostenuta dal cittadino in data antecedente alla data di emissione del “documento fiscale”

Elemento opzionale

cfCittadino Codice fiscale del cittadino rilevato dalla Tessera Sanitaria

Campo cifrato

Deve essere assente se flagOpposizione = 1

voceSpesa Vedi Tabella 4 voceSpesa Tipo Complesso

pagamentoTracciato Il campo descrive la modalità di pagamento e assume i valori SI/NO

SI : secondo le modalità previste dal comma 679 dell’art. 1 della Legge 160 del 27 /12/2019( legge di





20/12/2020

Vers. 1.3

Pag. 16 di 25

bilancio 2020)

NO: in contanti

tipoDocumento

Tipologia del documento attestante il pagamento della prestazione o del bene sanitario

assume valore:

F (fattura)

D (documento commerciale)

flagOpposizione Indica la volontà del cittadino di non permettere l’invio del dato di spesa all’Agenzia delle entrate ai fini della predisposizione della dichiarazione Precompilata

assume valore

0 = il cittadino NON si oppone

1 = il cittadino si oppone

Tabella 6 messaggi


codice Il campo identificata il codice alla chiamata al servizio

Elemento di 3 caratteri

descrizione Il campo identificata la descrizione alla chiamata al servizio

Stringa di descrizione

tipo Tipologia messaggio di segnalazione

'E’ = errore scartante

‘W’ =warning/segnalazione

‘S’= statistica





20/12/2020

Vers. 1.3

Pag. 17 di 25

3.2 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RICHIESTA PER

L’INVIO DEL DOCUMENTO DI SPESA:


opzionale1 Campo attualmente utilizzato dagli utenti che:

si attestano al Sistema TS con certificato Client (contiene il CODICE IDENTIFICATIVO)

utilizzano le credenziali Entratel (intermediari fiscali: contiene codice fiscale – codice SEDE)

Elemento opzionale

opzionale2 Campo attualmente non utilizzato

Elemento opzionale


Elemento opzionale

pincode Pincode:

dato cifrato in caso di invii effettuati da utente con credenziali del Sistema TS

dato in chiaro per utenti con credenziali Entratel

Campo obbligatorio

Proprietario Vedi Tabella 1 Proprietario Tipo Complesso

idInserimentoDocumentoFiscale

Vedi Tabella 5 documentoSpesa

Tipo Complesso





20/12/2020

Vers. 1.3

Pag. 18 di 25

3.3 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RISPOSTA PER

L’INVIO DEL DOCUMENTO DI SPESA:


esitoChiamata Esito di invocazione del servizio

0 = accolto senza segnalazioni

1 = riscontrato errore bloccante

2 = accolto con segnalazioni

protocollo Numero di 17 cifre identificativo univoco della operazione effettuata

Presente se esitoChiamata 0 o 2

listaMessaggi Contiene la lista dei messaggi

ogni item contiene: codice – descrizione –tipo (vedi tab. 6)

3.4 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RICHIESTA PER LA

VARIAZIONE DEL DOCUMENTO DI SPESA:



Elemento opzionale


Elemento opzionale


Elemento opzionale

pincode Pincode cifrato del soggetto che effettua l’invio telematico

Stringa di tipo base64Binary






20/12/2020

Vers. 1.3

Pag. 19 di 25

idVariazioneDocumentoFiscale

Vedi Tabella 5 documentoSpesa

Tipo Complesso

3.5 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RISPOSTA PER LA

VARIAZIONE DEL DOCUMENTO DI SPESA:









ogni item contiene: codice – descrizione – tipo (vedi tab. 6)

3.6 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RICHIESTA PER LA

CANCELLAZIONE DEL DOCUMENTO DI SPESA:



Elemento opzionale


Elemento opzionale

opzionale3 Campo attualmente non Elemento opzionale





20/12/2020

Vers. 1.3

Pag. 20 di 25

utilizzato




idCancellazioneDocumentoFiscale

Vedi Tabella 3 idDocumentoFiscale

Tipo Complesso

3.7 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RISPOSTA DELLE

PER LA CANCELLAZIONE DEL DOCUMENTO DI SPESA:














20/12/2020

Vers. 1.3

Pag. 21 di 25

3.8 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RICHIESTA PER IL

RIMBORSO DEL DOCUMENTO DI SPESA:



Elemento opzionale


Elemento opzionale


Elemento opzionale




idRimborsoDocumentoFiscale

Vedi tabella 3 Tipo Complesso

DocumentoSpesa Vedi Tabella 5 documentoSpesa

Tipo Complesso

3.9 DESCRIZIONE DEGLI ELEMENTI COSTITUTIVI DEL MESSAGGIO DI RISPOSTA PER IL

RIMBORSO DEL DOCUMENTO DI SPESA:










20/12/2020

Vers. 1.3

Pag. 22 di 25



Presente se esitoChiamata = 0 o 2







20/12/2020

Vers. 1.3

Pag. 23 di 25

4. ENDPOINT A seconda delle credenziali in possesso dell’utente inviante devono essere richiamati differenti endpoint.

Per l’ambiente di test verranno rilasciati diversi set di credenziali, con cui testare i vari casi di invio e di delega.

Eventuali indicazioni o modifiche di endpoint ai fine della fase di test saranno comunicati tempestivamente sul portale www.sistemats.it

4.1 ACCESSO IN BASIC AUTHENTICATION O CERTIFICATO CNS

Questa modalità è rivolta a tutti gli utenti in possesso di credenziali Sis

Ambiente di test:

https://invioSS730pTest.sanita.finanze.it/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

Ambiente di produzione:

https://invioSS730p.sanita.finanze.it/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

4.2 ACCESSO CON CERTIFICATO CLIENT (PER REGIONI O ENTI INVIANTI)

Ambiente di test:

https://invioSS730pTest.sanita.finanze.it/enti/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

Ambiente di produzione:

https://invioSS730p.sanita.finanze.it/enti/DocumentoSpesa730pWeb/DocumentoSpesa730pPort


https://invioss730ptest.sanita.finanze.it/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730ptest.sanita.finanze.it/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730p.sanita.finanze.it/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730p.sanita.finanze.it/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730ptest.sanita.finanze.it/enti/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730ptest.sanita.finanze.it/enti/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730p.sanita.finanze.it/enti/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730p.sanita.finanze.it/enti/DocumentoSpesa730pWeb/DocumentoSpesa730pPort





20/12/2020

Vers. 1.3

Pag. 24 di 25

4.3 ACCESSO CON CREDENZIALI ENTRATEL (PER INTERMEDIARI FISCALI)

In questo ambito, è previsto l’accesso da parte di un soggetto registrato al Servizio Entratel in qualità di intermediario.

In particolare, il soggetto Entratel accede con le proprie credenziali - se persona fisica-, altrimenti è il soggetto incaricato ad operare per suo conto accedendo con le proprie credenziali sempre rilasciate da Agenzia Entrate. I campi della request da inviare sono sempre impostati come da prospetto descrittivo (cfr. tabelle). In particolare in tale caso occorre valorizzare come descritto di seguito i campi:

<opzionale1> : deve contenere “codice fiscale”-“sede telematica” del soggetto intermediario che ha ricevuto delega dal medico per l’invio dei dati di spesa sanitaria.

< pincodeInvianteCifrato> : deve contenere il pincode non cifrato del soggetto intermediario che ha ricevuto delega dal medico per l’invio dei dati di spesa sanitaria come dichiarato nella tabella. Si rammenta che il codice PIN personale da utilizzare si ricava dal Pincode presente nella terza sezione della busta consegnata dall’Agenzia delle Entrate all’atto dell’abilitazione al servizio Entratel, considerandone solamente i primi otto caratteri corrispondenti alle posizioni dispari.

Ambiente di test:

https://invioSS730pTest.sanita.finanze.it/entrate/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

Ambiente di produzione: https://invioSS730p.sanita.finanze.it/entrate/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730ptest.sanita.finanze.it/entrate/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730ptest.sanita.finanze.it/entrate/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730p.sanita.finanze.it/entrate/DocumentoSpesa730pWeb/DocumentoSpesa730pPort

https://invioss730p.sanita.finanze.it/entrate/DocumentoSpesa730pWeb/DocumentoSpesa730pPort





20/12/2020

Vers. 1.3

Pag. 25 di 25

5. SPECIFICHE TECNICHE

Per gli schemi XSD e i WSDL relativi ai servizi descritti in precedenza, si acceda al portale www.sistemats.it per reperire il kit per lo sviluppo reperibile nella sezione Spese Sanitarie / Documenti e specifiche tecniche / Strumenti per lo sviluppo / 730 Spese Sanitarie – Kit per lo sviluppo.


SISTEMA TESSERA SANITARIA

Documents

Transcript of SISTEMA TESSERA SANITARIA