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 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.