Elf Schnittstellen. Dieselben, die wir selbst benutzen.
ENIO ist API-first gebaut: Das Backend und die App greifen auf genau die Endpunkte zu, die Sie auch bekommen. Hier steht, welche davon es gibt und welche Daten damit fließen — vom einzelnen Ladevorgang über den Live-Zustand jedes Steckplatzes bis zum Tarif, den Sie zur Mittagszeit automatisch senken.
Es gibt keine zweite, schlechtere API für Kunden. Was die ENIO-Oberfläche kann, können Sie auch — mit denselben Endpunkten und denselben Daten.
REST über HTTPSOpenAPI-Spezifikation je SchnittstelleVersioniertRechte je Mandant
Katalog
Welche Schnittstelle wofür
Nach Aufgabe gefiltert oder durchsucht. Jede Karte sagt, wozu die Schnittstelle da ist, welche Daten damit ausgetauscht werden und welche Endpunkte es gibt.
11 APIs
Daten abholenv1.4.5 · OAS 2.0
Charge Detail Record API
Jeden abgeschlossenen und jeden laufenden Ladevorgang abholen — die Grundlage für Abrechnung, Reports und eigene Dashboards.
Damit tauschen Sie aus
Je Ladevorgang Start- und Endzeitpunkt, geladene Energie in kWh, Ladepunkt über die EVSE-ID, verwendete Ladekarte beziehungsweise Nutzer, angewandter Tarif, verrechneter Betrag und Dauer. Mit Pagination für lange Zeiträume und einer eigenen Ausprägung für die gerade aktiven Sessions. Authentifizierung über den Header x-auth.
GET/charge-detail-recordListe der Ladevorgänge, gefiltert und seitenweise
Daten abholenv1.7.2 · OAS 2.0
Chargeboxes Info & EVSE Status API
Den Bestand und den Live-Zustand aller Ladepunkte eines Mandanten lesen.
Damit tauschen Sie aus
Alle Ladestationen eines Mandanten mit Seriennummer, Hersteller und Modell, den zugeordneten EVSE-IDs, Steckertyp und Ladeleistung — dazu der Verbindungsstatus der Box und der Zustand jedes einzelnen Steckplatzes: frei, belegt, reserviert, in Störung. Damit bauen Sie eine eigene Ampel oder füttern ein bestehendes Monitoring.
GET/charge-boxes-infoAlle Ladeboxen eines Mandanten mit EVSE-Status
Daten abholenv1.11.1 · OAS 3.1
ChargeBox Status-Error API
Störungen und Ereignisse einer Ladebox sehen, quittieren und ins eigene Ticketsystem holen.
Damit tauschen Sie aus
Das Ereignis- und Fehlerprotokoll je Ladebox mit Zeitstempel und Fehlercode, die Liste aller Boxen eines Mandanten mit noch offenen, unquittierten Störungen, und die Quittierung einzeln oder gesammelt je Box. Zusätzlich lassen sich eigene Debug-Ereignisse einstellen.
GET/api/v1/eventEreignisse einer bestimmten Ladebox
POST/api/v1/eventEigenes Debug-Ereignis anlegen
GET/api/v1/event/unconfirmedBoxen mit offenen Störungen
Belege suchen und als Datei ausliefern — für die Buchhaltung oder ein Self-Service-Portal.
Damit tauschen Sie aus
Suche über die Kundenbelege nach Zeitraum, Kunde oder Transaktion, und die Ausgabe der Beleg-URL zum Download. Damit holt sich Ihre Buchhaltung die fiskalisierten Belege ohne Umweg über das Backend, und Kunden laden ihre Rechnung im eigenen Portal.
POST/api/v1/searches/receiptsBelege nach Suchkriterien
GET/api/v1/searches/receipts/urlsDownloadadresse eines Belegs
Daten abholen
OCPP Meter Value
Die Messwerte, die eine Ladestation während des Ladevorgangs meldet.
Damit tauschen Sie aus
Zählerwerte aus den OCPP-MeterValues: Zählerstand, aktuell abgegebene Leistung, Strom und Spannung, je nach Hardware auch der Ladezustand des Fahrzeugs. Grundlage für Lastkurven, Lastmanagementauswertungen und eichrechtliche Nachweise.
Steuernv1.8.0 · OAS 3.1
OCPP Messaging API
Befehle direkt an die Ladestation schicken — ohne sich auf das Backend einloggen zu müssen.
Damit tauschen Sie aus
OCPP-Kommandos an eine Ladebox: reservieren und stornieren, Verfügbarkeit eines Steckplatzes ändern, Konfigurationswerte setzen, den Autorisierungscache leeren, eine laufende Transaktion fernstoppen, Soft- oder Hard-Reset auslösen, eine Nachricht anfordern und den Stecker entriegeln. Dazu ein generischer Endpunkt für jeden beliebigen OCPP-Call.
POST/api/v1/OcppGenericBeliebiger OCPP-Call an eine Ladebox
POST/api/v1/OcppMessage/reserve-nowSteckplatz für eine ID reservieren
Die Schnittstelle hinter der ENIO App — alles, was ein Fahrer tut, lässt sich damit auch aus Ihrer eigenen Anwendung auslösen.
Damit tauschen Sie aus
Anmeldung und Nutzerprofil, Ladevorgang an einer EVSE-ID starten, stoppen und priorisieren, Kilometerstand zu einem Ladevorgang nachtragen, RFID-Karte sperren, Ladepunkt prüfen, reservieren und Reservierung stornieren, Preise zu einer EVSE-ID abrufen, Rechnungen listen und als PDF holen. Genau diese Endpunkte benutzt die ENIO App selbst.
GET/commands/{commandId}Ergebnis eines Kommandos abholen
GET/prices/{evseId}Preise zu einem Ladepunkt
GET/invoicesRechnungen des Nutzers
GET/invoices/{invoiceId}/pdfRechnung als PDF
Tarife & Preisev1.2.8 · OAS 3.1
Dynamic Pricing API
Tarife und Steuersätze programmatisch setzen — die Schnittstelle für dynamische Preise.
Damit tauschen Sie aus
Tarife mit Gültigkeitszeitraum, Version, Preisbestandteilen und Zuordnung anlegen, ändern, teilweise ändern und löschen; den zu einem Zeitpunkt gültigen Tarif abfragen; eine bestimmte Tarifversion gezielt lesen. Dieselben Operationen für Steuersätze. Damit senken Sie den Preis automatisch, wenn die PV-Anlage Überschuss liefert, statt sie abzuregeln.
GET/api/v1/tariffTarifliste, seitenweise und gefiltert
PATCH/api/v1/tax/{taxId}Steuersatz teilweise ändern
DELETE/api/v1/tax/{taxId}Steuersatz löschen
Tarife & Preisev1.0.0 · OAS 2.0
Vendor Basic Tariffs API
Die Grundtarife lesen, die für einen Mandanten hinterlegt sind.
Damit tauschen Sie aus
Alle Basistarife des Mandanten, zugeordnet über den Header x-vendor-id aus der Authentifizierung. Damit zeigt Ihre eigene Oberfläche dieselben Preise an, die auch an der Ladestation und in der App gelten.
GET/vendor-basic-tariffsAlle Grundtarife eines Mandanten
Kunden & Standortev1.0.0 · OAS 3.0
Charging Location API
Ladepunkte auf einer Karte darstellen — im eigenen Portal, in der eigenen App.
Damit tauschen Sie aus
Standorte innerhalb eines Kartenausschnitts, passend zur Zoomstufe gebündelt; die Detaildaten eines Standorts mit allen Ladepunkten, Leistungen und Verfügbarkeiten; die Suche über eine EVSE-ID; und der Ländercode zu einem Koordinatenpunkt. Das ist die Grundlage der Karte in der ENIO App.
GET/v1/map-locationsStandorte im Kartenausschnitt
GET/v1/map-locations/{locationId}Alle Ladepunkte eines Standorts
GET/v1/map-locations/search-by-evse-idStandort über die EVSE-ID finden
GET/v1/map-locations/find-country-code-by-pointLändercode zu einem Punkt
Kunden & Standortev1.3 · OAS 3.1
Customer Onboarding API
Nutzerkonten anlegen und pflegen, ohne dass jemand das Backend öffnet.
Damit tauschen Sie aus
Kundendatensätze mit Stammdaten und optionalen Zugangsdaten anlegen oder aktualisieren, Zugangsdaten eines bestehenden Kontos ändern, prüfen ob eine E-Mail-Adresse schon vergeben ist, und einen Kunden vollständig entfernen — in der Identitätsverwaltung und in ETSweb. Dazu ein Webhook, über den Ereignisse aus der Identitätsverwaltung zurückkommen. Damit hängt Ihr Mitarbeiterportal oder Ihr Onboardingprozess direkt an ENIO.
POST/api/v1/CustomersKunden anlegen oder aktualisieren
PUT/api/v1/CredentialsZugangsdaten ändern
GET/api/v1/Customers/check-emailE-Mail-Adresse auf Dubletten prüfen
POST/api/v1/KeycloakWebhookEreignisse der Identitätsverwaltung empfangen
Dazu passt nichts.
Zu jeder Schnittstelle gibt es eine vollständige OpenAPI-Spezifikation mit allen Feldern, Beispielantworten und Fehlercodes. Diese Übersicht ist die lesbare Fassung davon; maßgeblich ist die Spezifikation. Den Zugang zum API-Katalog, Ihren Token und eine Sandbox bekommen Sie gemeinsam mit Ihrem Mandanten — auf Wunsch schon vor Vertragsabschluss für eine technische Bewertung.
In der Praxis
Wofür Kunden die Schnittstellen nutzen
01Eigene Auswertung
Dashboard im eigenen BI
Ladevorgänge über die CDR-API in Power BI, Tableau oder ein eigenes Frontend — mit Ihren Kostenstellen und Ihren Kennzahlen.
Mehr dazuUnser Beispieldashboard benutzt genau diesen Weg. Sie können es übernehmen oder etwas ganz anderes daraus bauen.
02Direkt ins ERP
Belege und Kostenstellen
Receipt-API und CDR-API liefern Belege und Ladevorgänge dorthin, wo Ihre Buchhaltung ohnehin arbeitet — SAP, ERP, Fuhrparksystem.
Mehr dazuWer nicht pollen will, bekommt Webhooks auf gestartete und beendete Ladevorgänge.
03Preis folgt der Sonne
Dynamische Tarife automatisieren
Ihr Energiemanagement meldet Überschuss, ein Aufruf der Dynamic-Pricing-API senkt den Preis — und hebt ihn abends wieder.
Mehr dazuTarife sind versioniert und mit Gültigkeitszeitraum hinterlegt, jede Änderung bleibt damit nachvollziehbar.
Welches System soll an ENIO hängen?
Sagen Sie uns, wo die Daten hin sollen — wir sagen Ihnen, welche Endpunkte Sie dafür brauchen und was in der Sandbox schon geht.
