Ladevorgängen starten / stoppen

Übersicht

Um ein Elektrofahrzeug aufzuladen ist es notwendig, es mit einem Ladepunkt zu verbinden und einen Ladevorgang zu starten. Dies erfolgt mithilfe einer (digitalen) Ladekarte des Nutzers, um diesen gegenüber der Ladesäule (und dem Backend) zu authentifizieren. Bei Erfolg wird der Ladevorgang autorisiert und das Elektrofahrzeug aufgeladen.

Das System sendet dann mit dem Feld session die Id der aktive Session zurück. Um den Ladevorgang wieder zu beenden kann über die API mit der session ein Stoppbefehl ausgelöst werden. Nach dem erfolgreichen Beenden des Ladevorgangs sendet die Ladesäule die Transaktionsdaten an das Backend.

Aktuellen Preis für den Ladeanschluss abrufen

Was ein Ladevorgang kostet ist je nach Tarif und Ladestationskonfiguration unterschiedlich.

Zusammensetzung der Preiskonfiguration

Der Preis für einen Ladevorgang kann sich aus drei Komponenten zusammensetzen:

• Startgebühr
• Dauer des Ladevorgangs in Minuten
• Geladene Energie in kWh

In der Regel werden Ladevorgänge an den Stationen, die von CONNECT betrieben werden, mit ct./kWh berechnet.

Der Preis für einen Ladevorgang wird von dem Anbieter des Fahrstromvertrags (in diesem Fall CONNECT) gegenüber dem Nutzer (z.B. einem Mieter) festgelegt.

Ladevorgang starten

Es ist möglich über die API Ladevorgänge zu starten. Dazu muss der Ladeanschluss¹ und die TagId des Nutzers bekannt sein.

Die API stellt dazu die Funktion remoteStart zur Verfügung. Mit ihr kann ein Ladevorgang initiiert werden.

mutation remoteStart($connectorId: String!, $tagId: String!) {
  remoteStart(connectorId: 'abc123', tagId: 'xyz789') {
    message
    session
    status
  }
}

Der Befehl wird nach Prüfung der TagId via OCPP an die Ladestation gesendet. Bei manchen Stationen wird danach der Anschluss freigegeben. Andere Stationen erlauben schon vorher das Fahrzeug anzuschließen.

Sofern kein direkter Fehler aufgetreten ist, bestätigt die Station den Befehl und wartet auf das Fahrzeug, um den Ladevorgang zu starten.

Vor dem Starten eines Ladevorgangs muss den Nutzer:innen eine Preisinformation angezeigt werden!

Diese Preisinformation ist abhängig von dem Ladepunkt und Vertrag, den die Nutzer:innen mit CONNECT abgeschlossen haben. Da sich Preiskonfigurationen von Zeit zu Zeit ändern können, ist es ratsam diese jedes Mal vor dem Start eines Ladevorgangs abzufragen. Die Verantwortung für das Anzeigen der korrekten Preisinformation obliegt dem Anbieter des Frontends.

Starten eines Ladevorgangs

Ladevorgang muss nicht zwangsläufig zustande kommen.

Der Befehl remoteStart() sorgt dafür, dass die Station den Ladevorgang startet. Im Kommunkationsprotokoll mit der Station ist keine weitere Kommunkation vorgesehen, die eine direkte Prüfung ermöglicht. Aus dem Grund sollte nach der Bestätigung nach aktiven Ladevorgängen geschaut werden um sicher zu gehen. In der Regel sollte der Ladevorgang innerhalb von 30sek. verfügbar sein, sonst wurde das Fahrzeug nicht rechtzeitig angeschlossen oder es gab Fehler bei der Kommunkation mit dem Fahrzeug.

Aktiven Ladevorgang abrufen

Nachdem ein Ladevorgang erfolgreich gestartet wurde, kann er über die API abgerufen werden. Dies kann über zwei API Funktionen erfolgen:

• Wählen Sie eine bestimmte Ladevorgang aus getChargingSession
• Filtern sie Ladevorgänge mit dem Filter active aus getChargingSessions

Ob ein Ladevorgang noch aktiv ist, kann über das Feld Status ermittelt werden, das entweder den Wert started oder stopped enthalten kann (Session).

Daten zu aktivem Ladevorgang abrufen

Fehlgeschlagene Versuche können nicht abgerufen werden.

Geladene Energie, Dauer und Kosten sind erst dann final, wenn der Ladevorgang den Status stopped hat.

Die Geladene Energie (meter_total) und Dauer(duration) sind solange der Ladevorgang aktiv ist Indikationen. costs,costsNet und taxAmount können erst nach Beendigung des Ladevorgangs abgerufen werden.

Ladevorgang stoppen

Je nach Szenario gibt es verschiedene Möglichkeiten einen Ladevorgang zu stoppen:

• Durch den Nutzer über das Fahrzeug
• Durch den Nutzer an der Station
• Mit die API über die Funktion remoteStop

mutation remoteStop($session: ID!) {
  remoteStop(session: '7fe42322-7e42-4b42-864e-e42ce703c429') {
    message
    session
    status
  }
}

Stoppen eines Ladevorgangs

---

1. Jeder Ladeanschluss ist Teil des Chargepoint Objectes hat eine eindeutige ID und kann so identifiziert werden. ↩