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 1 des UPIServices est hors support depuis le 31 décembre 2025.
Depuis cette date, aucune garantie de disponibilité, de stabilité ou de sécurité n’est assurée pour les institutions qui utilisent encore cette version.
Les institutions qui n’ont pas migré vers la version 2 s’exposent à une coupure immédiate et définitive du service, sans retour arrière possible.
La migration vers la version 2 des UPIServices est obligatoire.
Les institutions qui utilisent encore la version 1 doivent mandater immédiatement leur prestataire IT afin de lancer la migration et de garantir la continuité de leurs activités.
La responsabilité de toute interruption liée à l’absence de migration incombe entièrement à l’institution concernée et à son prestataire IT.
Vous trouverez ci-dessous le lien vers la documentation de la nouvelle version :
eCH-0085 UPI Query Interface V2.0.0 | eCH E-Government Standards
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.
Le manuel d’exploitation ci-dessous, obligatoire à lire pour utiliser les services, couvre plusieurs aspects d’UPI et de la gestion du numéro AVS.