Home Assistant och API:et

Home Assistant vet vad ditt hem gör. Eneralo vet vad det kostar på din räkning: spot plus påslag, skatt, överföring, moms och effekttariffens toppavgift, två till tio gånger spotpriset beroende på timme. Koppla ihop dem så kör dina automationer på räkningens pris, mätarens timmar prissätts samma dag, och månadens kostnad, prognos och fynd ligger på din panel. Tre eftermiddagar med 11 kW billaddning i ett toppfönster i Sollentuna kostar omkring 1 100 kr extra. En spotsensor visar det aldrig. Eneralos gör det.

Vad en enhet är

En enhet är ett program hemma med en egen Eneralo-nyckel: en Home Assistant-installation, en mätaravläsare med nätverksfirmware, eller ett skript du kör själv. Nyckeln utfärdas i appen under Inställningar → Enheter och kan återkallas där. Elmätaren själv är inte en enhet. En mätaravläsare är en apparat som läser mätarens kundgränssnitt och håller en kWh-ställning; den, eller Home Assistant, talar med Eneralo.

I Sverige är gränssnittet P1- eller HAN-porten på mätaren; elnätsbolaget aktiverar den på begäran. Avläsare: HomeWizard P1, Slimmelezer, Tibber Pulse. Home Assistant läser dem genom integrationen DSMR eller HomeWizard Energy.

Vad en enhet kan göra med nyckeln

  1. Skicka mätaravläsningar. Enheten skickar mätarens timvisa kWh, lästa från mätarens kundgränssnitt. Eneralo har hemmets förbrukning inom timmar i stället för elnätsbolagets fördröjning på en till två dagar, och ingen fil laddas upp för hand. Analysen, fynden och månadsprognosen körs på de skickade timmarna.
  2. Läsa timpriser. Varje timme i dag och i morgon, prissatt som hemmets räkning prissätter dem: avtal, nättariff, moms, och effekttariffens toppfönster flaggade. En Home Assistant-automation kan flytta en laddning eller en värmepumpscykel efter siffran räkningen kommer att visa, inte efter spotpriset ensamt.
  3. Läsa månadssammanfattningen. Kostnad hittills, beräknad kostnad med spann, kWh och öppna fynd för innevarande månad, för en panel eller en notis.
  4. Läsa avläsningarna. Upp till 31 dagars timmar med kWh, kvalitet och kostnad.

Home Assistant gör alla fyra genom Eneralo-integrationen. En mätaravläsare eller ett skript gör typiskt bara 1, med API:et nedan.

Home Assistant: installera

  1. Parkoppla. I appen: Inställningar → Enheter → Home Assistant → Parkoppla en enhet. Kopiera nyckeln. Inställningar → Enheter (inloggning)
  2. Installera. Ladda ner integrationen från appens sida Enheter. Packa upp så att custom_components/eneralo/ ligger i Home Assistants konfigurationskatalog, bredvid configuration.yaml. Starta om Home Assistant. Ladda ner (inloggning)
  3. Anslut. Inställningar → Enheter och tjänster → Lägg till integration → Eneralo. Nyckel: den från steg 1. URL: https://app.eneralo.com

Home Assistant: entiteter och statistik

EntitetInnehållUppdatering
Pris nuSEK/kWh för innevarande timme, inklusive moms. Attributet hours: dagens 24 timmar med spot, leverantör, skatt, överföring och toppfönsterflagga.Vid hel timme
Pris i morgonMedel i SEK/kWh och timmarna. Otillgänglig tills morgondagens priser publicerats, omkring 13:15.30 min
Månadskostnad hittills / beräknadSEK, inklusive moms. Attributen low och high: prognosens spann.30 min
Månadens kWhkWh sedan den första i månaden.30 min
FyndAntal. Attributet findings: meningarna.30 min
Avläsningar till och medTidsstämpel för den sista timmen på fil.30 min

Var sjätte timme skriver integrationen två externa statistikserier till recordern: eneralo:<site>_consumption (kWh), eneralo:<site>_cost. Energipanelen → Elnätsförbrukning: välj förbrukningsstatistiken; kostnad: kostnadsstatistiken. Värdena ligger efter klockan med elnätsbolagets filfördröjning, typiskt en till två dagar. Första körningen importerar 31 dagar.

Home Assistant: sändning från mätaravläsaren

Alternativ → Sändningssensor: en entitet med device_class energy och state_class total_increasing som mäter hela hemmet. Intervall 1, 6, 12 eller 24 h. Varje körning skickar de senaste 25 timmarnas timvisa change-statistik; servern kastar timmar den redan har. Inte vald: inget skickas.

configuration.yaml, alternativ till steg 3; posten flyttar till .storage vid första start:

eneralo:
  - token: "<token>"
    url: "https://app.eneralo.com"           # default
    upload_entity: sensor.p1_energy_import   # optional
    upload_interval: 6                       # 1 | 6 | 12 | 24

API

Alla anrop: Authorization: Bearer <token>. Svar: JSON. Tidsstämplar: ISO 8601 UTC. Pengar: hemmets valuta, inklusive moms. Gränser: 300 läsningar per timme och enhet, 50 sändningar per dag, 1 000 intervall per sändning.

Metod, sökvägParametrarReturnerar
GET /api/site/prices day=today | tomorrow | YYYY-MM-DD 24 timmar: start, end, spot_ore, supplier_ore, tax_ore, transfer_ore, ore_ex_vat, kr_per_kwh, label, peak_window, peak_kr_per_kw. Dag: zone, currency, vat, supplier_pricing, label.
GET /api/site/summary — month (kwh_so_far, kr_so_far, kwh_projected, kr_projected, kr_low, kr_high, label), findings[], readings.through, device.last_upload_through.
GET /api/site/readings from, to (datum, högst 31 dagar; standard de senaste 7) Timmar med kwh, quality (measured | estimated | spread), kr_per_kwh, kr.
POST /api/device/readings kropp nedan 202: accepted, new, revised, unchanged, skipped.

Anropskropp, en av:

{"intervals": [{"s": "2026-10-01T00:00:00Z", "e": "2026-10-01T01:00:00Z", "kwh": 0.512}]}
{"counters":  [{"t": "2026-10-01T00:00:00Z", "kwh_total": 48213.4}]}

Fel: 401 okänd eller återkallad nyckel. 404 not_published priserna ännu inte tillgängliga. 413 fler än 1 000 intervall. 422 felaktigt datum eller intervall. 429 gränsen nådd.

Etiketter: published (prislista eller spot), invoice (från en mottagen faktura), estimated (månadspriset ännu inte känt).

Få förhandstillgång