Sistema Tessera Sanitaria

Invio spese sanitarie al MEF (precompilata 730)

v 2.2April 2026Certificato

1Panoramica Sistema TS

🔑 Visibilità condizionata (certificazione v 2.2) — Questo modulo è accessibile solo se:
• Pacchetto SISTEMA_TS attivo sul workspace (configurabile da SUPERADMIN in /admin/pacchetti)
• Profilo attività compatibile: SOLO Studio Medico, Studio Dentistico, Farmacia (professionisti sanitari — DM 31/07/2015)
• Permesso utente abilitato in Modifica Utente → Moduli
I tre livelli si applicano in intersezione. Dettagli completi in Gerarchia Pacchetti+Profilo+Utente.

Il Sistema Tessera Sanitaria è il portale del MEF/Sogei attraverso cui i professionisti sanitari inviano le spese sanitarie dei propri clienti per la precompilata 730. Modulo NOX gestisce:

Configurazione: CF inviante, PIN, certificato, profilo (PF=persona fisica, PG=persona giuridica)
Opposizioni paziente (art. 3 DM 31/07/2015): registra la volontà del paziente di NON inviare al TS specifiche prestazioni
Preparazione invio: genera XML schema TS escludendo i documenti con opposizione
Tracciabilità: hash SHA-256 dell'XML + log di ogni operazione

⚠L'invio effettivo al portale MEF richiede certificato digitale abilitato e non è ancora automatizzato. Il sistema fornisce XML + hash e consente la conferma manuale dell'invio con la risposta ricevuta dal MEF.

2Configurazione Sistema TS

Endpoint: GET /api/sistema-ts/config | PUT /api/sistema-ts/config (ADMIN)

Campi configurabili:

codiceFiscaleInviante: CF dell'ente che invia (professionista o studio)
pincode: PIN assegnato da Sogei per l'autenticazione
profilo: PF (persona fisica) o PG (persona giuridica)
stato: DISATTIVO (default) / ATTIVO / TEST
note: annotazioni interne

⚠Il PIN è dato sensibile: va conservato in forma cifrata. Nell'audit log compare mascherato.

3Opposizioni paziente (art. 3 DM 31/07/2015)

Il paziente può esercitare il diritto di opposizione alla trasmissione delle sue spese sanitarie al Sistema TS. L'opposizione può essere:

Generica: vale per tutte le spese del soggetto
Puntuale: vale solo per uno specifico documento (specificando documentoId)

Registrare un'opposizione

Endpoint: POST /api/sistema-ts/opposizioni
Body: { soggettoId, documentoId?, tipoOpposizione: "GENERICA"|"PUNTUALE", motivazione, dataOpposizione }
La motivazione è obbligatoria e deve riferirsi alla richiesta scritta del paziente.

Revoca

Endpoint: DELETE /api/sistema-ts/opposizioni/:id (ADMIN). Elimina l'opposizione (l'evento è comunque tracciato in log_sistema_ts).

4Preparazione invio annuale

Endpoint: POST /api/sistema-ts/prepara-invio (ADMIN)

Body: { anno: 2026, periodo?: "Q1" }

Il sistema:

Carica tutti i documenti con stato EMESSO per l'anno indicato
Esclude i documenti con opposizione generica del soggetto
Esclude i documenti con opposizione puntuale
Genera l'XML schema TS v4.x (semplificato per validazione formale)
Calcola l'hash SHA-256 del contenuto come prova immutabilità
Salva il record in stato PRONTO_INVIO: documenti inclusi, esclusi, totale spese

ⓘIl risultato è visibile in GET /api/sistema-ts/invii. L'XML si può scaricare con GET /api/sistema-ts/invii/:id/xml.

5Conferma invio manuale

Dopo aver inviato manualmente l'XML al portale MEF (o tramite provider certificato esterno), registrare la conferma con:

PATCH /api/sistema-ts/invii/:id/conferma-inviato con body { rispostaMef: "<testo ricevuta MEF>" }

Lo stato del record passa a INVIATO con data/ora e operatore registrati. L'evento resta nei log log_sistema_ts.

⚠L'integrazione automatica con il portale MEF richiede implementazione aggiuntiva (certificato digitale + libreria SOAP/REST). In roadmap v 2.3.

6Log operazioni

Ogni operazione sul modulo Sistema TS è registrata in log_sistema_ts con evento + dettagli + utente.

Eventi tracciati:

CONFIG_UPDATE: modifica configurazione (ADMIN)
OPPOSIZIONE_REGISTRATA: nuova opposizione del paziente
PREPARA_INVIO: preparazione XML annuale
CONFERMA_INVIATO: conferma manuale dell'avvenuto invio

Consultabile con GET /api/sistema-ts/log.