Interface UPIServices
UPIServices est un bouquet de services permettant à une application informatique d’interagir avec la base de données UPI.
Ces services permettent :
- D’interroger UPI sur la base d’un numéro AVS ou de données d’identification
- D’informer sur les mutations dans UPI durant une période donnée, comme les changements de statut de numéros AVS, les personnes ayant changé de nom ou les décès survenus (broadcast des mutations).
- D’obtenir en tout autonomie le numéro AVS en interrogeant la base de données UPI et de l’introduire en masse dans le registre de personnes d’une organisation
- De comparer un registre de personnes avec le contenu d’UPI et de recevoir les différences constatées dans les données d’identification en retour.
Pour obtenir un accès à l’application, votre organisation doit d’abord être reconnue comme USN et avoir désigné un RUSN. Le RUSN pourra donner et gérer les droits d’accès. Vous trouverez plus d’information sous Utilisation systématique du numéro AVS. Une fois ces conditions remplies, vous pourrez faire une demande d'accès à UPIServices via USNTools.
La version 2 des UPIServices est disponible depuis le 1er janvier 2024. La version 1 des UPIServices a été abandonnée au 31 décembre 2025. Les institutions qui utilisent encore la version 1 des UPIServices doivent entreprendre les travaux pour migrer à la version 2 avant ce délai. Vous trouverez plus d’information dans les documents et liens ci-dessous.
Spécifications techniques des UPIServices
La communication avec UPI au travers des UPIServices s'opère à l'aide de messages au format XML. La syntaxe de ces messages est définie au moyen de documents dits « schémas XML », exprimés dans le langage technique XSDL (XML Schema Definition Language).
Les schémas dédiés au fonctionnement d'UPI ont été reconnus par l'association eCH (www.ech.ch) et intègrent pleinement les standards reconnus en matière d'e-government. Les numéros eCH attribués à ces schémas sont :
- Annonce (écriture) à UPI : eCH-0084
- Interrogation (lecture) d'UPI : eCH-0085
- Comparaison (lecture) avec UPI : eCH-0086
- Annonces de mutations dans UPI à des tiers (broadcast) : eCH-0212
Les dernières versions intégrées des schémas eCH-0084, eCH-0085, eCH-0086 et des WSDL sont disponibles ci-dessous. Vous y trouverez également quelques exemples de messages XML.
La description des trois interfaces d'applications basées sur un protocole Request/Response orienté messages que le système UPI implémente est disponible dans le document ci-dessous.
La dernière version du schéma eCH-0212 et la documentation qui l’accompagne sont disponibles sur le site de l’association eCH.