Einführung
Die ChargePilot Push-API ermöglicht eine nahtlose Cloud-zu-Cloud-Übertragung von abrechnungsrelevanten Ladesitzungsdaten. Sie ist besonders relevant für Kund*innen, die automatisierten Zugriff auf abgeschlossene Ladevorgänge für interne Prozesse, Abrechnung oder Reporting benötigen.
Durch die Nutzung dieser Schnittstelle können Daten direkt aus ChargePilot in eigene Systeme übertragen werden – ohne die Notwendigkeit, eine API regelmäßig abzufragen oder Daten manuell zu exportieren. Dies ist insbesondere vorteilhaft für Flottenbetreiber, Facility Manager sowie Integratoren von Backend-Systemen, die operative und abrechnungsbezogene Abläufe effizienter gestalten möchten.
Anwendungsfall - Zusammenfassung
- Zweck: Automatisierte Übertragung abgeschlossener Ladesitzungen aus ChargePilot in das kundeneigene Backend-System
- Datenformat: JSON-Payload (siehe Tabelle unten)
- Übertragungsfrequenz: Stündlich (Standard, anpassbar je nach Bedarf)
- Auslöser: Abschluss einer Ladesitzung
Funktionalität
- Cloud-zu-Cloud-Datenübertragung: ChargePilot überträgt automatisch abrechnungsrelevante Ladesitzungsdaten an eine vom Kunden definierte HTTPS-Endpunktadresse.
- Automatisierung: Alle aktuellen und zukünftigen Ladeorte werden automatisch in den Datenfeed aufgenommen. Nach der Einrichtung sind keine manuellen Anpassungen erforderlich.
- Skalierbarkeit: Die Lösung eignet sich für Kund*innen mit einer oder mehreren Ladeinfrastrukturen und wächst dynamisch mit dem Ausbau der Standorte.
Technische Voraussetzungen auf Kundenseite
Zur erfolgreichen Aktivierung der Push-API werden folgende Informationen benötigt:
01 API-Key Header:
- Ein API-Key muss bereitgestellt werden, um den Endpunkt abzusichern.
- Dieser muss im Header übermittelt werden: Ocp-Apim-Subscription-Key
02 Endpoint-URL:
- Die HTTPS-Adresse muss angegeben werden, an die die Daten übertragen werden sollen.
- Beispiel: https://your-endpoint.customer.com
Datenformat
Das Payload wird als JSON-Objekt übermittelt. Jedes Objekt repräsentiert einen abgeschlossenen Ladevorgang.
Value | Example Data | Info | Data Type |
TransactionID | 7030760 | ID of the transaction, is in the StartTransaction and the StopTransaction | number |
ChargerID | TACW2242521T0570 | OCPP ID of the charging station, often the serial number of the charging station. | string |
ConnectorID | 1 | charging point | number |
StartAt | 2025-01-09T13:04:34.000Z | Time the StartTransaction occurred in UTC (= 9.1.2025, 14:04 Berlin time) | string |
EndAt | 2025-01-10T06:02:38.000Z | Time the StopTransaction occurred in UTC (= 10.1.2025, 7:02 Berlin Time) | string |
InitialSoC | null | only available for DC events | number | null |
Id | 56395736 | RFID tag that was used for this transaction | string |
EndSoC | null | only available for DC events | number | null |
EnergyDelivered | 17233 | Energy delivered in Wh. StartTransaction: meter_start: 0 / StopTransaction: Meter_stop: 17233 | number |
Empfehlungen zur Integration
- Zunächst sollte das Setup in der Entwicklungsumgebung getestet werden, um Datenempfang und -struktur zu überprüfen.
- Nach erfolgreicher Validierung kann die Konfiguration auf den Produktion-Endpunkt umgestellt werden.
- Änderungen am Endpunkt oder API-Key sollten im Vorfeld kommuniziert werden, um eine unterbrechungsfreie Datenübertragung sicherzustellen.
War dieser Artikel hilfreich?
Das ist großartig!
Vielen Dank für das Feedback
Leider konnten wir nicht helfen
Vielen Dank für das Feedback
Feedback gesendet
Wir wissen Ihre Bemühungen zu schätzen und werden versuchen, den Artikel zu korrigieren