Skip to content
Preview of the Betriebskostenabrechnung (utility cost statement) template

210 × 297 mm

Real estate

Betriebskostenabrechnung (utility cost statement)

A German annual utility cost statement for one flat in a DIN 5008 letter layout: each cost type is split by its allocation key (floor area, water meter, persons, units), heating costs come from the metering service, and the balance against the prepayments shows as a payment due or a refund.

PDFA4 portraitLocale de-DEHTML + JinjaHeader & footer

Opens Dynamic Document API with this template preloaded in a free workspace.

Template language features

  • Loops
  • Conditionals
  • Macros
  • Filters
  • Currency formatting
  • Date formatting
  • Number formatting
  • Repeating table headers
  • Header & footer
  • Page numbers

Filters such as format_currency and qrcode are described in the template language reference.

Variables

Derived from the sample data: 9 top-level fields, 59 paths in total. Send the same shape as data.

PathTypeExample
managerobject
manager.namestring"Brookhoff Hausverwaltung GmbH"
manager.short_namestring"Brookhoff Hausverwaltung"
manager.streetstring"Am Kanalufer 9"
manager.postcodestring"22303"
manager.citystring"Hamburg"
manager.phonestring"+49 40 66969 040"
manager.emailstring"abrechnung@brookhoff.example.com"
manager.websitestring"brookhoff.example.com"
manager.registerstring"Amtsgericht Hamburg, HRB 123456"
manager.managing_directorstring"Jasper Brookhoff"
manager.vat_idstring"DE123456789"
manager.ibanstring"DE00 EXMP 0000 0045 6789 01"
manager.bicstring"EXMPDEHHXXX"
manager.office_hoursstring"Mo–Do 9–16 Uhr, Fr 9–13 Uhr"
contactobject
contact.namestring"Merle Tiedemann"
contact.phonestring"+49 40 66969 047"
contact.emailstring"m.tiedemann@brookhoff.example.com"
landlordstring"Eigentümergemeinschaft Holunderstieg 12–14"
propertyobject
property.referencestring"HOL-12"
property.addressstring"Holunderstieg 12–14, 22083 Hamburg"
property.unitsnumber18
tenancyobject
tenancy.tenant_numberstring"M-0314-07"
tenancy.unitstring"Holunderstieg 14, 3. OG links (Whg. 07)"
tenancy.tenantsarray<object> · 2
tenancy.tenants[].salutationstring"Frau"
tenancy.tenants[].first_namestring"Leonie"
tenancy.tenants[].last_namestring"Hartwig"
tenancy.streetstring"Holunderstieg 14"
tenancy.postcodestring"22083"
tenancy.citystring"Hamburg"
statementobject
statement.datedate"2026-09-21"
statement.period_startdate"2025-01-01"
statement.period_enddate"2025-12-31"
statement.payment_daysnumber30
statement.monthly_prepaymentnumber215
statement.months_paidnumber12
statement.new_monthly_prepaymentnumber225
statement.new_prepayment_fromdate"2026-11-01"
allocation_keysarray<object> · 4
allocation_keys[].idstring"area"
allocation_keys[].labelstring"Wohnfläche"
allocation_keys[].unitstring"m²"
allocation_keys[].decimalsnumber2
allocation_keys[].totalnumber1386.5
allocation_keys[].sharenumber74.6
costsarray<object> · 13
costs[].namestring"Grundsteuer"
costs[].totalnumber3186.4
costs[].keystring"area"
costs[].tax_35a?string"service"
heatingobject
heating.labelstring"Heiz- und Warmwasserkosten"
heating.notestring"lt. Einzelabrechnung des Messdienstes"
heating.amountnumber846.27

Render it with the API

After adding the template to your workspace, render it by ID and pass your data. Arrays are shortened here.

curl -X POST https://api-eu.dynamicdocumentapi.com/v1/renders \
  -H "Authorization: Bearer $DYNAMIC_DOCUMENT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "type": "template",
    "template_id": "tpl_01J9ZK3M7Q8V5W2X4Y6Z8A0B1C"
  },
  "data": {
    "manager": {
      "name": "Brookhoff Hausverwaltung GmbH",
      "short_name": "Brookhoff Hausverwaltung",
      "street": "Am Kanalufer 9",
      "postcode": "22303",
      "city": "Hamburg",
      "phone": "+49 40 66969 040",
      "email": "abrechnung@brookhoff.example.com",
      "website": "brookhoff.example.com",
      "register": "Amtsgericht Hamburg, HRB 123456",
      "managing_director": "Jasper Brookhoff",
      "vat_id": "DE123456789",
      "iban": "DE00 EXMP 0000 0045 6789 01",
      "bic": "EXMPDEHHXXX",
      "office_hours": "Mo–Do 9–16 Uhr, Fr 9–13 Uhr"
    },
    "contact": {
      "name": "Merle Tiedemann",
      "phone": "+49 40 66969 047",
      "email": "m.tiedemann@brookhoff.example.com"
    },
    "landlord": "Eigentümergemeinschaft Holunderstieg 12–14",
    "property": {
      "reference": "HOL-12",
      "address": "Holunderstieg 12–14, 22083 Hamburg",
      "units": 18
    },
    "tenancy": {
      "tenant_number": "M-0314-07",
      "unit": "Holunderstieg 14, 3. OG links (Whg. 07)",
      "tenants": [
        {
          "salutation": "Frau",
          "first_name": "Leonie",
          "last_name": "Hartwig"
        },
        {
          "salutation": "Herr",
          "first_name": "Can",
          "last_name": "Yilmaz"
        }
      ],
      "street": "Holunderstieg 14",
      "postcode": "22083",
      "city": "Hamburg"
    },
    "statement": {
      "date": "2026-09-21",
      "period_start": "2025-01-01",
      "period_end": "2025-12-31",
      "payment_days": 30,
      "monthly_prepayment": 215,
      "months_paid": 12,
      "new_monthly_prepayment": 225,
      "new_prepayment_from": "2026-11-01"
    },
    "allocation_keys": [
      {
        "id": "area",
        "label": "Wohnfläche",
        "unit": "m²",
        "decimals": 2,
        "total": 1386.5,
        "share": 74.6
      },
      {
        "id": "water",
        "label": "Wasserverbrauch",
        "unit": "m³",
        "decimals": 1,
        "total": 1536,
        "share": 84.6
      }
    ],
    "costs": [
      {
        "name": "Grundsteuer",
        "total": 3186.4,
        "key": "area"
      },
      {
        "name": "Wasserversorgung",
        "total": 3456,
        "key": "water"
      }
    ],
    "heating": {
      "label": "Heiz- und Warmwasserkosten",
      "note": "lt. Einzelabrechnung des Messdienstes",
      "amount": 846.27
    }
  },
  "output": {
    "format": "pdf",
    "filename": "utility-cost-statement.pdf"
  }
}'