Zum Hauptinhalt springen

§14a Netzentgelte (Modul 3) Smart-Home-Integration, kostenlos und Open Source

§14a Netzentgelte (Modul 3)-Integration für Gladys Assistant

Unofficial: German time-variable grid fees §14a EnWG Modul 3 (HT/ST/NT) as an energy contract.

Auf GitHub ansehenAlle Integrationen
Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

Unofficial integration, not affiliated with any grid operator, nor with the Bundesnetzagentur. Never tested with a real Gladys energy contract yet.

In Germany, a heat pump, a wallbox, an air conditioner or a home battery of more than 4.2 kW steered by the grid operator under §14a EnWG gets a reduced grid fee. With Modul 3 (on top of Modul 1), the grid fee per kWh also changes with the time of day, in three levels:

  • HT (Hochlasttarif, high), in the evening peak for instance;
  • ST (Standardtarif), the rest of the day;
  • NT (Niedertarif, low), at night or at midday.

Each grid operator sets its own windows, for the quarters of the year where Modul 3 applies (often Q1 and Q4, sometimes all year); in the other quarters, the standard price applies.

This integration adds an energy contract to Gladys: it prices every half hour of your meter with your operator's grid fee in force then.

Data source and attribution​

The prices and windows come from the Par14a-Database (the78mole), https://github.com/the78mole/Par14a-Database, licence: CC BY 4.0, read from the price sheets the operators publish under the EnWG (operator master data from vnbdigital.de).

  • The 2027 sheets are provisional (vorläufig): the operators publish the final ones by the end of the year. The status of the integration says, per year, how many sheets are provisional, the date the data was published and when it was last checked; the current price of a contract shows "(provisional)" and the date the sheet was read.
  • The data is provided without warranty: your operator's own price sheet prevails. A cost already computed is not recomputed when a sheet changes (see "Limits").
  • Changes made to the data: the windows are turned into quarter-hour levels, the VAT and your supplement are added (details in THIRD_PARTY_NOTICES.md).

The integration downloads the yearly files of the Par14a-Database web page (about 1 MB each, the years it lists, 6 at most) once a day, with a conditional request (nothing is downloaded when nothing changed), and keeps them in its /data volume. Pricing uses what is held: it never waits for the network.

Setup​

  1. Install the integration from the store. It has no configuration: the configuration screen shows its status and a button.
  2. Find your grid operator (Netzbetreiber, on your electricity bill, not your supplier): type part of its name, its town or its postcode in Find my grid operator and press it. The answer lists the matching operators with their ID, the sheet of the year (final or provisional, the date it was read), the HT / ST / NT prices (net) and the Modul 3 quarters. The postcode and town are those of the operator's head office, not of your home.
  3. In Energy → Contracts, create a contract from the template "§14a Modul 3 grid fee (Germany)" on the meter of your §14a device (a separate meter with Modul 3, or your main meter), and fill in:
    • Grid operator (ID or name): the ID given by the button (e.g. 7214), or the exact name; a part of a name works only while it matches a single operator;
    • VAT on the grid fee (19 % by default; 0 keeps the net prices);
    • Supplement per kWh (ct/kWh, 0 by default): everything else your supplier bills per kWh (energy, levies, electricity tax), VAT included, added as you type it;
    • Fixed amount per month (EUR, 0 by default, 0 to 1000): the base prices per month (grid and supplier), VAT included; Gladys computes it. The Modul 1 reduction cannot be deducted: for most operators it is larger than the grid base price, and Gladys refuses a negative amount. Leave it out; the costs shown are then above your bill by that reduction (see "Limits").

