Interfaccia UPIServices

UPIServices è un pacchetto di servizi che permette a un’applicazione informatica di interagire con la banca dati UPI.

Questi servizi consentono d’interrogare UPI sulla base di un numero AVS o, in alternativa, utilizzando i consueti attributi identificativi. Inoltre permettono di informarsi sulle mutazioni di UPI avvenuti in un determinato periodo, come per esempio i cambiamenti di stato del NAVS13, le persone ce hanno cambiato il nome oppure sul decesso di una persona. Infine consentono il confronto globale di 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 lavori di programmazione specifici e quindi l’intervento di sviluppatori software.

Richiesta di accesso

Prima di qualsiasi richiesta di accesso individuale a UPIServices, l’organizzazione di cui si fa parte deve obbligatoriamente essere riconosciuta dall’Ufficio centrale di compensazione (UCC) come utente sistematico del NAVS13 nel campo d’attività per il quale utilizzerete il NAVS13. Pertanto occorre verificarne lo stato consultando l’elenco degli utenti sistematici del NAVS13. Se l’organizzazione non figura nell’elenco oppure e dichiarata sotto un’altra attività, la persona dell’organizzazione autorizzata a eseguire tale procedura (solitamente un membro della direzione) deve compilare online l’iscrizione all’uso sistematico del NAVS13. Riempite queste condizioni, è possibile presentare una richiesta di accesso a UPIServices completando il modulo qui di seguito e inviandolo via e-mail a upi_support@zas.admin.ch.

Modalità di utilizzo :

Il servizio di broadcast delle mutazioni in UPI è disponibile unicamente nella modalità asincrono attraverso Sedex (un servizio di scambio di dati sicuro proposto dall’ufficio federale della statistica (OFS)

Gli altri servizi possono essere sfruttati secondo i presenti due modi d’uso:

  • Modo sincrono, dedicato all'interrogazione singola e richiedente una risposta immediata da parte dell'applicazione cliente.

  • Modo asincrono, dedicato alle consultazioni di massa. A partire da un volume di oltre 100 interrogazioni consecutive l'uso del Batch è obbligatoria.
Illustrazione dei modi di uso degli UPIServices

Condizioni per l'uso di UPIServices

Gli utenti di UPIServices devono imperativamente rispettare le seguenti regole d'uso:

Mode sincrono

Modo di trattamento « in tempo reale » per l'interrogazione puntuale e richiedente una risposta immediata dall'applicazione cliente. Questo modo è sottoposto alle seguenti restrizioni :

a) In caso di richieste multiple, queste ultime devono essere serializzate: si deve aspettare la risposta della richiesta numero N prima di trasmettere la richiesta numero N+1.

b) Devono essere interrogate / ricercate / confrontate non più di 30 persone al minuto (tolleranza di 10). Per esempio, in caso di richieste a raffica, contenente una persona per richiesta, questa restrizione può essere implementata semplicemente introducendo un tempo d'inattività da 1.5 a 2 secondi tra due richieste consecutive.

c) Nel corso dell'anno civile, il numero totale delle richieste non deve superare di 12 volte la le dimensioni della vostra "banca dati cliente". Per quanto possibile, le richieste devono essere ripartite uniformemente su tutto l'anno.

L'uso del modo sincrono esige il rispetto congiunto dei punti a)+b)+c). Se tale clausola non fosse possibile, è obbligatorio utilizzare il modo differito (asincrono).

Modo asincrono

Modo di trattamento differito, per le consultazioni di massa. Questo modo è sottoposto alla seguente restrizione :

Senza un preliminare accordo da parte della CdC (contattare il servizio di assistenza ai clienti UPI), il volume totale sottoposto nell'arco di 24 ore non deve eccedere le 300'000 richieste.

Inoltre, l'UCC formula le seguenti raccomandazioni per il modo asincrono:

a) La dimensione del lotto non deve eccedere le 1'000'000 richieste.

b) Nel caso particolare dell'operazione listOfSearchPerson del servizio che implementa la norma eCH-0085 la dimensione del lotto non deve eccedere le 10'000 richieste.

