DecCF./ˈdɛk.ɛf/

Swedish personal income tax

The Swedish personal tax pack provides a monthly preliminary-tax cashflow and an annual tax assessment followed by a delayed settlement. swedishPreliminaryIncomeTax books a monthly preliminary-tax expense against the person's cash account. swedishIncomeTax is the year-end assessment cashflow; swedishIncomeTaxSettlement returns its trigger-listening payment cashflow. Both use the pack's 2025 calculation rules for each forecast year.

Use the two cashflows

Open this model in the Calculator.

The tax flows find accounts owned by Anna by combining each account's type with its personal-plan category. They automatically add missing expense.income_tax_adjustment and expense.preliminary_income_tax accounts, and use an existing cash asset under assets.cash when one is available. The two tax accounts are siblings; both categories roll up beneath expenses.tax. If the person has several cash accounts, pass the same cashAccount reference to both tax flows. The selected account must exist in the compiled model; a stdaccount reference can be collected automatically from the tax flow.

The example adds only the cash account with an opening balance. The salary account is collected from its posting flow, and the tax and retained-earnings accounts are supplied by the tax and account-plan modules. The model does not need to list those accounts in accounts.

Preliminary payments

By default, preliminary tax uses basis: "current-period" and looks up that month's gross payroll income in Skatteverket's official 2025 monthly withholding tables. The supported tables cover numbers 29–42, all six payment columns and the percentage intervals above SEK 80,000. Forecasts use these 2025 tables throughout the timeline. Both preliminary modes require monthly periods and SEK.

The default follows salary, taxable wage benefits, pension, sickness/activity compensation and other supported payroll categories. Income changes affect that month's withholding; zero income does not reuse an earlier month. Signed corrections are netted within each payment category before its gross amount is floored at zero. Year-end closing entries are excluded. Capital income, property fees, interest deductions, business profit and annual tax credits are reconciled by the annual assessment. Explicit extra payroll bases enter the monthly lookup: annual amounts are divided by twelve, while monthly sources supply their selected monthly amount.

Choose basis: "history" to use the previous year's average observed monthly payroll income, or the latest positive current-year month if no positive previous-year income is available. A forecast beginning in December therefore treats that observed December amount as a monthly proxy for the next year. monthlyBuffer is an optional finite, non-negative SEK amount or declared amount source and defaults to zero. The buffer is a modelling assumption. The composed personalTax options are preliminaryBasis and preliminaryBuffer:

The default table number comes from the sum of municipal and regional tax, burial fee and any configured membership fee. Rates ending at exactly .50 round down; for example, 32.50 selects table 32 and 32.51 selects table 33. Set tableNumber explicitly when an A-tax certificate specifies the table; the composed option is preliminaryTableNumber.

Columns follow payment categories and the 2025 birth-year cohorts: salary uses column 1 for people born in 1959 or later and column 3 for those born in 1958 or earlier; pension uses column 6 or 2 respectively. Sickness/activity compensation uses column 4 for the younger cohort; unemployment and other pensionable benefits use column 5. Set tableColumn explicitly for a payroll classification decision; the composed option is preliminaryTableColumn. These settings accept declared number sources.

Person-level payroll accounts are treated as payments from one payer. For mixed payment categories, the lookup uses their total gross amount and the column for the largest category; ties use the column producing the highest withholding, following SKVFS 2024:19 section 10. Separate main and secondary payers and individual withholding decisions need explicit modelling assumptions.

Parental benefit and true sickness benefit require special percentage tables based on SGI and compensation level. Those details cannot be inferred from monthly gross alone, so preliminary withholding reports a clear error unless you supply an explicit tableColumn as your payroll classification override. Annual assessment continues to support these income bases. Sickness/activity compensation is a separate supported category.

Hobby and other income on which you pay your own social contributions (INK1 1.6), and business profit, enter annual assessment. Generic other income (INK1 1.1), other non-pensionable income (1.5) and K10/K10A/K13 income (1.7) do not identify a payroll category on their own. Positive amounts in those generic bases require an explicit tableColumn before they enter preliminary withholding.

Use one preliminary declaration for each person. The actual assessment continues to read the year's posting history and reconcile all preliminary payments through the delayed settlement. Changing the preliminary basis changes payment timing and the settlement difference; it does not change the annual tax rules.

Annual settlement

The assessment runs at year-end by default. It calculates the year's full income-tax liability from mapped account postings and compares it with that year's preliminary-tax expense postings. At this point it only emits the signed difference through the engine's ordinary trigger mechanism; it creates no ledger postings, so only monthly preliminary tax has been booked so far. The trigger snapshots that year's amount.

