Interfaccia UPIServices
UPIServices è un pacchetto di servizi che permette a un’applicazione informatica di interagire con la banca dati UPI.
Questi servizi consentono di:
- interrogare UPI sulla base di un numero AVS o degli attributi identificativi;
- informarsi sulle mutazioni di UPI avvenute in un determinato periodo, ad esempio i cambiamenti di stato del numero AVS, le persone che hanno cambiato nome oppure i decessi (servizio denominato broadcast delle mutazioni);
- ottenere in autonomia il numero AVS interrogando la banca dati UPI e introdurlo in massa nel registro di persone di un’organizzazione;
- confrontare un registro di persone con il contenuto di UPI, segnalando le differenze rilevate negli attributi identificativi.
L’attivazione di questi servizi in un’applicazione informatica richiede specifici lavori di programmazione e quindi l’intervento di sviluppatori software.
Per ottenere l’accesso all’applicazione, l’organizzazione di appartenenza deve essere riconosciuta come USN. Inoltre, deve aver designato un RUSN, che fornisce e gestisce i diritti di accesso. Maggiori informazioni sono disponibili alla pagina seguente: /link pagina USN/. Una volta soddisfatte queste condizioni, è possibile presentare una richiesta di accesso a UPIServices tramite USNTools.
La versione 1 di UPIServices non è più supportata dal 31 dicembre 2025.
Da quella data non viene fornita alcuna garanzia di disponibilità, stabilità o sicurezza alle istituzioni che utilizzano ancora questa versione.
Le istituzioni che non hanno effettuato la migrazione alla versione 2 rischiano un'interruzione immediata e definitiva del servizio, senza possibilità di tornare indietro.
La migrazione alla versione 2 di UPIServices è obbligatoria.
Le istituzioni che utilizzano ancora la versione 1 devono incaricare immediatamente il proprio fornitore di servizi IT di avviare la migrazione per garantire la continuità delle loro attività. La cessazione definitiva dei servizi UPI v1 è infatti fissata per il 15.11.2026 e non sarà concessa alcuna proroga.
La responsabilità di qualsiasi interruzione legata alla mancata migrazione ricade interamente sull'istituzione in questione e sul suo fornitore di servizi IT.
Di seguito trovate il link alla documentazione della nuova versione:
eCH-0085 UPI Query Interface V2.0.0 | eCH E-Government Standards
Specifiche tecniche di UPIServices
La comunicazione con UPI attraverso UPIServices avviene tramite messaggi in formato XML. La sintassi di questi messaggi è definita mediante documenti denominati «schemi XML», espressi nel linguaggio tecnico XSD (XML Schema Definition).
Gli schemi dedicati al funzionamento di UPI sono stati riconosciuti dall’associazione eCH (www.ech.ch) e pienamente integrati negli standard di e-government. I numeri eCH attribuiti a questi schemi sono:
- annuncio (scrittura) a UPI: eCH-0084;
- interrogazione (lettura) di UPI: eCH-0085;
- confronto (lettura) con UPI: eCH-0086;
- annunci di mutazioni in UPI presso terzi (broadcast): eCH-0212.
Le ultime versioni integrate degli schemi eCH0084, eCH0085, eCH0086 e dei WSDL sono disponibili di seguito. Sono inoltre disponibili alcuni esempi di messaggi XML.
Il seguente documento descrive le tre interfacce applicative basate sul protocollo Request/Response orientato ai messaggi, implementate dal sistema UPI.
L’ultima versione dello schema eCH0212 e della relativa documentazione è disponibile sul sito dell’associazione eCH.
Il seguente manuale d’uso, la cui lettura è obbligatoria per utilizzare i servizi, riguarda diversi aspetti del prodotto UPI e della gestione del numero AVS.