Lo scopo di queste raccomandazioni è di evitare dei problemi che potrebbero sorgere nella manipolazione di grandi schedari e di garantire un tempo di trattamento ragionevole.


Specificazioni tecniche

La comunicazione con UPI attraverso gli UPIServices avviene tramite messaggi in formato XML. La sintassi di questi messaggi è definita per mezzo di documenti detti «schemi XML» espressi nel linguaggio tecnico XSDL (XML Schema Definition Language).

Gli schemi dedicati al funzionamento dell'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, eCH-0086 e WSDL sono disponibili qui di seguito.

Il seguente documento descrive le tre interfacce di applicazione basate sul protocollo Request/Response orientato ai messaggi che il sistema UPI implementa.

L’ultima versione dello schema eCH-0212 e della documentazione che l’accompagnano sono disponibili sul sito dell’associazione eCH.

Caratteristiche degli UPIServices

La tabella riportata qui di seguito descrive le caratteristiche dei servizi UPI disponibili in modalità sincrona. I tre servizi di base di UPI (annuncio, interrogazione e confronto) sono articolati in cinque varianti a secondo del tipo di rete utilizzato (interno o esterno a quello della Confederazione).

Nome
eCH
Sedex
wsproxy
Mirror

 UPI eCH-0084 Master Certif

 84 X (1)  

 UPI eCH-0085 Master Certif

 85 X  

 UPI eCH-0086 Master Certif

 86 X  

 UPI eCH-0085 Mirror Certif

 85 X X

 UPI eCH-0086 Mirror Certif

 86 X X

(1) Necessita una configurazione speciale che può essere richiesta al seguente indirizzo e-mail: upi_support@zas.admin.ch.

Oltre tutto, due servizi sono proposti per permettere lo scambio dei documenti con UPI attraverso un canale sedex (tramite l’intermediario della rete interna della confederazione o tramite l’intermediario di una rete esterna), in modalità asincrono.

 Nome

eCH

Sedex ID

Mirror

 UPI Daemon Master

84,85,86

(T)3-CH-24

 

 UPI Daemon Mirror

85,86 (T)3-CH-3 X

Il servizio di broadcast delle mutazioni in UPI sono disponibili unicamente in modo asincrono tramite Sedex.

Descrizione delle colonne:

 
  • Nome: indica il nome del servizio.
  • eCH: contiene la lista delle norme eCH implementate dal servizio (per esempio 84 significa che la norma eCH-0084 è implementata).
  • Sedex wsproxy: una crocetta in questa colonna indica che il servizio può essere raggiunto tramite il wsproxy fornito con sedex. Per facilitare la gestione dei certificati, la UCC raccomanda l’uso del wsproxy.
  • Sedex-ID: Nel caso di servizi asincroni in cui la trasmissione di dati avviene tramite la piattaforma sedex, questa colonna indica l'ID sedex del destinatario da includere nel messaggio sedex inviato a questo servizio.
  • Mirror: una crocetta in questa colonna indica che il servizio accede a una banca dati mirror sincronizzata ogni notte (tra le 5 e le 6 del mattino circa) sulla banca dati master dell'UPI. Storicamente si trattava della sola banca dati accessibile da una rete esterna a quella della Confederazione. Tuttavia, a seguito di un adeguamento tecnico che consente ai clienti esterni alla rete della Confederazione di accedere direttamente alla base di riferimento, la base mirror sarà abbandonata a termine. Non sarà concesso alcun nuovo accesso.

Procedura per l'aggiornamento dei certificati server

Poiché i certificati hanno una durata limitata, è necessario sostituirli periodicamente. Ciò concerne sia i certificati utilizzati dai clienti sia quelli installati sul server che ospita i web service. Nella tabella riportata qui di seguito troverete la data di scadenza dei diversi certificati server. I clienti che desiderano ricevere il nuovo certificato devono richiederlo presso upi_news@zas.admin.ch. La gestione dei certificati client del tipo sedex è descritta nella documentazione relativa a sedex.

Certificato server di produzione

Nome

Data
di scadenza

Numero 
de serie attuale

UPI eCH-0084 Master Certif

22.08.2019

