Inhalte API-Integration (PK)

Die verbindliche Feldliste für das Pension Statement ist im GitHub-SFTI-Schema «Pension Statement» (PensionStatement.yaml) Version 3 definiert. Dieses Dokument bietet einen Auszug für interessierte Fachpersonen und Datenschutzfachleute.

  • timeStamp: Datum und Uhrzeit der Erstellung des Pension Statements
  • referenceDate: Referenzdatum (Stichtag) des Pension Statements
  • personId: technischer Identifikator der versicherten Person bei der Vorsorgeeinrichtung
  • pensionStatementType: Art des Pension Statements – regulär oder simuliert
  • languageCode: Sprachcode nach ISO 639‑1 (de, fr, it, en)
  • pensionStatementId: technische ID des Pensionsauszugs (für API‑Aufrufe)
  • pensionStatementNo: auf dem Auszug gedruckte Auszugsnummer
  • employer: Angaben zum Arbeitgeber.
    • employerName: Name des Arbeitgebers
    • employerId: Unternehmens‑Identifikationsnummer UID (z.B. CHE115873291)
    • industry: Branche bzw. Wirtschaftszweig des Arbeitgebers
  • pensionProvider: Angaben zur Vorsorgeeinrichtung (Stiftung), welche die Police führt.
    • providerName: Name der Vorsorgeeinrichtung
    • portalName: offizieller Name des Versicherten‑Portals
    • portalUrl: URL des Versicherten‑Portals
    • providerAddress: Postadresse der Vorsorgeeinrichtung (Strasse, PLZ, Ort, Land, ggf. Postfach)
    • providerId: UID der Vorsorgeeinrichtung
  • pensionPlans: Liste der zugehörigen Vorsorgepläne. Pro Plan:
    • contractType: Vertragsart (mand = obligatorischer BVG‑Vertrag, suppl = überobligatorisch, earlyRet = Frühpensionierung, bridge = Überbrückungsrente, 1e = 1e‑Plan, other = andere)
    • planName: Name des Vorsorgeplans
    • optionalSavingsPlanName: Name des optionalen Sparplans
    • planId: technische ID des Vorsorgeplans
  • personalPensionDetails: persönliche Vorsorgedaten der versicherten Person, aggregiert über alle Policen.
    • ordinaryRetirementAge: reguläres Renteneintrittsalter in Monaten seit Geburt (z.B. 780 Monate = 65 Jahre)
    • earliestRetirementAge: frühestmöglicher Renteneintritt in Monaten seit Geburt (z.B. 696 Monate = 58 Jahre)
    • regularPurchaseMaxAmount: Maximalbetrag für reguläre Einkäufe
    • homeOwnershipAvailableForWithdrawal: für den Bezug zur Wohneigentumsförderung verfügbares Guthaben (Beschränkungen ab Alter 50 bereits berücksichtigt)
    • homeOwnershipAvailableForPledge: für die Verpfändung zur Wohneigentumsförderung verfügbares Guthaben (Beschränkungen ab Alter 50 bereits berücksichtigt)
    • salaryData: Informationen zum relevanten Gehalt.
      • declaredSalary: deklarierter Brutto‑Jahreslohn
      • insuredSalaryMandatory: obligatorisch versicherter Jahreslohn
      • insuredSalaryRetirement: versicherter Jahreslohn für Altersleistungen (obligatorisch und überobligatorisch)
      • insuredSalaryRisk: versicherter Jahreslohn für Risikoleistungen (obligatorisch und überobligatorisch)
      • employmentLevel: Beschäftigungsgrad in Prozent (100 = Vollzeit)
      • additionalSalary: zusätzlicher Lohnbestandteil
      • bonus: Bonus‑Lohnbestandteil
      • otherSalaryComponent: weiterer Lohnbestandteil
    • financing: Finanzierung der Vorsorge (jährliche Beiträge).
      • contributionSavingsEmployer: Sparbeitrag Arbeitgeber
      • contributionSavingsInsuredPerson: Sparbeitrag versicherte Person
      • contributionAdministrationEmployer: Verwaltungskostenbeitrag Arbeitgeber
      • contributionAdministrationInsuredPerson: Verwaltungskostenbeitrag versicherte Person
      • contributionRiskEmployer: Risikobeitrag Arbeitgeber
      • contributionRiskInsuredPerson: Risikobeitrag versicherte Person
    • retirementCapital: Informationen zum Alterskapital (Stände, Vorjahresentwicklung, Projektionen).
      • balanceReferenceDate: aktueller Altersguthabenstand per Stichtag (obligatorisch und überobligatorisch)
      • balanceMandatoryReferenceDate: aktueller Altersguthabenstand per Stichtag (nur obligatorisch)
      • balanceEndCurrentYear: prognostiziertes Altersguthaben per Ende des laufenden Jahres (obligatorisch und überobligatorisch)
      • balanceMandatoryEndCurrentYear: prognostiziertes Altersguthaben per Ende des laufenden Jahres (nur obligatorisch)
      • transferredCapital: eingebrachte Freizügigkeitsleistungen aus früheren Einrichtungen (obligatorisch und überobligatorisch)
      • transferredCapitalMandatory: eingebrachte Freizügigkeitsleistungen aus früheren Einrichtungen (nur obligatorisch)
      • interestRates: angewandte und projizierte Zinssätze.
        • interestRateEnvelopingSaving / interestRateMandatorySaving / interestRateSupplementarySaving: Sparzins (umhüllend / obligatorisch / überobligatorisch)
        • interestRateEnvelopingProjection / interestRateMandatoryProjection / interestRateSupplementaryProjection: Projektionszins für Prognosen
        • interestRateEnvelopingPurchase / interestRateMandatoryPurchase / interestRateSupplementaryPurchase: Zins für Einkaufsberechnungen
      • lastYearDevelopment: Kapitalentwicklung des Vorjahres.
        • balanceBeginningLastYear: Kapitalstand am Anfang des Vorjahres
        • balanceEndLastYear: Kapitalstand am Ende des Vorjahres
        • oldAgeCreditLastYear: Altersgutschriften (Sparbeiträge) im Vorjahr
        • interestCreditLastYear: Zinsgutschriften im Vorjahr
        • interestRatesLastYear: im Vorjahr angewandte Zinssätze (gleiche Unterfelder wie interestRates)
        • totalDepositsLastYear: total Einzahlungen im Vorjahr
        • totalWithdrawalsLastYear: total Bezüge im Vorjahr
      • projectedRetirementBenefits: prognostizierte Altersleistungen für die Eintrittsalter 58 bis zum regulären Renteneintrittsalter. Pro Eintrittsalter:
        • retirementAge: verwendetes Renteneintrittsalter in Monaten seit Geburt
        • capitalBalance: prognostiziertes Altersguthaben inkl. Zins (obligatorisch und überobligatorisch)
        • capitalBalanceMandatory: prognostiziertes Altersguthaben inkl. Zins (nur obligatorisch)
        • capitalBalanceNoInterest: prognostiziertes Altersguthaben ohne Zins (obligatorisch und überobligatorisch)
        • capitalBalanceNoInterestMandatory: prognostiziertes Altersguthaben ohne Zins (nur obligatorisch)
        • conversionRateEnveloping: umhüllender Umwandlungssatz (Kapital → Rente)
        • conversionRateMandatory: Umwandlungssatz für den obligatorischen Teil
        • conversionRateSupplementary: Umwandlungssatz für den überobligatorischen Teil
        • pension: resultierende Jahresrente
    • riskBenefits: Leistungen im Todes‑ und Invaliditätsfall.
      • pensionDisability: jährliche Invalidenrente
      • childPensionDisability: jährliche Kinderrente bei Invalidität
      • partnerPensionDeath: jährliche Partnerrente im Todesfall
      • orphanPensionDeath: jährliche Waisenrente im Todesfall
      • lumpSumWithoutPensionBenefits: einmalige Todesfallsumme, falls keine laufenden Hinterbliebenenleistungen ausgerichtet werden
      • minimalLumpSumWithPensionBenefits: garantierte minimale Einmalzahlung im Todesfall zusätzlich zu laufenden Hinterbliebenenleistungen
    • vestedBenefits: Freizügigkeits‑ und Vorsorgehistorie der versicherten Person.
      • referenceDate: Stichtag der Freizügigkeitsinformationen
      • capitalAt50: Altersguthaben mit 50 (obligatorisch und überobligatorisch); leer für Personen unter 50
      • capitalAt50Mandatory: Altersguthaben mit 50 (nur obligatorisch); leer für Personen unter 50
      • capitalAtMarriage: Altersguthaben vor der letzten Heirat bzw. Eintragung der Partnerschaft (obligatorisch und überobligatorisch)
      • capitalAtMarriageMandatory: Altersguthaben vor der letzten Heirat bzw. Eintragung der Partnerschaft (nur obligatorisch)
      • capitalFirstCommunicated: erstmals nach dem 1. Januar 1995 mitgeteiltes bzw. fällig gewordenes Freizügigkeitskapital (für vor 1995 Verheiratete)
      • capitalFirstCommunicatedDate: Datum dieser erstmaligen Mitteilung bzw. Fälligkeit
      • voluntaryPurchases: Liste freiwilliger Einkäufe (mindestens die letzten 3 Jahre, jahresweise aggregierbar). Pro Eintrag: amount, amountMandatory, date
      • homeOwnershipWithdrawals: Liste vergangener Bezüge und Rückzahlungen aus Wohneigentumsförderung. Pro Eintrag: amount, amountMandatory, date
      • divorceWithdrawals: Liste vergangener Bezüge und Einzahlungen aus Vorsorgeausgleich nach Scheidung. Pro Eintrag: amount, amountMandatory, date
      • pledges: Verpfändungen von Teilen des Altersguthabens. Pro Eintrag: amount, amountMandatory, pledgee (Name), pledgeeAddress (Adresse)