Schnittstelle UPIServices
UPIServices ist eine Palette von Dienstleistungen, über die eine IT-Anwendung mit der UPI-Datenbank interagieren kann.
Die UPIServices ermöglichen Abfragen anhand einer AHV-Nummer oder üblicher Identifikationsmerkmale. Sie ermöglichen es auch, Informationen über Veränderungen in UPI über einen bestimmten Zeitraum zu erhalten, wie Statusänderungen der AHV-Nummer, Namensänderungen von Personen oder Sterbefälle (sogenannter Broadcast-Service der Veränderungen). Sie ermöglichen auch Organisationen, welche die AHV-Nummern massenhaft in ihren Personenregistern einführen möchten, diese selbstständig und nach eigenem Ermessen zu erhalten, indem sie einfach auf die UPI-Datenbank zurückgreifen. Ausserdem wird eine Abgleichsfunktion angeboten, die ein Personenregister mit UPI vergleicht und festgestellte Abweichungen bei den Identifikationsmerkmalen meldet.
Die Umsetzung der UPIServices in einer IT-Anwendung setzt eine entsprechende Programmierung und damit den Beizug von Softwarefachleuten voraus.
Zugang zu UPIServices
Bevor Ihre Organisation den individuellen Zugang zu UPIServices beantragen kann, muss sie für den Tätigkeitsbereich, in welchem sie die AHVN13 nutzen will, von der Zentralen Ausgleichsstelle als systematischer Benutzer der AHVN13 anerkannt sein. Prüfen Sie deshalb vorgängig Ihren Status im Verzeichnis der systematischen Benutzer der AHVN13. Ist Ihre Organisation darin nicht oder unter einem anderen Tätigkeitsbereich aufgeführt, kann eine berechtigte Person (in der Regel ein Geschäftsleitungsmitglied) online die Anmeldung für die systematische Verwendung der AHVN13 ausfüllen. Sobald diese Bedingungen erfüllt sind, können Sie einen Antrag auf Zugriff auf UPIServices stellen, indem Sie das untenstehende Formular ausfüllen und per Email an support-rc@zas.admin.ch senden.
Technische Spezifikationen
Der Datenaustausch mit dem UPI via UPIServices erfolgt mittels Meldungen im XML-Format. Die Syntax dieser Meldungen wird in Dokumenten (so genannten "XML-Schemas") definiert, die die technische Sprache XSDL (XML Schema Definitionen Language) benützen.
Die für den Betrieb des UPI vorgesehenen Schemas wurden vom Verein eCH (www.ech.ch) homologiert und halten sich vollumfänglich an die 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 die neusten integrierten Versionen der Schemas eCH-0084, eCH-0085, eCH-0086 und der WSDL. Hier finden Sie auch einige Beispiele für XML-Nachrichten.
Die drei vom UPI-System angebotenen Applikationsschnittstellen, die auf einem meldungsorientierten Request/Response-Protokoll aufbauen, sind im folgenden Dokument beschrieben:
Die neueste Version des Schemas eCH-0212 und die dazugehörige Dokumentation sind auf der Website des eCH-Vereins erhältlich.