Was bietet die Simplifier API?
Der Simplifier fungiert als Abstraktionsschicht über bestehende APIs der GET AG und ermöglicht es, komplexe fachliche Abläufe über einen stark vereinfachten Zugriff bereitzustellen. Dadurch können neue Produkte schneller umgesetzt, Integrationskosten reduziert und wiederkehrende Logik zentral gesteuert werden – ohne dass jedes Produkt die technische Komplexität selbst abbilden muss.
Vorteile der Simplifier API
Für Entwickler
-
Deutlich weniger API-Aufrufe
-
Reduzierte Komplexität in der Client-Implementierung
-
Keine manuelle Orchestrierung mehrerer Services notwendig
-
Schnellere Client-Generierung
-
Geringerer Wartungs- und Testaufwand
Für Plattform- & Produktteams
-
Einheitliche Logik zur Netzbetreiberermittlung
-
Weniger Fehlerquellen durch zentrale Orchestrierung
-
Schnellere Time-to-Market neuer Produkte
Technisch & organisatorisch
-
Kapselung interner Service-Abhängigkeiten
-
Bessere Erweiterbarkeit für zukünftige Services
-
Zentrale Stelle für Optimierungen und Anpassungen
-
Saubere Trennung zwischen Fach- und Client-Logik
Anwendungsfälle
Historische Visualisierung dynamischer Stromtarife mit individuellen Smart-Meter-Verbräuchen
Energieversorger stehen vor der Herausforderung, dynamische Stromtarife für den Endkunden verständlich und nachvollziehbar darzustellen – insbesondere in Kombination mit individuellen Verbrauchsdaten aus Smart Metern sowie Modul-3-Netzentgelten (§14a EnWG).
Mit dem GET AG Simplifier können EVU ihren Endkunden im bestehenden Kundenportal oder Home-Energy-Management-System (HEMS) eine viertelstündliche Preisvisualisierung des dynamischen Stromtarifs mit allen Preiskomponenten mit den individuellen Verbräuchen des Endkunden bereitstellen. Dabei verknüpfen Sie die in Ihrem System vorhandenen Smart-Meter-Verbrauchsdaten mit den viertelstündlich aufgelösten Preiskomponenten aus unserer API.
Der Endkunde erhält damit einen historischen Preisverlauf, der:
-
den tatsächlichen individuellen Verbrauch berücksichtigt,
-
dynamische Stromtarife mit oder ohne Modul 3 abbildet,
- die Steuern, Abgaben, Umlagen, Netzentgelte beinhaltet
-
und transparent zeigt, wann Strom günstig oder teuer war.
Ziel ist es, dem Endkunden eine fundierte Entscheidungsgrundlage zu geben, um:
-
das eigene Verbrauchsverhalten besser zu verstehen,
-
Lasten gezielt zu verschieben,
-
und langfristig von dynamischen Tarifen zu profitieren.
Für diesen Anwendungsfall nutzen Sie bitte folgende Endpunkte, deren Parameter in der weiter unten verlinkten SwaggerUI näher beschrieben sind:
- für dynamische Stromtarife mit Standardnetzentgelt:
- GET /simplifier/exchangeenergy/quarterly/actions/tariffcalculation
- für dynamische Stromtarife mit zeitvariablen Netzentgelt (Modul 3):
- GET/simplifier/exchangeenergy/quarterly/actions/tariffcalculationdynamicgridfee
Voraussetzungen & Rahmenbedingungen
-
EPEX SPOT Lizenz erforderlich (je nach Nutzung ggf. Zusatzoption für öffentliche Websitebereiche)
-
Dynamischer Stromtarif muss bei GET AG hinterlegt sein
Darstellung dynamischer Stromtarife mit Day-ahead-Preisen der EPEX Spot und zeitvariablen Netzentgelten
Im Zuge der seit 2025 verpflichtend anzubietenden dynamischen Stromtarife benötigen Versorger viertelstundengenaue, tarif- und lokationsspezifische Gesamtarbeitspreisdaten, bspw. um ihren Endkunden übersichtlich die täglichen Preisverläufe zu visualisieren. Aber auch für historische Abrechnungen und Reportings sind diese Verschnittdaten unerlässlich.
Ein Versorger kann so:
- Kunden dynamischer Tarife eine Informationsplattform bieten, welche täglich von diesen aufgesucht wird,
- entsprechend verschiedenste, begleitende Marketingaktionen durchführen,
- potentielle Neukunden dynamischer Tarife informieren und akquirieren und
- interne Prozesse wie Stromabrechnungen optimieren.
Für Endkunden bieten diese Daten:
- die Erschließung eines Potentials zur kosteneffizienteren Nutzung großer Stromverbraucher,
- letztlich ein stabileres Gesamtnetz und einen Schritt hin zu einer erfolgreichen Energiewende.
Für diese und weitere Use Cases bieten sich die folgenden Methoden an, welche in der entsprechenden Swagger UI genauer beschrieben sind:
- für die reinen Day-ahead-Börsenpreise der EPEX Spot:
- GET /simplifier/exchangeenergy
- GET /simplifier/exchangeenergy/quarterly
- für dynamische Stromtarife mit Standardnetzentgelt:
- GET /simplifier/exchangeenergy/actions/tariffcalculation
- GET /simplifier/exchangeenergy/quarterly/actions/tariffcalculation
- für dynamische Stromtarife mit zeitvariablen Netzentgelt (Modul 3):
- GET/simplifier/exchangeenergy/quarterly/actions/tariffcalculationdynamicgridfee
Voraussetzungen & Rahmenbedingungen
-
EPEX SPOT Lizenz erforderlich (je nach Nutzung ggf. Zusatzoption für öffentliche Websitebereiche)
-
Dynamischer Stromtarif muss bei GET AG hinterlegt sein
Tarifrechner für Ermittlung eines Tarifranking bis zur Hausnummerebene
Ausgangssituation im Tarifrechner
Ein moderner Strom- oder Gastarifrechner muss Tarife standortgenau vergleichen und ranken. Spätestens auf der Hausnummerebene entscheidet das jeweilige Netzgebiet darüber,
-
welche Netzentgelte gelten
-
und wie belastbar das Tarifranking tatsächlich ist
Für ein korrektes und vergleichbares Ranking ist daher eine eindeutige Zuordnung der Lokation zum Netzbetreiber zwingend erforderlich – getrennt nach Strom und Gas.
Herausforderung ohne Simplifier
Ohne den Simplifier müsste ein Tarifrechner:
-
die eingegebene Adresse (inkl. Hausnummer) über den GET AG Ortsinfo-Webservice auflösen,
-
den zuständigen Netzbetreiber je Sparte (Strom / Gas) selbst ermitteln,
-
sich die ermittelten Identifikatoren (z. B. Verbandsnummer) merken
-
anschließend den Strom- bzw. Gastarifwebservice 2.0 gezielt mit diesen ermittelten Verbandsnummer ansprechen und
-
die Ergebnisse logisch zusammenführen und für das Ranking aufbereiten.
Diese mehrstufige Logik erhöht:
-
den Implementierungsaufwand im Tarifrechner
-
die Fehleranfälligkeit bei Adress- und Netzbetreiberzuordnung
-
sowie die Komplexität der Produktpflege
Ablauf im Tarifranking (vereinfacht)
-
Nutzer gibt Adresse inkl. Hausnummer im Tarifrechner ein
-
Tarifrechner ruft diesen Simplifier-Endpunkt auf:
- /simplifier/locationTariffCalc/static/energy für Strom oder
- /simplifier/locationTariffCalc/static/gas für Gas.
-
Der Simplifier:
-
nutzt intern den Ortsinfo-Webservice,
-
ermittelt den zuständigen Netzbetreiber für Strom und Gas,
-
liefert die relevanten Netzbetreiber-Verbandsnummer und das Tarifranking zurück.
-
SwaggerUI
Cliententwicklung - Hinweise für Softwareentwickler
Tipps für Softwareentwickler zur Clientgenerierung aus der OpenAPI-Beschreibung gibt es hier. Darüber hinaus empfehlen wir die technische Dokumentation zu lesen.
Testsystem
Info Datengrundlage Testsystem:
-
Es sind ausschließlich Postleitzahlen mit führender „0XXXX“ zulässig - z.B. 04129
-
EPEX-SPOT-Daten sind im Testsystem verfremdet, weil dafür eine separate Lizenz vorgewiesen werden muss
https://test.simplifier.getag-cloud.com/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config
Stagesystem - nur nach Beauftragung
https://stage.simplifier.getag-cloud.com/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config
Produktivsystem - nur nach Beauftragung
https://prod.simplifier.getag-cloud.com/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config
Kontaktformular
Mit dem Kontaktformular können Sie ein Angebot oder Zugang zum Testsystem der "Simplifier API" anfragen: