Rechenwerk
wage tax
Faithful implementation of the BMF Programmablaufplan 2026 for machine wage-tax calculation (XML pseudocode version 1.0 of 23 Oct 2025, ITZBund), with BigDecimal-equivalent rounding: annualisation per pay period, pension and age allowances, employee lump sums, provision lump sum 2026 (pension 9.3 %, health 7 % + half the fund rate, care 1.8/2.3 % ± surcharge/discounts, unemployment 1.3 % with the 1,900 EUR cap comparison), tariff 2026 (basic allowance 12,348 EUR), classes V/VI via § 39b(2).
POST https://rechen.halowerk.com/v1/wage-taxInputs
| Field | Type | Required | Description |
|---|---|---|---|
| year | integer | No | Calendar year of payment (only 2026 is implemented). |
| pay_period | string | No | Pay period (Lohnzahlungszeitraum). |
| gross_wage | number | Yes | Taxable current wage for the pay period in EUR (RE4), before allowances; one-off payments go into one_off. |
| tax_class | integer | Yes | Tax class (Steuerklasse) I-VI. |
| factor | number | No | Factor of the factor procedure (§ 39f EStG, three decimals), tax class IV only. |
| child_allowances | number | No | Number of child allowances (Kinderfreibeträge) from ELStAM, in steps of 0.5 (classes I-IV only). |
| church_member | boolean | No | Employee belongs to a church-tax levying religious community (computes the church-tax base BK). |
| church_tax_rate | number | No | Church tax rate in percent set by the state law (8 or 9) to compute the church tax from the base; requires church_member. |
| health_insurance | string | No | statutory (GKV) or exclusively private health insurance (PKV). |
| health_additional_rate | number | No | Health fund specific additional contribution rate in percent (Zusatzbeitrag). Default: average rate 2026 of 2.9 % (BAnz AT 10.11.2025 B7). |
| private_basic_premium_monthly | number | No | Private basic health and care premium per month in EUR as reported for 2026 (PKPV); private insurance only. |
| employer_subsidy_monthly | number | No | Tax-free employer subsidy to the private premium per month in EUR (PKPVAGZ). |
| childless_surcharge | boolean | No | Employee pays the 0.6-point care surcharge for childless members aged 23 or over (§ 55(3) SGB XI). |
| children_under_25 | integer | No | Number of children under 25 counted for care-insurance discounts (0.25 points for the 2nd to 5th child, § 55(3) sentence 4 SGB XI). |
| saxony | boolean | No | Place of employment in Saxony (different split of care contributions, § 58(3) SGB XI). |
| pension_insurance | boolean | No | Compulsorily insured in statutory pension insurance or a professional pension scheme (KRV = 0). |
| unemployment_insurance | boolean | No | Compulsorily insured in unemployment insurance (ALV = 0). |
| allowance_per_period | number | No | Tax-free amount from ELStAM for the pay period in EUR (LZZFREIB). |
| addition_per_period | number | No | Addition amount from ELStAM for the pay period in EUR (LZZHINZU). |
| birth_date | string | No | Birth date; used for the age relief amount (Altersentlastungsbetrag) if the 64th year was completed before 2026. |
| pension | object | No | Pension payments (Versorgungsbezüge) contained in gross_wage. |
| one_off | object | No | One-off payment (sonstiger Bezug) taxed under § 39b(3) EStG. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"gross_wage",
"tax_class"
],
"properties": {
"year": {
"type": "integer",
"enum": [
2026
],
"default": 2026,
"description": "Calendar year of payment (only 2026 is implemented)."
},
"pay_period": {
"type": "string",
"enum": [
"year",
"month",
"week",
"day"
],
"default": "month",
"description": "Pay period (Lohnzahlungszeitraum)."
},
"gross_wage": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Taxable current wage for the pay period in EUR (RE4), before allowances; one-off payments go into one_off."
},
"tax_class": {
"type": "integer",
"minimum": 1,
"maximum": 6,
"description": "Tax class (Steuerklasse) I-VI."
},
"factor": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 0.999,
"description": "Factor of the factor procedure (§ 39f EStG, three decimals), tax class IV only."
},
"child_allowances": {
"type": "number",
"minimum": 0,
"maximum": 30,
"description": "Number of child allowances (Kinderfreibeträge) from ELStAM, in steps of 0.5 (classes I-IV only)."
},
"church_member": {
"type": "boolean",
"default": false,
"description": "Employee belongs to a church-tax levying religious community (computes the church-tax base BK)."
},
"church_tax_rate": {
"type": "number",
"enum": [
8,
9
],
"description": "Church tax rate in percent set by the state law (8 or 9) to compute the church tax from the base; requires church_member."
},
"health_insurance": {
"type": "string",
"enum": [
"statutory",
"private"
],
"default": "statutory",
"description": "statutory (GKV) or exclusively private health insurance (PKV)."
},
"health_additional_rate": {
"type": "number",
"minimum": 0,
"maximum": 10,
"description": "Health fund specific additional contribution rate in percent (Zusatzbeitrag). Default: average rate 2026 of 2.9 % (BAnz AT 10.11.2025 B7)."
},
"private_basic_premium_monthly": {
"type": "number",
"minimum": 0,
"maximum": 100000,
"description": "Private basic health and care premium per month in EUR as reported for 2026 (PKPV); private insurance only."
},
"employer_subsidy_monthly": {
"type": "number",
"minimum": 0,
"maximum": 100000,
"description": "Tax-free employer subsidy to the private premium per month in EUR (PKPVAGZ)."
},
"childless_surcharge": {
"type": "boolean",
"default": false,
"description": "Employee pays the 0.6-point care surcharge for childless members aged 23 or over (§ 55(3) SGB XI)."
},
"children_under_25": {
"type": "integer",
"minimum": 0,
"maximum": 20,
"default": 0,
"description": "Number of children under 25 counted for care-insurance discounts (0.25 points for the 2nd to 5th child, § 55(3) sentence 4 SGB XI)."
},
"saxony": {
"type": "boolean",
"default": false,
"description": "Place of employment in Saxony (different split of care contributions, § 58(3) SGB XI)."
},
"pension_insurance": {
"type": "boolean",
"default": true,
"description": "Compulsorily insured in statutory pension insurance or a professional pension scheme (KRV = 0)."
},
"unemployment_insurance": {
"type": "boolean",
"default": true,
"description": "Compulsorily insured in unemployment insurance (ALV = 0)."
},
"allowance_per_period": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Tax-free amount from ELStAM for the pay period in EUR (LZZFREIB)."
},
"addition_per_period": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Addition amount from ELStAM for the pay period in EUR (LZZHINZU)."
},
"birth_date": {
"type": "string",
"format": "date",
"description": "Birth date; used for the age relief amount (Altersentlastungsbetrag) if the 64th year was completed before 2026."
},
"pension": {
"type": "object",
"additionalProperties": false,
"required": [
"payments",
"first_full_month",
"start_year"
],
"description": "Pension payments (Versorgungsbezüge) contained in gross_wage.",
"properties": {
"payments": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Pension payments contained in gross_wage for the pay period (VBEZ, EUR)."
},
"first_full_month": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Pension for January 2005 or the first full month (VBEZM, EUR)."
},
"special_payments_start_year": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Expected special pension payments in the year of the first payment (VBEZS, EUR)."
},
"start_year": {
"type": "integer",
"minimum": 1900,
"maximum": 2026,
"description": "Year of the first pension payment (VJAHR)."
},
"months": {
"type": "integer",
"minimum": 1,
"maximum": 12,
"description": "Months with pension payments; annual pay period only (ZMVB)."
}
}
},
"one_off": {
"type": "object",
"additionalProperties": false,
"required": [
"amount",
"expected_annual_wage"
],
"description": "One-off payment (sonstiger Bezug) taxed under § 39b(3) EStG.",
"properties": {
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100000000,
"description": "One-off payment in EUR (SONSTB)."
},
"expected_annual_wage": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Expected annual wage without this payment, including earlier one-off payments (JRE4, EUR)."
},
"compensation_part": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Part of amount that is compensation under § 24 no. 1 EStG (SONSTENT, EUR)."
},
"annual_compensation_in_expected": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Compensation contained in expected_annual_wage (JRE4ENT, EUR)."
},
"annual_allowance": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Annual tax-free amount from ELStAM (JFREIB, EUR)."
},
"annual_addition": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Annual addition amount from ELStAM (JHINZU, EUR)."
},
"pension_in_expected_wage": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Pension payments contained in expected_annual_wage (JVBEZ, EUR)."
},
"pension_in_amount": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Pension payments contained in the one-off amount (VBS, EUR)."
}
}
}
}
}Published input example
{
"pay_period": "month",
"gross_wage": 4000,
"tax_class": 1,
"health_additional_rate": 2.9
}Result & documentation
Machine-readable documentation of this hub
Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.
More endpoints in this hub
- Rechenwerk0.003 USDC
ai act risk class
POSThttps://rechen.halowerk.com/v1/ai-act-risk-classEvaluates the caller’s description against Regulation (EU) 2024/1689 as amended by Regulation (EU) 2026/1744: prohibited practices of Art. 5(1)(a)-(h) and the new points (ba) and (bb) (from 2 December 2026); high-risk under Art. 6(1) (safet
- Rechenwerk0.002 USDC
annuity schedule
POSThttps://rechen.halowerk.com/v1/annuity-scheduleMonthly annuity in arrears as used by German banks: rate = loan × (nominal rate + initial repayment rate) / 12, or from a term via A = L·q^n·(q−1)/(q^n−1) with q = 1 + i/12; interest each month = balance × i/12 (30/360), rounded to cents, t
- Rechenwerk0.002 USDC
appeal deadlines
POSThttps://rechen.halowerk.com/v1/appeal-deadlinesCovers only clearly codified periods: Berufung one month and grounds two months (§§ 517, 520(2) ZPO), Revision one and two months (§§ 548, 551(2) ZPO), labour court appeal (§ 66(1) ArbGG), all starting with service of the complete judgment