Skip to content
HALOWERK

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-tax

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
yearintegerNoCalendar year of payment (only 2026 is implemented).
pay_periodstringNoPay period (Lohnzahlungszeitraum).
gross_wagenumberYesTaxable current wage for the pay period in EUR (RE4), before allowances; one-off payments go into one_off.
tax_classintegerYesTax class (Steuerklasse) I-VI.
factornumberNoFactor of the factor procedure (§ 39f EStG, three decimals), tax class IV only.
child_allowancesnumberNoNumber of child allowances (Kinderfreibeträge) from ELStAM, in steps of 0.5 (classes I-IV only).
church_memberbooleanNoEmployee belongs to a church-tax levying religious community (computes the church-tax base BK).
church_tax_ratenumberNoChurch tax rate in percent set by the state law (8 or 9) to compute the church tax from the base; requires church_member.
health_insurancestringNostatutory (GKV) or exclusively private health insurance (PKV).
health_additional_ratenumberNoHealth fund specific additional contribution rate in percent (Zusatzbeitrag). Default: average rate 2026 of 2.9 % (BAnz AT 10.11.2025 B7).
private_basic_premium_monthlynumberNoPrivate basic health and care premium per month in EUR as reported for 2026 (PKPV); private insurance only.
employer_subsidy_monthlynumberNoTax-free employer subsidy to the private premium per month in EUR (PKPVAGZ).
childless_surchargebooleanNoEmployee pays the 0.6-point care surcharge for childless members aged 23 or over (§ 55(3) SGB XI).
children_under_25integerNoNumber of children under 25 counted for care-insurance discounts (0.25 points for the 2nd to 5th child, § 55(3) sentence 4 SGB XI).
saxonybooleanNoPlace of employment in Saxony (different split of care contributions, § 58(3) SGB XI).
pension_insurancebooleanNoCompulsorily insured in statutory pension insurance or a professional pension scheme (KRV = 0).
unemployment_insurancebooleanNoCompulsorily insured in unemployment insurance (ALV = 0).
allowance_per_periodnumberNoTax-free amount from ELStAM for the pay period in EUR (LZZFREIB).
addition_per_periodnumberNoAddition amount from ELStAM for the pay period in EUR (LZZHINZU).
birth_datestringNoBirth date; used for the age relief amount (Altersentlastungsbetrag) if the 64th year was completed before 2026.
pensionobjectNoPension payments (Versorgungsbezüge) contained in gross_wage.
one_offobjectNoOne-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)."
        }
      }
    }
  }
}

Open original schema

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

All endpoints in this hub →