Rechenwerk
heating cost split
For combined systems the hot water share of the total costs is determined from the fuel or energy share (§ 9(1) HeizkostenV): given directly, from a heat meter, from the formula Q = 2.5 × V × (tw − 10) kWh (§ 9(2) sentence 2, × 1.11 for gross-calorific gas billing, ÷ 1.15 for heat delivery, × 0.30 for monovalent heat pumps) or Q = 32 × living area, converted to fuel by B = Q / Hi with the supplier heating value or the auxiliary values of § 9(3) (e.g. heating oil 10 kWh/l, natural gas H 10.
POST https://rechen.halowerk.com/v1/heating-cost-splitInputs
| Field | Type | Required | Description |
|---|---|---|---|
| total_costs | number | Yes | Total costs of the central heating (and hot water) system for the period in EUR (§ 7(2), § 8(2)). |
| hot_water | object | No | Hot water part of a combined system; omit for heating only. |
| heating_consumption_percent | number | No | Share of heating costs allocated by recorded consumption (§ 7(1)). |
| mandatory_70_percent | boolean | No | Building below the 1994 thermal insulation ordinance, oil or gas heating, mostly insulated pipes (§ 7(1) sentence 2). |
| no_remote_reading | boolean | No | No remote-readable metering although required, or missing consumption information (§ 12(1) sentences 2-3: 3 % reduction). |
| units | array | Yes | Units with area and recorded consumption. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"total_costs",
"units"
],
"properties": {
"total_costs": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000,
"description": "Total costs of the central heating (and hot water) system for the period in EUR (§ 7(2), § 8(2))."
},
"hot_water": {
"type": "object",
"additionalProperties": false,
"required": [
"method"
],
"description": "Hot water part of a combined system; omit for heating only.",
"properties": {
"method": {
"type": "string",
"enum": [
"cost_given",
"heat_meter",
"volume_formula",
"area_formula"
],
"description": "cost_given = hot water costs known; heat_meter = measured kWh; volume_formula = § 9(2) sentence 2; area_formula = § 9(2) sentence 4."
},
"cost": {
"type": "number",
"minimum": 0,
"maximum": 1000000000,
"description": "cost_given: hot water costs in EUR."
},
"heat_kwh": {
"type": "number",
"minimum": 0,
"maximum": 1000000000,
"description": "heat_meter: measured heat for hot water in kWh."
},
"volume_m3": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "volume_formula: measured hot water volume V in m³."
},
"temperature_c": {
"type": "number",
"minimum": 10.1,
"maximum": 100,
"description": "volume_formula: mean hot water temperature tw in °C."
},
"area_m2": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "area_formula: living area supplied with hot water."
},
"energy_adjustment": {
"type": "string",
"enum": [
"none",
"gas_gross_calorific",
"heat_delivery",
"heat_pump"
],
"default": "none",
"description": "Factor of § 9(2) sentence 5: × 1.11, ÷ 1.15 or × 0.30."
},
"fuel": {
"type": "string",
"enum": [
"heating_oil_el",
"heating_oil_heavy",
"natural_gas_h",
"natural_gas_l",
"lpg",
"coke",
"lignite",
"hard_coal",
"firewood",
"energy_kwh"
],
"default": "energy_kwh",
"description": "Unit of the total consumption: a fuel with auxiliary heating value (§ 9(3)) or energy in kWh."
},
"heating_value": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100,
"description": "Heating value Hi from the supplier invoice (kWh per unit), overrides the auxiliary value."
},
"total_consumption": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10000000000,
"description": "Total fuel (litres, m³, kg) or energy (kWh) of the period for heating and hot water."
},
"consumption_percent": {
"type": "number",
"minimum": 50,
"maximum": 70,
"default": 70,
"description": "Share of hot water costs allocated by consumption (§ 8(1))."
}
}
},
"heating_consumption_percent": {
"type": "number",
"minimum": 50,
"maximum": 70,
"default": 70,
"description": "Share of heating costs allocated by recorded consumption (§ 7(1))."
},
"mandatory_70_percent": {
"type": "boolean",
"default": false,
"description": "Building below the 1994 thermal insulation ordinance, oil or gas heating, mostly insulated pipes (§ 7(1) sentence 2)."
},
"no_remote_reading": {
"type": "boolean",
"default": false,
"description": "No remote-readable metering although required, or missing consumption information (§ 12(1) sentences 2-3: 3 % reduction)."
},
"units": {
"type": "array",
"minItems": 1,
"maxItems": 500,
"description": "Units with area and recorded consumption.",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"area_m2",
"heat_units"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Unit reference."
},
"area_m2": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000,
"description": "Living or usable area."
},
"heat_units": {
"type": "number",
"minimum": 0,
"maximum": 1000000000,
"description": "Recorded heat consumption (meter or allocator units)."
},
"hot_water_m3": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Recorded hot water consumption in m³."
}
}
}
}
}
}Published input example
{
"total_costs": 10000,
"units": [
{
"id": "A",
"area_m2": 60,
"heat_units": 300
},
{
"id": "B",
"area_m2": 40,
"heat_units": 100
}
]
}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