Smileline
Settings

Sistema TS

Report paid Italian invoices to the Sistema Tessera Sanitaria for the patient's pre-filled tax return.

This page is for practices in Italy. A practice in another country does not see it, and the API refuses Sistema TS requests from one.

Settings → Sistema TS connects an Italian practice to the Sistema Tessera Sanitaria healthcare-expense service. Every paid invoice is reported once, each refund of its payments is reported as a refund of that invoice, and a voided invoice is cancelled, so the practice meets its yearly obligation without exporting a file.

Connect

Owners and managers enter the practice's Sistema TS username (the codice fiscale the service knows the user by), password and pincode, pick Test or Production, and, when the documents belong to a proprietario other than the user, that person's codice fiscale. The credentials are encrypted at rest and never shown again; Replace credentials starts a new set. Documents are keyed on the practice's partita IVA from Settings → Practice → Fiscal identity, the invoice number and its date, and the dispositivo (1 unless the practice issues from several devices).

What is reported

Each night, every issued Italian invoice whose charges are fully settled by payments becomes a submission: the payment date, the patient's codice fiscale, the amounts by expense type (SR for treatment, AD for goods) with the VAT nature or rate, and whether every payment was traceable (anything but cash). Write-offs, discounts and reversed payments settle nothing STS can report. Click Report paid invoices now to run that pass immediately.

Once an invoice has been acquired, each refund of the payments that settled it is reported as a refund of that invoice, for the refunded amount, on the refund's date and with its own traceability. Each refund is a document of its own, numbered after the invoice (12/2026/R1, /R2, …), so two refunds of one invoice — even equal, on the same day — stay distinct at the service; a refund keeps its number for good. Its amounts continue across the invoice's expense buckets from where the earlier refunds stopped. A refund of a payment that settled several invoices is split across them in the order the payment was applied, so every cent is reported once. An invoice that was paid and then credited before it was ever reported is still reported as paid, and its refunds follow. A credit note alone — or money left as credit on the account — reports nothing. A synced invoice that its practice-management system voids is cancelled; a credited invoice is never cancelled, because its refunds are reported instead. A refund that is reversed on the ledger after the service acquired it is cancelled under the number the service holds.

A patient who has exercised their right to oppose reporting has their documents reported without a codice fiscale, flagged as opposed. A patient with neither a codice fiscale nor an opposition, or a practice without a partita IVA, opens one task naming the gap; the document is reported as soon as it is closed.

Attempts and answers

Each submission is carried within the minute. The service's answer is kept in full; an acquired document shows its protocollo, a refused one shows the service's codes and opens a task, and an outage or a replaced credential set parks the attempt and retries it with a growing pause. Nothing is dropped and no attempt limit applies. A refused document is not forgotten: correct what the service objected to — the patient's codice fiscale, or the proprietario and codes on this page — and the next pass reports it again as a new submission.

The yearly deadline is 31 January for the previous year's documents (with a seven-day window for corrections). Connect before the year ends so every paid invoice has been acquired; the list on this page is the practice's evidence.

On this page