Rechenwerk
surcharge tax free
Splits each shift (German local time, real elapsed minutes across daylight-saving changes, explicit breaks removed) at 0, 4, 6, 14, 20 and 24 h and applies § 3b EStG: night work 20-6 h 25 %, 0-4 h 40 % if the work began before midnight; Sunday 50 %; public holidays at the workplace and 31 December from 14 h 125 %; 24 December from 14 h, 25/26 December and 1 May 150 %; 0-4 h of the following day counts as Sunday or holiday work if begun before midnight; night and Sunday/holiday rates add up,.
POST https://rechen.halowerk.com/v1/surcharge-tax-freeInputs
| Field | Type | Required | Description |
|---|---|---|---|
| base_hourly_wage | number | Yes | Grundlohn: regular wage converted to EUR per hour (§ 3b(2) EStG). |
| state | string | No | Federal state of the workplace whose public holidays apply (e.g. NW, BY, BE). Without state only nationwide holidays are used. |
| region | string | No | Optional sub-region with extra holidays (requires state): BY A=Augsburg, KATH=predominantly Catholic municipalities, EVANG; SN BZ=Bautzen; TH EIC, UH, WAK. |
| shifts | array | Yes | Worked shifts in German local time. |
| paid_percent | object | No | Surcharges actually paid, in percent of the base wage; omit to get only the maxima. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"base_hourly_wage",
"shifts"
],
"properties": {
"base_hourly_wage": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10000,
"description": "Grundlohn: regular wage converted to EUR per hour (§ 3b(2) EStG)."
},
"state": {
"type": "string",
"enum": [
"BB",
"BE",
"BW",
"BY",
"HB",
"HE",
"HH",
"MV",
"NI",
"NW",
"RP",
"SH",
"SL",
"SN",
"ST",
"TH"
],
"description": "Federal state of the workplace whose public holidays apply (e.g. NW, BY, BE). Without state only nationwide holidays are used."
},
"region": {
"type": "string",
"enum": [
"A",
"KATH",
"EVANG",
"BZ",
"EIC",
"UH",
"WAK"
],
"description": "Optional sub-region with extra holidays (requires state): BY A=Augsburg, KATH=predominantly Catholic municipalities, EVANG; SN BZ=Bautzen; TH EIC, UH, WAK."
},
"shifts": {
"type": "array",
"minItems": 1,
"maxItems": 200,
"description": "Worked shifts in German local time.",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"start",
"end"
],
"properties": {
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Local start, e.g. 2026-11-07T22:00."
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Local end (may be on the next day)."
},
"breaks": {
"type": "array",
"maxItems": 10,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"start",
"end"
],
"properties": {
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"
}
}
},
"description": "Unpaid breaks inside the shift."
}
}
}
},
"paid_percent": {
"type": "object",
"additionalProperties": false,
"description": "Surcharges actually paid, in percent of the base wage; omit to get only the maxima.",
"properties": {
"night": {
"type": "number",
"minimum": 0,
"maximum": 500
},
"sunday": {
"type": "number",
"minimum": 0,
"maximum": 500
},
"holiday": {
"type": "number",
"minimum": 0,
"maximum": 500
},
"special_holiday": {
"type": "number",
"minimum": 0,
"maximum": 500,
"description": "Rate paid for the 150 % days; defaults to holiday."
}
}
}
}
}Published input example
{
"base_hourly_wage": 20,
"state": "NW",
"shifts": [
{
"start": "2026-11-07T22:00",
"end": "2026-11-08T06:00"
}
]
}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