E·ON România — Integrare Home Assistant

Integrare custom pentru Home Assistant care monitorizează datele contractuale, consumul și facturile prin API-ul E·ON România (aplicația mobilă E·ON Myline).

Oferă senzori dedicați per cod de încasare pentru contract, index curent, sold, facturi, plăți, istoric citiri, convenție consum, citire permisă, și butoane de trimitere index per utilitate. Suportă complet contracte DUO (colective gaz + electricitate).

---

Ce face integrarea

• Descoperire automată a contractelor asociate contului E·ON Myline
• Selectare granulară a contractelor pe care vrei să le monitorizezi (checkbox-uri cu adrese complete)
• Multi-contract — un singur cont E·ON poate monitoriza mai multe coduri de încasare simultan
• Suport complet DUO — contractele colective (gaz + electricitate sub un singur cod) sunt detectate automat, cu senzori separați per subcontract (index, citire permisă, convenție consum)
• Senzori dedicați per contract selectat — fiecare contract devine un device dedicat
• Sold și facturi — existență sold (Da/Nu), facturi restante cu detalii în atribute, format românesc (1.234,56 lei)
• Istoric citiri — indexuri lunare cu tip citire (autocitit / estimat / citit distribuitor)
• Arhivă plăți — plățile efectuate pe an, cu total anual
• Arhivă consum — consum lunar și mediu zilnic per an, cu separatorul zecimal românesc (virgulă)
• Adrese normalizate — formatare corectă din datele API în format românesc
• Mapping județe — coduri scurte (AB, BV, CJ) convertite automat în denumiri complete (Alba, Brașov, Cluj)
• Reconfigurare fără reinstalare — OptionsFlow pentru modificarea credențialelor și selecției contractelor

---

Sursa datelor

Datele vin prin API-ul aplicației mobile E·ON Myline (api2.eon.ro), care expune endpoint-uri REST pentru:

| Endpoint | Descriere | |----------|-----------| | contract-details | Detalii contract (prețuri, adresă, PCS) | | account-contracts/list | Listă subcontracte (pentru contracte DUO) | | invoices/list | Facturi neachitate | | invoices/list-prosum | Facturi prosumator | | invoice-balance | Sold factură | | invoice-balance-prosum | Sold prosumator | | rescheduling-plans | Planuri de eșalonare | | graphic-consumption | Grafic consum anual (arhivă consum) | | meter-reading/index | Index curent contor | | meter-reading/history | Istoric citiri contor | | consumption-convention | Convenție consum | | payments/payment-list | Istoric plăți |

Autentificarea se face cu email + parolă + semnătură HMAC-MD5 (mobile-login). Token-ul expirat (401) este reînnoit automat.

---

Instalare

HACS (recomandat)

1. Deschide HACS în Home Assistant
2. Click pe cele 3 puncte (⋮) din colțul dreapta sus → Custom repositories
3. Adaugă URL-ul: https://github.com/cnecrea/eonromania
4. Categorie: Integration
5. Click Add → găsește „E·ON România" → Install
6. Restartează Home Assistant

Manual

1. Copiază folderul custom_components/eonromania/ în directorul config/custom_components/ din Home Assistant
2. Restartează Home Assistant

---

Configurare

Pasul 1 — Adaugă integrarea

1. Setări → Dispozitive și Servicii → Adaugă Integrare
2. Caută „E·ON românia"
3. Completează formularul:

| Câmp | Descriere | Implicit | |------|-----------|----------| | Email | Adresa de email a contului E·ON Myline | — | | Parolă | Parola contului E·ON Myline | — | | Interval actualizare | Secunde între interogările API | 3600 (1 oră) |

Pasul 2 — Selectează contractele

După autentificare, contractele sunt descoperite automat. Fiecare contract apare cu adresa completă normalizată:

Strada Florilor 15, ap. 8, Cluj-Napoca, jud. Cluj ➜ 004412345678 (Gaz)
Bulevardul Independenței 42, Brașov, jud. Brașov ➜ 009900123456 (Colectiv/DUO)

Selectezi individual sau bifezi „Selectează toate contractele".

Pasul 3 — Reconfigurare (opțional)

Toate setările pot fi modificate după instalare, fără a șterge integrarea:

1. Setări → Dispozitive și Servicii → click pe E·ON România
2. Click pe Configurare (⚙️)
3. Modifică setările dorite → Salvează
4. Integrarea se reîncarcă automat cu noile setări

Detalii complete în SETUP.md.

---

Entități create

Integrarea creează un device per contract selectat. Sub fiecare device se creează senzori și butoane de trimitere index (câte un buton per utilitate).

Contract individual (gaz sau electricitate)

| Entitate | Descriere | Valoare principală | |----------|-----------|-------------------| | Date contract | Detalii contract (prețuri, adresă, PCS) | Cod încasare | | Sold factură | Există sold de plată? | Da / Nu | | Sold prosumator | Există sold prosumator? | Da / Nu | | Index gaz / Index energie electrică | Index contor curent | Valoare index | | Citire permisă | Autocitire activă? | Da / Nu | | Factură restantă | Facturi neachitate cu calcul zile scadență | Da / Nu | | Factură restantă prosumator | Facturi prosumator (datorii + credite) | Da / Nu | | Convenție consum | Consum lunar convenit | Da / Nu | | Planuri eșalonare | Planuri de eșalonare (condiționat) | Număr planuri | | {an} → Arhivă index gaz / energie electrică | Indexuri lunare per an | Număr citiri | | {an} → Arhivă plăți | Plăți lunare per an | Număr plăți | | {an} → Arhivă consum gaz / energie electrică | Consum lunar + mediu zilnic per an | Total consum |

Contract colectiv / DUO (gaz + electricitate)

Pe lângă senzorii de bază (Date contract, Sold factură, Factură restantă, etc.), contractele DUO generează senzori suplimentari per subcontract:

| Entitate | Descriere | Valoare principală | |----------|-----------|-------------------| | Index gaz | Index contor gaz (subcontract) | Valoare index | | Index energie electrică | Index contor electricitate (subcontract) | Valoare index | | Citire permisă gaz | Autocitire activă pe gaz? | Da / Nu | | Citire permisă electricitate | Autocitire activă pe electricitate? | Da / Nu | | Convenție consum | Convenție per utilitate (gaz + electricitate) | Da / Nu |

Senzorul Date contract pentru DUO afișează în atribute: detalii contract colectiv, subcontracte cu coduri și adrese, plus detalii complete per subcontract (prețuri, contor, OD, NLC, POD).

Butoane

| Entitate | Descriere | Când apare | |----------|-----------|------------| | Trimite index gaz | Trimite indexul contorului de gaz din input_number.gas_meter_reading | Contract gaz sau DUO (subcontract gaz) | | Trimite index energie electrică | Trimite indexul contorului de electricitate din input_number.energy_meter_reading | Contract electricitate sau DUO (subcontract electricitate) |

La contractele individuale apare un singur buton (gaz SAU electricitate, detectat automat). La contractele DUO apar ambele butoane, fiecare trimițând indexul pentru subcontractul corespunzător.

---

Senzor: Date contract

Valoare principală: codul de încasare

Atribute (contract individual):

Cod încasare: "004412345678"
Cod loc de consum (NLC): "..."
CLC - Cod punct de măsură: "..."
Operator de Distribuție (OD): "..."
Preț final (fără TVA): "..."
Preț final (cu TVA): "..."
Preț furnizare: "..."
Tarif reglementat distribuție: "..."
Tarif reglementat transport: "..."
PCS: "..."
Adresă consum: "Strada Florilor 15, ap. 8, Cluj-Napoca, jud. Cluj"
Următoarea verificare a instalației: "..."
Data inițierii reviziei: "..."
Următoarea revizie tehnică: "..."

Atribute (contract DUO):

Cod încasare (DUO): "009900123456"
Tip contract: "Colectiv / DUO (gaz + curent)"
Adresă de corespondență: "..."
────: ""
Număr subcontracte: 2
Gaz — Cod încasare: "002100234567"
Gaz — Cod loc consum (NLC): "..."
Electricitate — Cod încasare: "002200345678"
Electricitate — Cod loc consum (NLC): "..."
──── Gaz Natural ────: ""
Gaz Natural — Cod încasare: "002100234567"
Gaz Natural — Operator Distribuție (OD): "..."
Gaz Natural — Preț final (cu TVA): "..."
Gaz Natural — PCS: "10.657"
──── Energie Electrică ────: ""
Energie Electrică — Cod încasare: "002200345678"
Energie Electrică — Operator Distribuție (OD): "..."

Senzor: Sold factură

Valoare principală: Da / Nu (există sold de plată?)

Atribute (traduse automat din API în română):

Sold: "934,07 lei"
Rambursare disponibilă: "Nu"
Data sold: "04.03.2026"
Rambursare în curs: "Nu"
Garanție activă: "Nu"
Garanție neachitată: "Nu"
Sold de plată: "Da"
Documente rambursare necesare: "Nu"
Asociație: "Nu"

Senzor: Index gaz / Index energie electrică

Valoare principală: valoarea indexului curent

Atribute:

Numărul dispozitivului: "01234567/2020"
Numărul ID intern citire contor: "..."
Data de începere a următoarei citiri: "2026-03-01"
Data de final a citirii: "2026-03-07"
Autorizat să citească contorul: "Da"
Permite modificarea citirii: "Da"
Dispozitiv inteligent: "Nu"
Tipul citirii curente: "Autocitire"
Citire anterioară: "6.030"
Ultima