How a half hour is priced​

  • The windows are wall-clock times in German time (CET in winter, CEST in summer), whatever the timezone of Gladys. On the spring change day the quarter hours from 02:00 to 02:45 do not exist; on the autumn change day the hour from 02:00 to 03:00 happens twice, and both are priced by their wall-clock time.
  • The windows of the sheets are on the quarter-hour grid (17:15, 19:45…), the meter data on the half hour: each half hour is priced as two quarter hours of half its energy (consumption assumed even within the half hour).
  • The sheet used is the one of the German year of the quarter hour: the night of 31 December switches to the next year's sheet at midnight German time.
  • Cost = grid fee × (1 + VAT) + supplement, per kWh, in EUR. Gladys adds the fixed amount per month.
  • The current price (dashboard price widget, "current price" scene condition) is the price of the current quarter hour, with the time of the next change and the next price.

Limits​

  • Working days: a few sheets limit HT / NT to working days (the database only notes it in a comment). The integration prices every day with the windows, and says so in the status and in the search answer for the operators concerned. Public holidays are not handled either.
  • Data missing: a year not in the database (2025 and before, 2028 before it is published), an operator without a usable Modul 3 sheet, or an operator name matching several operators: the half hours are not priced (never priced at 0); Gladys tries again at its next run, and catches up once the data is there. The status counts the contracts whose operator is not found.
  • Billing day: Gladys asks for the costs of one billing period at a time, all or nothing. With a billing day other than the 1st, the December half hours of a period running past 1 January also wait for the next year's sheet.
  • Modul 1 reduction: it cannot be entered (a negative fixed amount is refused by Gladys); the costs shown exceed the bill by it.
  • Sheet updates: when a provisional sheet becomes final, the half hours priced before keep their cost.
  • Labels: a half hour whose two quarter hours differ is labelled with both, e.g. ST/HT for 17:00-17:30 with HT from 17:15.
  • The prices of the database are the grid fees only: the energy price of your supplier, the levies and the taxes go in the supplement.

Status messages​

  • "PROVISIONAL" / "n provisional": the share of provisional sheets of a year.
  • "Last check failed …; next try …": the page did not answer (tried again after 5, 15, 30, 60 minutes, then every 3 hours), asked to slow down (429: paused for the time it asks, between 1 minute and 6 hours), or sent a list of years that does not read (jahre.json; the data held stays in use). A refused year file is not a failed check: see the next line.
  • "2028: no sheet published yet": the source opened a year without any sheet; not an error. "2027: the file was refused (…)": a new file of that year did not read; the data held for it stays in use, the other years are updated, and the file is asked again (conditionally) at the next daily check.
  • "2026: kept in memory only": the year does not fit in the /data state file (16 MB at most, the most recent years first); at the next start it is downloaded again at once (once an hour at most, never during a 429 pause), without waiting for the daily check.
  • "The data cannot be written to /data": a write failed or took more than 10 seconds; the data stays in memory and is downloaded again after a restart.
  • "The saved data in /data cannot be read": the volume of the integration is broken; read again every 10 seconds, nothing is downloaded meanwhile.

Privacy​

No account, no personal data: the integration only downloads public files, with its own User-Agent. Your contract inputs stay in Gladys.

Konfigurationseinstellungen​

Diese Einstellungen fragt §14a Netzentgelte (Modul 3) in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
§14a EnWG Modul 3 grid feessectionNeinUnofficial, not affiliated with any grid operator. For a heat pump, wallbox or battery steered under §14a EnWG with Modul 3, the grid fee per kWh changes with the time of day: HT (high), ST (standard), NT (low), in the windows and quarters of your grid operator. This integration adds the "§14a Modul 3 grid fee" energy contract: create it in Energy → Contracts, type your grid operator (use the button below to find its ID), and Gladys prices every half hour. Data: Par14a-Database (the78mole), CC BY 4.0, read from the operators' price sheets; the 2027 sheets are PROVISIONAL (vorläufig) until the operators publish the final ones, and the status below dates the data. The operator's own price sheet always prevails.

So installierst du §14a Netzentgelte (Modul 3) in Gladys​

  1. Öffne in Gladys Integrationen: §14a Netzentgelte (Modul 3) erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/lm1lc3n7/gladys-netzentgelte-14a:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-netzentgelte-14a.

§14a Netzentgelte (Modul 3) benötigt Gladys >=5.3.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

§14a Netzentgelte (Modul 3) ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am