Informatica

Sistema Ts, le specifiche Web Service per i Data Matrix su ricette rosse Ssn

È disponibile il documento tecnico dedicato ai Web Service per le operazioni di dispensazione dei Data Matrix dei farmaci relativi alle ricette rosse non dematerializzate a carico del Ssn.


Il Sistema tessera sanitaria ha reso disponibile, il 30 ottobre 2026, la versione 1.0.0 del documento tecnico dedicato ai Web Service per le operazioni di dispensazione dei Data Matrix dei farmaci relativi alle ricette rosse non dematerializzate a carico del Servizio sanitario nazionale. Il testo ha recepito quanto previsto dal Regolamento Ue 2016/161, attuato nell’ordinamento italiano tramite il Decreto Legislativo n. 10 del 6 febbraio 2025, che integra la Direttiva 2001/83/Ce introducendo l’obbligo di serializzazione e di sistemi di sicurezza sui medicinali per uso umano, in coerenza con gli standard europei di contrasto alla contraffazione.

Soggetti coinvolti nelle operazioni

A definire i dati obbligatori da inserire nel codice GS1 Data Matrix, secondo lo standard Iso/Iec 16022:2006, è stato il Decreto Ministeriale 6 marzo 2025, pubblicato in Gazzetta Ufficiale n. 84 del 10 aprile 2025, in attuazione dell’articolo 3, comma 3 del D.Lgs. 10/2025. La tracciabilità dei codici è assicurata dalla Banca Dati nazionale degli identificativi univoci, gestita da Nmvo Italia in collaborazione con l’Istituto poligrafico e zecca dello Stato e interconnessa con l’Hub europeo di verifica. I soggetti abilitati a operare sui servizi descritti sono le farmacie e i Sistemi di Accoglienza Regionali e Provinciali che agiscono per loro conto.

Servizi e validità temporale

Il documento descrive il flusso di dispensazione dei Data Matrix: l’erogatore scansiona il codice presente sulla confezione e il gestionale invoca il servizio di dispense verso il Sistema Ts, in caso di esito positivo il codice assume lo stato di in decommissioning e viene restituito il token autorizzativo, la cui validità massima è di 24 ore. Trascorse 240 ore lo stato diventa decommissioned e non è più possibile annullare l’operazione, mentre entro tale termine è prevista la possibilità di procedere con l’annullamento tramite l’operazione undodispense.

Scenari di continuità operativa

Per garantire la continuità operativa in caso di indisponibilità dei sistemi, il documento ha individuato quattro scenari gestiti dal Concentratore: lo scenario S0, relativo al completamento ordinario dell’operazione, lo scenario S1, in presenza di errore tecnico o indisponibilità del sistema Nmvs, che consente comunque all’erogatore di completare la cessione del farmaco salvando localmente l’operazione per un successivo reinvio, lo scenario S2 Warning, in cui l’erogazione è consentita esclusivamente durante il periodo transitorio nonostante un alert classificato come Warning, senza attività di riconciliazione prevista, e lo scenario S2 Bloccante, che impedisce la consegna della confezione interessata. Per quest’ultimo scenario, il testo ha indicato la selezione di una confezione alternativa e l’eventuale avvio delle procedure di investigazione previste tramite Iff. Per ogni erogazione devono essere registrati il codice ricetta Rur, i Data Matrix dispensati, il token associato, data e ora dell’operazione e gli esiti restituiti dai sistemi coinvolti.

Regole tecniche sui tracciati

In aggiunta ai servizi di dispensazione e annullamento multiplo, applicabili a liste di massimo 50 Data Matrix per ogni codice ricetta, il documento descrive il servizio Reportcsv, che consente alle sole farmacie di ottenere, a partire dalle ore 22:00, l’archivio con le operazioni compiute in un determinato periodo su base mensile. Le richieste di dispensazione e annullamento devono contenere dati obbligatori quali il codice Pin criptato tramite il certificato Sanitelcf.cer, i codici di regione, Asl e struttura erogatrice e il codice della ricetta rossa, strutturato con codice regione, anno di produzione, Rur, numero della ricetta e checkdigit. Per Reportcsv sono richiesti il Pin, i codici di regione, Asl e struttura erogatrice e l’indicazione dell’anno e del mese di riferimento.

Servizi attualmente invocabili per i farmaci italiani

Viene specificato che, allo stato attuale, i servizi sono invocabili esclusivamente per i farmaci italiani identificati dall’Application Identifier 716 del Data Matrix, e che le regole integrano quanto già previsto dall’allegato tecnico al Decreto 2 novembre 2011 sulla dematerializzazione della ricetta medica cartacea, pubblicato in Gazzetta Ufficiale n. 264 del 12 novembre 2011. Le strutture dati complete, comprensive degli elementi comuni alle diverse operazioni, sono definite tramite linguaggio Wsdl e rese disponibili in un’apposita sezione del portale Sts, a cui gli sviluppatori dei gestionali di farmacia devono fare riferimento per l’implementazione tecnica dei servizi descritti nel documento.

Si rimanda al paper integrale nella sezione “Documenti allegati”.

© Riproduzione riservata