The paired settlement cashflow listens for that trigger and, after the delay, books the captured difference directly between expense.income_tax_adjustment and cash. A positive difference adds final tax expense and pays the remaining tax; a negative difference reduces that adjustment and receives the refund. There is no separate tax-due account: the settlement is booked when the final tax decision is made. settlementDelayDays defaults to SWEDISH_INCOME_TAX_SETTLEMENT_DELAY_DAYS (150 days) after the assessment occurrence, which places the whole final adjustment in May of the following year on a monthly timeline. For example, pass swedishIncomeTax({ person: anna, settlementDelayDays: 120 }) to move it earlier. The amount remains the value captured when that year's assessment ran. Include enough forecast periods to see the settlement; if the following May is outside the model, neither the final adjustment nor the settlement is booked within the forecast.

The personal account plan's bookClosing closes the preliminary and final tax expense accounts at year-end after the assessment. It obtains retained earnings through the personal plan when that account is missing. Add dependsOn: [tax] to book closing so the assessment trigger is emitted before income and expense accounts are closed. The May settlement records the final expense adjustment against cash in that same month.

The preliminary cashflow's schedule and the assessment's schedule option can be overridden with ordinary schedule references. The assessment schedule determines when its trigger captures the tax year's amounts; settlementDelayDays determines the delay from that occurrence. The model should use monthly periods when it needs a payment in every month.

Person attributes and rules

Attach dateOfBirth to the person, rather than to either tax cashflow:

The pack reads and validates that static attribute. The default rules use 12 resident months, a municipal rate of 32.41%, the 2025 state-tax threshold, and the 2025 burial-fee rate. Pass rules to either tax flow to override these values.

Compose declared tax sources

personalTax({ person, rules, taxBases, propertyAssessments }) composes preliminary payments, assessment and delayed settlement into one component. Its outputs are preliminary, assessment and settlement. Use preliminarySchedule and assessmentSchedule to choose the occurrences, and settlementDelayDays to choose the delay. The two individual tax declarations accept the same rules, taxBases and propertyAssessments sources.

Rules such as municipalRate, communityMember, communityFeeRate and burialFeeRate accept declared inputs, calculations and expressions. communityMember must resolve to a boolean; an expression comparing an editable choice with its selected value works. A move scenario can select explicit before/after rates using ordinary sources. Each tax occurrence reads the currently selected rules. There is no built-in municipality or parish dataset, and the author chooses whether a scenario's rate applies to a whole year. All calculations still use 2025 tax rules, thresholds and property-fee rules.

Extra tax bases are added to the person's mapped account bases. For example:

B is the exported SWEDISH_INCOME_TAX_2025_BASE map. Numeric basis values remain accepted and mean annual amounts. An { amount, period: "annual" } source is read at the tax calculation occurrence; monthly multiplies the selected amount by twelve for annual assessment. These explicit sources are not a history of profit, and changes during a year do not imply accumulated past values. They create no income or cash postings. The actual annual assessment reads the year's posting history; preliminary withholding looks up the selected monthly payroll amount. Specifying an extra basis for income already represented in the selected account postings adds it again. Self-employment contributions (egenavgifter) are not derived automatically; the explicit liability basis is available until that calculation is supported.

Property records accept assessmentValue, buildingYear, optional valueYear and optional ownershipShare. Their declared sources are passed to the existing property-fee calculation. That calculation uses the 2025 cap of SEK 10,074 per full-share property and its existing new-build exemption based on value year; ownership share scales the fee before rounding. Supplying these records replaces the single-home B.INK1_5_1 fallback fee base. A positive explicit B.TAX_LIABILITY_PROPERTY_FEE replaces the derived fee calculation instead. Property records do not create a separate property-fee expense or bank payment. Their liability is reconciled by the annual assessment and delayed settlement; do not add another cash fee for the same liability.

Extra payroll bases affect preliminary withholding. Other explicit bases and property records affect annual assessment and settlement. Both preliminary modes read service-income accounts and apply the selected monthly table and buffer. Omitting the preliminary options selects current-period withholding and a zero buffer.

Variable homes and explicit January 1 ownership

swedishPropertyAssessments2025({properties, ownershipAtJanuary1, people, personId}) produces a keyed assessment source accepted directly by personalTax, swedishIncomeTax and swedishPreliminaryIncomeTax. properties is an ordinary object-array source containing id, assessmentValue, buildingYear and optional valueYear. ownershipAtJanuary1 is a separate object-array source of {propertyId, personId, share}. people is a keyed entity map, and personId can be the current repeated person's row id.

Every home needs explicit ownership records summing to one; duplicate relations, unknown homes/people and negative or missing shares fail. Zero shares are valid. A person absent from a home's ownership records receives zero share. All legal owners must appear in people, including an external co-owner if relevant. Optional fields and ownershipFields map these field names to your input schema. Changing a collection or a person's share rebuilds the per-person assessments.

