Sitzungen und Zustände

Eine Sitzung (ses_…) ist eine Ladung von der Zahlung oder Freigabe bis zur Abrechnung. Sie gehört zu genau einem Ladepunkt und friert beim Start die gültige Tarifversion ein. Spätere Tarifänderungen wirken sich nicht auf laufende Sitzungen aus.

Ablauf

1. Die fahrende Person scannt den QR-Code oder wählt am Terminal den Ladepunkt. Ladehase legt eine Sitzung an (created).
2. Sie reserviert einen Betrag oder kauft ein Paket (awaiting_payment).
3. Ist die Zahlung autorisiert (authorized), gibt Ladehase den Ladepunkt frei und wartet auf das Auto (waiting_for_vehicle).
4. Das Auto lädt (charging). Ladehase misst laufend die Energie und rechnet den Betrag hoch.
5. Das Kabel wird abgezogen oder die Ladung gestoppt (completed).
6. Ladehase belastet den Endbetrag, gibt den Rest der Reservation frei und stellt die Quittung aus (settled).

Zustände

Zustand	Bedeutung
created	Sitzung angelegt, noch keine Zahlung.
awaiting_payment	Zahlung läuft beim Zahlungspartner.
authorized	Bezahlt oder per Zugang freigegeben.
waiting_for_vehicle	Ladepunkt freigegeben, Auto noch nicht eingesteckt oder lädt noch nicht.
charging	Das Auto lädt.
suspended	Ladung pausiert, zum Beispiel durch das Auto oder das Lastmanagement.
idle	Auto voll, Kabel steckt noch. Hier kann eine Standzeitgebühr anfallen.
stopping	Stopp angefordert, Ladehase wartet auf die Bestätigung der Ladestation.
completed	Ladung beendet, Abrechnung folgt.
settled	Abgerechnet. Endzustand.
payment_failed	Zahlung fehlgeschlagen. Endzustand.
expired	Kein Auto innert der Frist eingesteckt, Reservation freigegeben. Endzustand.
canceled	Abgebrochen, Reservation freigegeben. Endzustand.
error	Störung. Wird behoben (weiter zu completed) oder abgebrochen (canceled).

Pro Anschluss gibt es höchstens eine aktive Sitzung. Eine zweite Anfrage für denselben Anschluss beantwortet die API mit 409 und dem Code conflict.

Gründe für das Ende

Das Feld stop_reason sagt, warum eine Ladung endete:

• unplugged: Kabel abgezogen
• amount_reached: Reservation erreicht (abzüglich Sicherheitsmarge)
• package_reached: Paket aufgebraucht
• driver: von der fahrenden Person beendet
• operator: von den Betreibenden beendet
• api: über die API beendet
• max_duration: Höchstdauer erreicht
• device_error: Störung an der Ladestation

Abrechnungsarten

Das Feld mode zeigt, wie abgerechnet wird:

• reservation: Betrag reservieren, nach Verbrauch belasten, Rest freigeben.
• prepaid: Paket vorab bezahlt. Nicht genutztes Guthaben wird je nach Einstellung zurückerstattet oder verfällt.
• access: Ladung über einen Zugang, gratis oder zum Sondertarif.

Beträge einer Sitzung

Feld	Bedeutung
authorized_amount	Reservierter beziehungsweise vorab bezahlter Betrag in Rappen.
amount	Laufend hochgerechneter Betrag oder Endbetrag in Rappen.
captured_amount	Tatsächlich belasteter Betrag in Rappen.
refunded_amount	Zurückerstatteter Betrag in Rappen.
vat_amount	Enthaltener MWST-Anteil in Rappen.
energy_wh	Geladene Energie in Wattstunden.

Die Zeitleiste einer Sitzung mit allen Ereignissen liefert GET /v1/sessions/{id}/events.