Skip to content
HALOWERK

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
base_hourly_wagenumberYesGrundlohn: regular wage converted to EUR per hour (§ 3b(2) EStG).
statestringNoFederal state of the workplace whose public holidays apply (e.g. NW, BY, BE). Without state only nationwide holidays are used.
regionstringNoOptional sub-region with extra holidays (requires state): BY A=Augsburg, KATH=predominantly Catholic municipalities, EVANG; SN BZ=Bautzen; TH EIC, UH, WAK.
shiftsarrayYesWorked shifts in German local time.
paid_percentobjectNoSurcharges 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."
        }
      }
    }
  }
}

Open original schema

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

All endpoints in this hub →