‎‎38:AD:31:EC:BB:C7:36:30:6D:0A: 3A:38:FA:88:29:8A

UPI eCH-0084 Master USR

28.08.2019

1F:5D:C7:D5:69:01:91:52:77:77: 4F:7E:8D:77:04:60

 UPI eCH-0085 Master Certif

22.08.2019

10:52:76:79:25:9D:4D:32:07:25: 3B:92:3F:A6:3E:D3

UPI eCH-0085 Master USR

28.08.2019

‎1F:5D:C7:D5:69:01:91:52:77:77: 4F:7E:8D:77:04:60

UPI eCH-0086 Master Certif

22.08.2019

10:52:76:79:25:9D:4D:32:07:25: 3B:92:3F:A6:3E:D3

UPI eCH-0086 Master USR

28.08.2019

1F:5D:C7:D5:69:01:91:52:77:77: 4F:7E:8D:77:04:60

UPI eCH-0085 Mirror Certif

22.08.2019

5A:A4:C9:78:FE:AB:A0:0B:71:B9: 7E:BD:13:C3:CF:33

UPI eCH-0085 Mirror USR

22.08.2019

27:3C:AF:28:70:7C:52:84:84:07: 73:31:FE:C1:DA:88

UPI eCH-0086 Mirror Certif

22.08.2019

‎5A:A4:C9:78:FE:AB:A0:0B:71:B9: 7E:BD:13:C3:CF:33

UPI eCH-0086 Mirror USR

22.08.2019

27:3C:AF:28:70:7C:52:84:84:07: 73:31:FE:C1:DA:88

UPI WUPIFT

22.08.2019

27:3C:AF:28:70:7C:52:84:84:07: 73:31:FE:C1:DA:88

Certificato server di test

Nome Data
di scadenza
Numero
de serie attuale
UPI eCH-0084 Master Certif  25.08.2019 2E:D8:E6:12:7A:2C:C4:1A:3F:15:
0D:92:23:6A:AD:85
UPI eCH-0084 Master USR  28.08.2019 43:A7:BE:87:34:C0:68:39:5F:39:
68:12:ED:0C:B4:C8
 UPI eCH-0085 Master Certif  22.08.2019 32:E8:B9:AA:C7:25:BD:35:D6:70:
EB:CB:3D:F1:94:06
UPI eCH-0085 Master USR  28.08.2019 43:A7:BE:87:34:C0:68:39:5F:39:
68:12:ED:0C:B4:C8
 UPI eCH-0086 Master Certif  22.08.2019 32:E8:B9:AA:C7:25:BD:35:D6:70:
EB:CB:3D:F1:94:06
UPI eCH-0086 Master USR  28.08.2019 43:A7:BE:87:34:C0:68:39:5F:39:
68:12:ED:0C:B4:C8
UPI eCH-0085 Mirror Certif  24.08.2019 53:D9:CA:B1:CE:91:39:1B:61:5A:
A4:A8:20:19:4F:0E
UPI eCH-0085 Mirror USR  25.08.2019 7D:63:3F:70:9D:E5:9A:65:E9:19:
BC:04:06:08:83:93
UPI eCH-0086 Mirror Certif  24.08.2019 53:D9:CA:B1:CE:91:39:1B:61:5A:
A4:A8:20:19:4F:0E
UPI eCH-0086 Mirror USR  25.08.2019 7D:63:3F:70:9D:E5:9A:65:E9:19:
BC:04:06:08:83:93
UPI WUPIFT  25.08.2019 7D:63:3F:70:9D:E5:9A:65:E9:19:
BC:04:06:08:83:93

Il rinnovo del certificato server non riguarda le seguenti categorie di utilizzatori degli UPIServices:

  • utilizzatori che passano unicamente tramite sedex o per il wsproxy di sedex
  • utilizzatori che passano tramite un client SOAP che non verifica esplicitamente una caratteristica del certificato modificato (per esempio la firma digitale) al momento di un rinnovo del certificato.

Ultima modifica 29.04.2019

Inizio pagina

https://www.zas.admin.ch/content/zas/it/home/partenaires-et-institutions-/unique-person-identification--upi-/upiservices.html