Swedish pension agreements
This package provides a catalog-backed agreement choice, a statement-based pension case, and gross payout comparisons. Agreement formulas live as dated declarative profiles in the country-neutral pension rule engine. A profile states its coverage and primary sources; incomplete slices are labelled in the dropdown.
import {
pensionAgreementInput,
createPensionCase,
comparePayoutScenarios,
} from "./domainpacks/swedish-pension/index.js";
const agreement = pensionAgreementInput();
// Bind `agreement` as an input in the model. The initial value is empty by design.
const pensionCase = createPensionCase({
id: "case-1",
birthDate: "1970-05-12",
rights: [
{ id: "itp2-db", kind: "db-annual-benefit", annualAmount: 84000, currency: "SEK",
valuedAt: "2026-01-01", payableFrom: "2035-06-01", agreementId: "itp2",
source: "Pension statement dated 2026-01-01" },
{ id: "itpk-capital", kind: "dc-capital", amount: 320000, currency: "SEK",
valuedAt: "2026-01-01", agreementId: "itp2", product: "ITPK", source: "Pension statement dated 2026-01-01" },
],
});
const comparison = comparePayoutScenarios({ pensionCase, scenarios: [{
id: "2035",
label: "Starts in June 2035",
startDate: "2035-06-01",
payouts: {
"itp2-db": { form: "db-statement", statementPayableFrom: "2035-06-01" },
"itpk-capital": { form: "fixed-term", remainingPayments: 180, periodRate: 0.001, placement: "end" },
},
}] });Rules and selection
pensionAgreementInput()reads its options from the same profile catalog used byresolveSwedishPensionAgreement(). The empty choice is explicit and must be resolved before agreement rules can run.- Profiles are selected by stable id and date. An unknown id, uncovered period, or overlap fails instead of choosing a first profile.
- ITP 1 has dated ordinary-premium rules from 2007. Before 2023, 4.5% applies up to 7.5 IBB and 30% above, without a salary cap; ordinary accrual starts at 25 and ends before age 65. A sourced
eligibilityDecisions.itp1-post-65-continuation-eligibilitydecision is required for separately agreed contributions after 65. From 2023, the salary cap is 30 IBB and ordinary accrual runs to age 66. From 2026, a voluntary continuation premium from 66 to 67 requires a sourcedeligibilityDecisions.itp1-after-66-continuation-eligibilitydecision. Supply monthly pensionable salary and employment dates. The profiles do not reconstruct individual capital from statements, flexpension, alternative ITP, employer-specific supplements or continuation after 67. - ITP 2's 2026 profile covers the ordinary DB bands of 10%, 65% and 32.5%, with a 360-month full-service factor and normal retirement age 65. ITPK is a separate 2% contribution on pensionable salary up to 30 IBB. Supply the approved annual salary basis, credited service months, birth date and active-employment dates for ITPK projection. The profile does not derive the five-year salary basis or historical service from raw employment records; enter accrued DB rights and ITPK capital from pension statements. Family pension, alternative ITP, coordination and early/late retirement factors require additional source data.
- Avtalspension SAF-LO has dated base-premium rules from 1996 through 30 November 2026. Rates are 2% of all pensionable salary in 1996–1999, 3.5% in 2000–2007, and then 4.5% up to 7.5 IBB plus 30% above it from 2012, with the 2008–2011 transition rates represented year by year. The upper band has no salary ceiling. The starting age follows the historical Fora schedule; supply annual pensionable salary through 2023 and monthly salary from 2024, plus the applicable income base amount for band years. A sourced
eligibilityDecisions.saflo-post-65-continuation-eligibilitydecision is required for separately agreed continuation after 65 from 2014. Each Fora 2026 sector supplement has its own selectable, date-versioned profile; the research inventory records its pension rate, age limit and source. Profiles project only the pension portion explicitly identified by Fora, excluding separately listed premium-waiver insurance. Customer-controlled additions under the staffing-agreement variant depend on the customer contract and allocation of salary and time, so they are not projected without those details. Accrued capital and earlier STP rights come from pension statements. LO has given notice that the base agreement ends on 1 December 2026. - STP is a statement-only choice for older private-worker pension rights. Enter its annual defined benefit from a pension statement, and any separate STP-P capital as DC capital. The profile does not reconstruct the historic service qualification, ATP-point pension salary or coordination rules.
- PA 16 has separate Division I, Division II for people born before 1966, Division II for people born 1966–1987, and a statement-only choice for older pre-1955 DB rights. Its 2026 premium versions split at 1 October. The pre-1966 Kåpan Flex operation requires a sourced
eligibilityDecisions.kapan-flex-eligibilitydecision because current or previous partial retirement pension excludes that premium. - PA 16's DB profile covers the SPV birth-year table from 1955 through 1987, including the 36-month minimum service rule. Provide the applicable annual pension basis and credited service. Cohorts before 1955, the five-year salary history calculation, coordination, and early/late retirement factors require their pension statement or additional SPV data.
- PA 16 band calculations require the applicable
incomeBaseAmount; the 2026 amount is SEK 83,400. The evaluator does not silently supply a base amount. - BTP 1 separates its safe and choice premiums and resolves the ordinary or enhanced choice rate from the selected plan and sourced birth-year cohort. It uses the 2026 income base amount of SEK 83,400 and requires active-employment dates for projection.
- BTP 2 includes its three DB salary bands and BTPK, with a 2%/4% cohort premium. The projection needs an approved annual pension basis and credited service. Its DB and BTPK bands use the 2026 income base amount of SEK 83,400.
- FTP 1 uses dated premium profiles for the published 2025–2028 schedule, with the correct April change dates and 25-to-66 age limit. Supply the relevant income base amount for each evaluated year; the 2026 value is SEK 83,400.
- FTP 2 uses its normal-age DB bands, 360-month full-service factor, and separately versioned FTPK rates for 2025–2028. It needs an approved annual pension basis and credited service; early retirement, the alternative rule, and employer-specific salary adjustments require extra source data.
- KTP 1 has dated premium profiles for 2020–2022 and 2024–2026. In 2020–2022, KFO–Forena/Handels/Akademikerförbunden is 5.7%/31.3% and AFO–Handels is 5.0%/30.5%; AFO's starting age is 25 in 2020, 24 in 2021, and 23 in 2022. In 2024–2025, the schedules give Fremia–Handels and popular-movement employers 4.5%/30%, Fremia–Forena/Handels/Akademikerförbunden 5.7%/31.3%, and AFO–Handels 5.6%/31.1%, starting at age 25 for the first two and age 22 for AFO. In 2026, they give Fremia–Handels and popular-movement employers 4.5%/30%, the Fremia–Forena group “other” 5.7%/31.3% and “including Deltis” 6.1%/31.7%, AFO–Handels 6.3%/31.8%, and ABF–Handels 6.3%/31.8%. The Deltis and ABF profiles require sourced
eligibilityDecisions.ktp1-fremia-deltis-profile-confirmationandeligibilityDecisions.abf-ktp1-profile-confirmation, respectively, to confirm the employer's applicable variant. The listed ending ages are 65 through 2025, with Fremia–Forena to 66 and AFO to 67 in 2026. The model includes the month in which the stated ending age is reached because the annual schedules do not define a more precise monthly boundary. No dated 2023 schedule was found, so that year remains unsupported. Pensionsvalet's general AFO page still shows older rates, so dated annual schedules are used. Earlier premiums, agreed continuation after ordinary retirement age, capital growth, risk benefits and insurer payout terms are not projected. - KTP 2 has three named variants. The 2026 DB profile uses 10%, 65% and 32.5% salary bands, with 360 months of full service from age 28. KTPK's individual pension is also projected at 2.1% for Fremia–PTK and 3.9% for AFO–Handels; its rate varies by employer in the Fremia–Forena/Handels/Akademikerförbunden variant, so enter that capital from a pension statement. Supply the approved annual pension basis, credited service, income base amount and active-employment dates for KTPK. Special salary transitions, family pension, alternative pension and insurer payout terms need separate source data.
- GTP covers the published 2024–2026 Fremia–LO base premium, starting in the month the employee turns 22. It requires the applicable income base amount; extra part-time pension premiums and pre-2011 KAP/STPK rights are separate.
- KAP/STPK rights earned before 2011 are selectable as a statement-only profile. Enter the value from the dated pension statement; the package does not reconstruct historic accrual.
- TPA 18 covers employees born in 1959 or later. The ordinary 4.5%/30% premium is versioned for 2026, including the 0.7% reinforced premium on all pensionable salary from May 2026 through 2027. The rate above 7.5 IBB falls to 4.5% from age 69 under LAS 32 a §. Enter active-employment dates; later premium changes and insurer payout terms are outside this profile.
- Municipal KAP-KL has dated 4% (2007), 4.25% (2008–2009), and 4.5% (2010–2026) contributions on pensionable salary up to 30 IBB. Supply annual pensionable salary, the applicable IBB, active-employment dates, and a sourced
eligibilityDecisions.kap-kl-annual-credit-eligibilitydecision confirming that the year's contribution exceeds 1% of IBB. The profile does not calculate the cash payment when that threshold is not reached or its SEK 200 minimum. Births through 1946 follow older PFA rates and use pension-statement values. From 2023, also supply a sourcedeligibilityDecisions.kap-kl-transition-eligibilitydecision confirming continued KAP-KL coverage after the transition to AKAP-KR. The 2026 profile adds birth-year DB levels over 7.5 IBB, 360 months of full service, and a three-month continuous-service minimum. It requires an approved annual pension basis, credited months, and a sourcedeligibilityDecisions.db-old-age-qualificationdecision confirming that both the year's pensionable salary and the pension basis exceed 7.5 IBB. Historical salary basis, pre-2026 DB accrual, 2006 transitional rights, coordination, life annuity, special agreement pension, and early or late start adjustments come from statements or separate decisions. - KAP-KL Svenska kyrkan is separate from municipal KAP-KL. It has dated 4% (2007), 4.25% (2008–2009), and 4.5% (2010–2026) DC premiums, plus its birth-year DB table for salary over 7.5 IBB. The DB profile requires the approved pension basis, service months, and sourced
eligibilityDecisions.db-old-age-qualification. Births through 1946 have PFA-based DC rates, which are not projected here. From 2026, a new employment starting after age 67 is excluded from the DC projection. - PA-KL Svenska kyrkan is statement-only. Enter the annual right or capital from Kyrkans pension, including any PBB-indexed gross pension or life annuity. The agreement does not apply to clergy; older state pension rights for priests go through SPV.
- PA 03 is a statement-only state agreement. Enter each DC capital and DB annual benefit separately from SPV or Kåpan statements; the profile does not reconstruct old premium or salary rules.
- AIP is available for the theatre, dance and music employees who remain in the PA 03/PISA group under the transition rules. The profile calculates 4.5% of covered monthly pay to 30 IBB, from age 23 (18 for dancers) through the month before 65, after sourced decisions confirm current coverage and the annual 300 SEK minimum. AIP amounts below that minimum are paid as cash under the agreement; special PISA ages, older PISA DB rights and insurer payout terms are outside this profile.
- PISA is a statement-only choice for performing-arts pension rights under the regulations effective from 1988, including retained fribrev and any 2015 conversion pension. Enter the SPV annual benefit and AIP capital as separate rights; verify occupation, transition eligibility, pension age and indexation from the statement. The profile does not reconstruct PISA service, salary or coordination.
- AKAP-KR covers ordinary 6%/31.5% premiums from 2023 through 2026, with the upper band stepping down to 6% at age 69. It also models three separate transition premiums: KAP-KL cohorts born 1958–1985 (
eligibilityDecisions.akap-kr-kap-kl-transition-eligibility), PA-KFS 09 cohorts born 1958–1979 (eligibilityDecisions.akap-kr-pa-kfs09-transition-eligibility), and PA-KFS 09 Trafik cohorts born 1960–1989 from 2025 (eligibilityDecisions.akap-kr-pa-kfs09-trafik-transition-eligibility). Supply aneligibleorineligiblesourced decision for each applicable transition route; only the route supported by the employer/valcentral record should be eligible. The profile approximates half-year/annual thresholds monthly and does not calculate the small-premium cash alternative or absence adjustments. Enter any 2022 extra contribution, the KAP-KL accrued right at 2022-12-31 and prior PA-KFS capital separately from pension statements. - PA-91 is statement-only for rights from 1992–2002, including possible life annuity and Kåpan Tjänste. Enter the SPV life annuity as a DB annual benefit and Kåpan as separate DC capital; the profile does not recalculate PBB indexation.
- PA-SPR is statement-only for eligible rights from state employment ending before 1992. Enter the SPV life annuity as an annual DB benefit; the agreement uses a different historical salary basis from PA-91.
- PA-KFS 09 uses 4.5%/30% ordinary premiums from age 25 through the age-67 month. For a sourced transition from Gamla PA-KFS, a birth-year table supplies the total higher rate through age 65;
eligibilityDecisions.pa-kfs09-transition-eligibilityis required for birth years 1954–1980. The profile adds only the excess over the ordinary rate. Confirm PA-KFS 09 itself from the employer/statement because some employees moved to AKAP-KR. - PA-KFS 09 Trafik has separate ordinary rates: 5%/30.5% in 2023 and 5.5%/31% in 2024–2026, from age 25 through the age-67 month. The PFA 98 transition premium for some traffic employees and an early-age transition rule are not reconstructed; use the SPV/Kåpan or insurer statement for those accrued amounts and confirm current PA-KFS 09 Trafik membership after the AKAP-KR transition.
- Gamla PA-KFS is statement-only. Enter the old-age capital or annual benefit from the insurer statement; historical pension dates and eligibility are not reconstructed from the public summary.
- PFA 98 is statement-only for the individual pension capital and any vested DB old-age right. The annual DB benefit and the individual capital remain separate statement inputs; historical salary, service and coordination are not reconstructed.
- PFA 01 is statement-only for the municipal employees within Kommunal's agreement scope. Enter individual pension capital and any vested DB old-age benefit from the statement; verify the historical agreement variant with the employer or pension administrator.
- PA-KL 85 is a separate statement-only choice for municipal rights, distinct from the church-sector PA-KL profile. Enter an annual life annuity or other old-age right from the pension statement; historical salary and coordination are not reconstructed.
- AKAP-KL is selectable for historical accrual from 2014 through 2022. Its 30% upper band steps down to 4.5% at age 67 through 2019 and 68 from 2020. Evaluate it per month with monthly pensionable salary, employment start date and a sourced decision that the calendar year's pension credit exceeds the 1.5%-of-IBB minimum. Partial-year threshold adjustments, individual extras and special retirement pension require separate data.
- AKAP-KR SAP-R is a separate catalog choice for the special old-age benefit that remains available to qualifying rescue-service employees after the 2023 closure to new entrants. It applies the 73.5%/55%/27.5% bands to a supplied KAP-KL Chapter IV pension basis, with 30 years of service, the age window from the month after 58 through the month before 65, and a sourced entitlement decision covering the remaining service and transition criteria.
offsetAnnualmust contain the already calculated annual coordination reduction when the 24%-of-PBB income threshold is reached; the profile does not compute that reduction or reconstruct the pension basis. The separate 12% pension-credit agreement for workers who waive SAP-R is not included. - KAP-KL SAP-R is a separate choice for employees who remain in KAP-KL under the post-2023 transition rules. It uses the 73.5% lower band and the agreement's birth-year table above 7.5 IBB, plus the same age, service, evidence and income-coordination inputs as the AKAP-KR SAP-R profile. The 2006–2011 combined-base-amount transition and earlier KAP-KL eligibility versions remain outside this dated profile.
- The SAP-R waiver premium is separately selectable for a qualifying rescue-service employee who agrees with the employer to remain in service instead of drawing SAP-R. It adds 12% of pensionable salary up to 30 IBB through the month before age 65 under the shared AKAP-KR/KAP-KL clause. Supply active-employment dates and sourced decisions for entitlement and the current work agreement. The model normalizes this half-year-based salary rule monthly; ordinary premiums and growth of the resulting pension capital are separate.
- DC capital and DB annual benefits remain separate, sourced statement rows. Currency conversion is not implicit.
- Current profile status and known coverage gaps are shown in the research inventory.
pensionAgreementInput()obtains its dropdown values from the catalog. Pass the selectedidtoevaluateSwedishPensionAgreement({ id, asOf, inputs })to resolve and evaluate the dated profile; it never infers an agreement from birth year. A statement-only choice accepts rights throughcreatePensionCaseand fails closed for accrual projection.- Fixed-term DC payouts require an explicit monthly rate, number of payments, and payment timing. Lifetime DC payouts require a sourced factor or explicit monthly survival, discount, and index arrays.
- A DB statement value can be used at its stated start date. A different start date requires a source-backed benefit factor. The package does not guess early/late retirement adjustments or indexation.
- Results are gross, assumption-labelled scenarios. They are not insurer quotes, net income estimates, or public-pension projections.
Declarative Swedish pension forecast
swedishPensionForecast({ owner, startYear, person, work, pensions, assumptions, rates? }) composes the executable forecast. Open the Swedish pension forecast example in the model editor to see its typed, editable inputs and connection to household tax flows.
const { input, calculation, bind, currencies, entity } = deccf;
const SEK = currencies.SEK;
const owner = entity.party({ label: "Pension forecast" });
const statement = input.object({
name: input.str("Statement"), annualAmount: input.money(120000, SEK),
valueDate: input.date("2026-01-01"), startAge: input.integer(67),
durationYears: input.integer(19), source: input.str("My pension statement"),
});
const assumptions = {
inflation: input.rate(0.02), generalSalaryGrowth: input.rate(0.03),
individualSalaryGrowth: input.rate(0.01), stockGrowth: input.rate(0.05),
payoutRate: input.rate(0.02),
};
// The mean stays editable; annual return dispersion is fixed in model code.
const stockShock = input.normal({ mean: 0, stdev: 0.15 }, { visible: false });
const stockReturn = calculation({
name: "stockReturn",
bindings: {
mean: assumptions.stockGrowth,
shock: bind.sample(stockShock, { calendar: "annual" }),
},
calculate: ({ mean, shock }) => Math.max(-0.99, mean + shock),
});
const forecast = modules["swedish-pension"].swedishPensionForecast({
owner, startYear: input.integer(2026),
person: {
birthYear: input.integer(1960),
members: input.objectArray([
{ id: input.id("person"), dateOfBirth: input.date("1960-06-15") },
]),
},
work: {
monthlySalary: input.money(48000, SEK), startDate: input.date("2010-01-01"),
lastYear: input.integer(2027), agreement: input.str("itp1"),
agreementChangeYear: input.integer(0), agreementAfterChange: input.str("akap-kr"),
fallbackAnnualContribution: input.money(36000, SEK),
incomeBaseAmount: input.money(83400, SEK),
},
pensions: {
public: statement, premium: statement,
occupational: input.objectArray([{
id: input.id("dc"), name: input.str("Occupational statement"),
rightType: input.str("dc-capital"), agreementId: input.str("itp1"),
amount: input.money(1250000, SEK), valueDate: input.date("2026-01-01"),
startAge: input.integer(67), durationYears: input.integer(10),
source: input.str("My capital statement"),
}]),
future: { startAge: input.integer(67), durationYears: input.integer(20) },
},
assumptions,
rates: { stockGrowth: stockReturn },
});
return deccf.defineModel({
currency: SEK, timeline: forecast.timeline, entities: { owner },
preconditions: { stockShock }, calculations: { stockReturn },
components: { pension: forecast.component },
metrics: { pension: deccf.metric({ value: forecast.outputs.occupationalPension }) },
});work supplies monthly salary, employment start date, final working year, agreements before and after an explicit change year, a manual premium assumption and the income base amount. assumptions supplies inflation, general and individual salary growth, investment return and payout return. Agreement changes and statement rights are not reconstructed from salary history.
Optional rates accepts numeric calculation references named inflation, generalSalaryGrowth, individualSalaryGrowth, stockGrowth and payoutRate. An omitted entry uses the matching required assumptions input. These are annual rates expressed as decimals (0.05 means 5%); every compounded rate must be finite and greater than -1. Register source calculations in the model. Callback functions, projections and unknown rate names are unsupported. A distribution read with get continues to return its center; declare bind.sample as shown to draw it.
Salary and inflation factors accumulate each January after their base year, keeping earlier years' growth and the first observation intact. Reuse the same annual source for related rights. Capital earns the effective monthly equivalent of the current annual return. At payout start, payoutRate takes over and each payment uses the remaining capital and months. DB inflation factors stop at payout start. Historical adjustments before the forecast begins use the editable assumption means; a new sample never retrospectively changes those historical values. Omitting rates retains existing deterministic assumptions and output shapes.
Each year is checked against the dated agreement catalog. Manual premiums are used only when a profile or required basis is missing, with visible status. Each DC statement row and future premium uses fundedPension: separate accounts, funding entries, returns and capital-reducing payouts. repeat connects accounts to the editable rows' stable IDs. DB annual benefits come from createPensionCase/comparePayoutScenarios; they are not treated as invented liquid capital.
Connect forecast.incomes to householdPeople, which posts pension income to the person's bank and income accounts and calculates tax using the tax package's existing rules. Capital entries do not create an extra bank payment. outputs exposes salary, pension components, premiums and the annual report. With the component named pension, the published annual report is available as pension.annualPensionSnapshot.
The forecast uses monthly periods through the year the person turns 85 and requires an explicit date of birth. The annual report shows gross amounts per pension component; household net income is shown separately. Future tax years continue to use the tax package's declared rule version, not a purported forecast of future legislation.
Adding agreements
Create a dated definePensionAgreementProfile() record with the source reference, applicability, finite declarative operations, and a coverage note. Add it to the catalog registry and inventory. When the source describes a rule the existing operations cannot express, extend the generic profile engine first and keep the new operation independent of agreement names.