Home · Integrazioni · Sistema Tessera Sanitaria (STS)
Sanità digitale italiana

Sistema Tessera Sanitaria (STS)

L’invio al Sistema Tessera Sanitaria riguarda i dati delle spese sanitarie che confluiscono nella dichiarazione precompilata. Il gestionale seleziona le fatture del periodo e le inoltra al gateway configurato con le credenziali del laboratorio. Serve alle strutture tenute alla comunicazione delle spese.

Credenziali del lab

Cosa fa

Invio dati spese sanitarie.

Categoria: sanità digitale italiana — Adempimenti e interoperabilità con l’ecosistema sanitario nazionale e regionale.

Cosa serve

  • Abilitazione del laboratorio al Sistema Tessera Sanitaria e credenziali rilasciate a suo nome
  • Anagrafiche pazienti con codice fiscale valido
  • Procedura interna per escludere dalla selezione le posizioni in opposizione

Come funziona

Dalla gestione fatture si selezionano le spese del periodo. Il gestionale verifica che ogni documento appartenga alla tua struttura prima di inviarlo.

La trasmissione parte da una rotta server protetta da ruolo, mai dal browser. La chiave del laboratorio viene aggiunta lato server.

Per ogni spesa vengono inoltrati gli estremi del documento e il codice fiscale dell’assistito. L’esito restituito dal gateway viene registrato sulla fattura e nel registro trasmissioni.

Quando serve

A ogni scadenza di trasmissione delle spese sanitarie prevista per le strutture sanitarie private.

Quando vuoi evitare di riconciliare a mano fatture e file da caricare sul portale.

Limiti

Il tracciato completo previsto dal Sistema Tessera Sanitaria comprende tipo spesa, modalità di pagamento e flag operazione. Va concordato e verificato con il gateway o il provider prima dell’uso in produzione.

La gestione dell’opposizione dell’assistito non è automatica: va presidiata a monte, escludendo dalla selezione le posizioni che non devono essere trasmesse.

Non esiste una coda di ritentativi automatica come per lo SdI: un invio fallito va rilanciato dall’operatore.

Senza endpoint configurato la rotta risponde con un errore di configurazione e non viene registrato alcun invio.

Le regole di accettazione e gli scarti restano del Sistema Tessera Sanitaria: il gestionale non può garantirne l’esito.

Come si attiva

Se ne occupa chi installa LabBox: il vostro tecnico informatico oppure noi.

Per il tecnico
  • `STS_ENDPOINT` — indirizzo del gateway (è ancora accettato il nome storico `NEXT_PUBLIC_STS_ENDPOINT`)
  • `STS_API_KEY` — chiave del laboratorio
  1. Verifica le abilitazioni del laboratorio al Sistema Tessera Sanitaria.
  2. Concorda con il gateway o il provider il tracciato atteso e i campi obbligatori.
  3. Imposta `STS_ENDPOINT` e `STS_API_KEY` con i valori forniti.
  4. Controlla che le anagrafiche abbiano codice fiscale valido.
  5. Esegui una trasmissione di prova su un periodo limitato e verifica gli esiti restituiti.
  6. Definisci la procedura di esclusione delle posizioni in opposizione prima del primo invio reale.

Domande frequenti

Le credenziali le fornisce il fornitore del software?

No. Sono rilasciate al laboratorio come soggetto obbligato alla comunicazione.

Cosa succede se un paziente si oppone?

La sua posizione va esclusa dalla selezione prima dell’invio. Il gestionale non applica da solo un filtro di opposizione.

Se non configuro l’integrazione posso comunque adempiere?

Sì, con il caricamento manuale sul portale. Il gestionale non simula invii che non sono avvenuti.

Vuoi vedere Sistema Tessera Sanitaria (STS) collegato al tuo laboratorio?

Entra nella demo con dati di esempio, senza registrarti.

← Tutte le integrazioni