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.
Die Version 1 der UPIServices wird seit dem 31. Dezember 2025 nicht mehr unterstützt.
Seit diesem Datum wird Institutionen, die diese Version noch nutzen, keine Garantie mehr für Verfügbarkeit, Stabilität oder Sicherheit gewährt.
Institutionen, die noch nicht auf Version 2 migriert sind, müssen mit dem sofortigen und unwiderruflichen Ende des UPI-Dienstes rechnen.
Die Migration auf die Version 2 der UPIServices ist daher obligatorisch.
Um die Kontinuität ihrer Aktivitäten zu gewährleisten, müssen Institutionen, die noch Version 1 nutzen, unverzüglich ihren IT-Dienstleister beauftragen, die Migration vorzunehmen.
Bei nicht erfolgter Migration liegt die Verantwortung für jegliche Unterbrechung vollständig bei der betroffenen Institution und ihrem IT-Dienstleister.
Nachstehend finden Sie den Link zur Dokumentation der neuen Version:
eCH-0085 UPI Query Interface V2.0.0 | eCH E-Government Standards
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.
Das untenstehende Benutzerhandbuch, dessen Lektüre für die Verwendung der Dienste obligatorisch ist, behandelt zahlreiche Aspekte des UPI und der Verwaltung der AHV-Nummer.