Ladevorgänge abrufen

Übersicht

Ladevorgänge enthalten viele hilfreiche Informationen und können aus dem Grund über die API abgerufen werden.

Struktur

Ladevorgänge können immer einem Anschluss bzw. einer Ladestation und einer Ladekarte zugeordnet werden.

Zusammenhänge bei Ladevorgängen

Alle Daten sind in dem Typ Session beschrieben.

Abgeschlossene Ladevorgänge abrufen

Je nach Szenario gibt es verschiedene Möglichkeiten, Ladevoränge über unsere API abzurufen.

• Wählen Sie einen bestimmten Ladevorgang aus getChargingSession
• Alle verfügbaren Ladevorgänge auswählen getChargingSessions

Hier ist eine Beispielanfrage mit der 100 Ladevorgänge eines Kontaktes abgerufen werden können:

query getChargingSessions($contactId: String, $limit: Int, $offset: Int) {
  getChargingSessions(contactId: '7fe42322-7e42-4b42-864e-e42ce703c429', limit: 100, offset: 0) {
    cardId
    connector {
      ...SessionConnectorFragment
    }
    costs
    costsNet
    currency
    duration
    endTime
    meterEnd
    meterStart
    meterTotal
    startTime
    status
    tariff
    taxAmount
    id
  }
}

Wann ist ein Ladevogang zu Ende?

Ladevorgänge werden vom System erst als beendet angesehen, wenn das Auto von der Station getrennt wurde, nicht weil das Auto vollständig geladen ist.

Aktive Ladevorgänge 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 erkennt man an dem Feld status welches entweder den Wert started oder stopped haben kann (Session).

getChargingSessions($contactId: String!, $tagId: String $active: Boolean) {
  getChargingSessions(contactId: '7fe42322-7e42-4b42-864e-e42ce703c429', tagId: 'F2642942', active: true) {
    cardId
    connector {
      ...SessionConnectorFragment
    }
    costs
    costsNet
    currency
    duration
    endTime
    meterEnd
    meterStart
    meterTotal
    startTime
    status
    tariff
    taxAmount
    id
  }
}

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.