For a named property report, opt in with publishDetail: true. The result then contains assessments with the unchanged tax records and detail with the same values plus each property's current name. Pass .project("assessments") to personal tax and .project("detail") to RecordTable. Set owner to the current person and use sourceLabel: "owner", rowLabelPath: "name" to show both identities. The optional fields.name maps a different name field; a missing name uses the property ID. Without this option the original assessment map and schema remain unchanged.

These are explicit January 1 assumptions for the supported 2025 tax calculation. Purchase date, sale date and current legal ownership do not silently change them. A projection that changes the tax-year assumption must update these records explicitly. The supported calculation applies each home's statutory cap and exemption before that person's share. The helper adds no cash payment; the existing preliminary tax and settlement components carry the tax effect. Do not add the same property fee again as a separate housing payment or explicit tax liability.

Publish assessed tax and projected profiles

Add publishAssessment: true to personalTax to expose outputs.assessmentDetail. Each assessment occurrence publishes the exact assessed liability, preliminary tax already paid, signed difference, property fee, property tax and the detailed tax components. Amounts are Money values in the model currency. ruleYear is always 2025; taxYear identifies the forecast year being assessed. A negative difference is a refund. Other periods contain null, so a missing assessment is never presented as zero tax.

This record follows assessmentSchedule, including a custom assessment date. A custom date assesses mapped activity from January 1 through that occurrence; explicit annual extra bases retain their full annual meaning. The selected rules and January 1 property assumptions apply when the assessment occurs. Publishing the record adds no tax payment or property-fee charge. Preliminary payments and the delayed settlement continue to carry the cash effect.

For interest allocation, publishProfile: true exposes outputs.projectedProfile. This option requires a monthly timeline. It projects each person's actual mapped activity in the current month over twelve months, then adds the explicit annual extra bases (monthly extras are also multiplied by twelve). This includes mapped consumer interest and capital income. It is a current-month projection, not the final annual assessment or an accumulated year-to-date estimate.

The profile contains ruleYear, taxYear, dateOfBirth, all selected rules, numeric taxBases and a keyed propertyAssessments map. Property sources retain their authored home ids; a literal property array uses its zero-based positions as keys. The profile uses the same explicit January 1 ownership assumptions as the tax component.

Use profileExcludedTaxBases to leave out bases that a later allocation will supply, for example:

These exclusions apply only to the projected profile, including any explicit extra amount for the excluded basis. Ordinary preliminary tax, annual assessment and settlement continue to use their normal inputs. Both publication flags default to false. Repeated people receive independent records keyed by their authored ids when collected through the ordinary repeat outputs.

Gross property charges by home

swedishPropertyCharges2025({profiles}) reads a keyed map of published projected tax profiles and reports gross annual property charges using the 2025 tax rules. perProperty retains the property IDs from the explicit January 1 assessments. Each row contains propertyFee, propertyTax and total as SEK Money values. Separate personal ownership shares keep the tax engine's rounding, so two owners' assessed fees can differ by one krona from a single full-ownership assessment.

The result's total equals the combined gross property fee and property tax from all supplied profiles. unallocated contains charges from bases without a property ID, including explicit property-fee overrides and unkeyed property-tax bases. An explicit fee override suppresses the assessment-based fees, just as it does in the tax assessment; the override stays unallocated. The current keyed home assessments describe residential property fees, so their propertyTax is zero. The helper does not invent a home attribution for other property taxes.

These are gross charges before personal tax credits. They do not establish each home's net contribution to the final personal tax liability, and the helper creates no payment or account posting. Use the assessed tax detail for the actual person's final liability. Empty profiles or empty home maps are supported; unkeyed charges, if any, remain visible.

Resolved Swedish 2025 assessment

assessSwedishIncomeTax2025(options) returns the established annual Swedish 2025 calculation without declaring any payment. dateOfBirth is required. taxBases, rules, derive and propertyAssessments use the existing 2025 contract and defaults above, but values must already be resolved. Annual tax bases and property assessmentValue may be numbers or SEK Money; rates, dates, years and boolean flags retain their own types. References, callbacks, foreign Money, invalid dates, unknown options/bases/rules and invalid derive flags fail.

The returned record contains country:'SE', currency:'SEK', ruleYear:2025, period:'annual', liability, grossIncome and the complete numeric components map. Liability and income use annual SEK; native component rounding is preserved. No owner, tax card, settlement timing or bank payment is created, and this call does not upgrade the rules to a later year.

When explicitly projecting this calculation into a later planning year, identify it as a 2025-rule projection. It is not verified law for the later year and its annual assessment must not be posted as new tax each month.