Tarife und Einheiten

Ein Tarif besteht aus kombinierbaren Bestandteilen. Tarife sind versioniert: Jede Änderung ergibt eine neue Version, laufende Sitzungen behalten ihre Version.

Einheiten

Grösse	Einheit	Beispiel
Beträge	Rappen	250 = CHF 2.50
Energie	Wattstunden (Wh)	12400 = 12.4 kWh
Energiepreis	Hundertstel-Rappen pro kWh	4500 = 45 Rappen pro kWh = 0.45 CHF/kWh
Leistung	Watt	11000 = 11 kW
Standzeitgebühr	Rappen pro angefangene Minute	10 = 10 Rappen pro Minute
MWST-Satz	Basispunkte	810 = 8.1 %

Gerundet wird erst der Endbetrag: in CHF auf 5 Rappen, in EUR auf 1 Cent.

Bestandteile

• energyPrice: Preis pro kWh ausserhalb von Zeitfenstern. Pflicht.
• startFee: Startgebühr pro Sitzung in Rappen.
• serviceFee: Servicegebühr der Betreibenden pro Sitzung in Rappen. Sie wird separat ausgewiesen.
• timeWindows: Zeitfenster nach Wochentag (1 = Montag bis 7 = Sonntag) und Uhrzeit mit eigenem Energiepreis, zum Beispiel ein Niedertarif in der Nacht. Die Energie wird anhand der Zählerstände den Fenstern zugeordnet.
• idleFee: Standzeitgebühr mit pricePerMinute, graceMinutes, trigger (after_charging ab Ladeende oder after_start ab Beginn), optional maxAmount und ruhigen Zeiten quietHours.
• maxAmount: Höchstbetrag pro Sitzung in Rappen.
• timeZone: Zeitzone für Zeitfenster und ruhige Zeiten, Standard Europe/Zurich.

Tarif anlegen

curl -X POST https://api.ladehase.com/v1/tariffs \
  -H "Authorization: Bearer lh_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Gäste",
    "rules": {
      "energyPrice": 4500,
      "serviceFee": 50,
      "timeWindows": [
        { "days": [1,2,3,4,5,6,7], "from": "22:00", "to": "06:00", "energyPrice": 3000, "label": "Nacht" }
      ],
      "idleFee": {
        "pricePerMinute": 10,
        "graceMinutes": 120,
        "trigger": "after_charging",
        "quietHours": { "from": "22:00", "to": "07:00" }
      }
    }
  }'

Vorschau

Mit POST /v1/tariffs/preview berechnest du für einen Entwurf, was Ladungen mit bestimmten Energiemengen kosten, ohne einen Tarif zu speichern:

curl -X POST https://api.ladehase.com/v1/tariffs/preview \
  -H "Authorization: Bearer lh_test_…" \
  -H "Content-Type: application/json" \
  -d '{ "rules": { "energyPrice": 4500, "serviceFee": 50 }, "energy_wh": [10000, 20000, 40000] }'

Für 20 kWh ergibt das 20 × 45 Rappen + 50 Rappen = CHF 9.50.

MWST

Ist die Organisation mehrwertsteuerpflichtig, sind alle Preise inklusive MWST. Die Sitzung weist den Anteil in vat_amount aus.