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 2 di UPIServices è disponibile dal 1° gennaio 2024. La versione 1 di UPIServices è stata dismessa il 31 dicembre 2025. Maggiori informazioni sono disponibili nei documenti e ai link seguenti.
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.