Schnittstelle UPIServices
UPIServices ist ein Dienstleistungspaket, das es einer IT-Anwendung ermöglicht, mit der UPI-Datenbank zu interagieren.
Diese Dienstleistungen ermöglichen es:
- UPI anhand der AHV-Nummer oder mithilfe von Identifikationsdaten abzufragen;
- Informationen über Mutationen in UPI während eines bestimmten Zeitraums zu erhalten, wie z. B. Statusänderungen der AHV-Nummer, Namensänderungen von Personen oder Todesfälle (Broadcast der Mutationen);
- AHV-Nummern durch Abfragen der UPI-Datenbank selbstständig zu ermitteln und diese massenhaft in das Personenregister einer Organisation zu übernehmen;
- ein Personenregister mit dem Inhalt von UPI abzugleichen und die festgestellten Unterschiede in den Identifikationsdaten anzeigen zu lassen.
Die Umsetzung dieser Dienstleistungen erfordert eine entsprechende Programmierung und damit den Beizug von Softwarefachleuten.
Um Zugang zur Applikation zu erhalten, muss Ihre Organisation als SBN registriert sein und eine VSBN ernannt haben. Die VSBN erteilt und verwaltet die Zugriffsrechte. Weitere Informationen finden Sie unter Systematische Verwendung der AHV-Nummer. Sobald diese Bedingungen erfüllt sind, können Sie den Zugang zu UPIServices über USNTools beantragen.
Version 2 der UPIServices ist seit dem 1. Januar 2024 verfügbar. Version 1 der UPIServices wurde am 31. Dezember 2025 eingestellt. Weitere Informationen dazu finden Sie in den nachstehenden Dokumenten und Links.
Technische Spezifikationen der UPIServices
Der Datenaustausch mit UPI über UPIServices erfolgt mittels Meldungen im XML-Format. Die Syntax dieser Meldungen wird in Dokumenten (den sogenannten «XML-Schemas») definiert, die die technische Sprache XSD (XML Schema Definition) verwenden.
Die für den Betrieb von UPI vorgesehenen Schemas wurden vom Verein eCH (www.ech.ch) homologiert und entsprechen vollumfänglich den für das E-Government anerkannten Standards. Diesen Schemas wurden folgende eCH-Nummern zugeteilt:
- Meldung (Schreibzugriff) an das UPI: eCH-0084
- Abfrage (Lesezugriff) des UPI: eCH-0085
- Vergleich (Lesezugriff) mit dem UPI: eCH-0086
- Mutationsmeldungen UPI an Dritte (Broadcast): eCH-0212
Nachstehend befinden sich die neuesten integrierten Versionen der Schemas eCH0084, eCH0085, eCH0086 sowie der WSDL. Zudem finden Sie hier einige Beispiele für XML-Nachrichten.
Die drei vom UPI-System angebotenen Applikationsschnittstellen, die auf einem meldungsorientierten Request/Response-Protokoll basieren, werden im folgenden Dokument beschrieben:
Die neueste Version des Schemas eCH0212 sowie die dazugehörige Dokumentation sind auf der Website des eCH-Vereins verfügbar.