Cod original: https://github.com/cnecrea/hidroelectrica

Hidroelectrica România - Integrare pentru Home Assistant 🏠🇷🇴

Această integrare pentru Home Assistant oferă monitorizare completă a datelor contractuale, facturilor curente, și istoricul plăților pentru utilizatorii Hidroelectrica România. Integrarea este configurabilă prin interfața UI și permite afișarea informațiilor utile în timp real. 🚀

🌟 Caracteristici

Senzor Date contract:

• 🔍 Monitorizare Generală:
  • Afișează informații detaliate despre utilizator și cont.
• 📊 Atribute disponibile:
  • Numele și prenumele
  • Telefon de contact
  • Număr cont utilitate
  • Cod loc de consum (NLC)
  • Tip client
  • Adresa de consum
  • Localitate
  • Țară
  • Ultima actualizare de date

Senzor Index curent:

• 🔍 Monitorizare index contor:
  • Afișează indexul curent al contorului (ultima citire disponibilă, în kWh).
  • Compatibil cu Energy Dashboard din Home Assistant (state_class: total_increasing, device_class: energy).
• 📊 Atribute disponibile:
  • POD: Punctul de livrare
  • Instalație: Numărul instalației
  • Serie contor: Numărul de serie al contorului
  • Data ultimei citiri: Data la care s-a făcut citirea curentă
  • Index anterior: Valoarea indexului la citirea precedentă
  • Data citirii anterioare: Data citirii precedente
  • Distribuitor: Operatorul de distribuție
  • Furnizor: Furnizorul de energie
  • Client distribuitor: Numele clientului la distribuitor
  • Interval citire: Frecvența de citire a contorului
  • Istoric citiri: Lista completă a citirilor anterioare cu date și tip (Autocitire/Regularizare)

Senzor Factură restantă:

• 🔍 Detalii despre solduri restante:
  • Afișează dacă există facturi restante și data scadenței.
• 📊 Atribute disponibile:
  • Plată restantă (ex. "259.12 lei, depășită cu 1 zi")
  • Total neachitat

Senzor Arhivă:

• 📚 Date istorice:
  • Afișează plățile lunare pentru fiecare an disponibil.
• 📊 Atribute disponibile:
  • Plăți individuale: Detalii pentru fiecare plată efectuată.
    • Exemplu: Plată #1 factură luna octombrie: 118,83 lei
  • Plăți efectuate: Numărul total de plăți din anul curent.
    • Exemplu: Plăți efectuate: 13
  • Total suma achitată: Suma totală achitată pentru anul curent.
    • Exemplu: Total suma achitată: 2342.50 lei

---

⚙️ Configurare

🛠️ Interfața UI:

1. Adaugă integrarea din meniul Setări > Dispozitive și Servicii > Adaugă Integrare.
2. Introdu datele contului Hidroelectrica:
   • Nume utilizator: username-ul contului tău Hidroelectrica.
   • Parolă: parola asociată contului tău.
3. Specifică intervalul de actualizare (implicit: 3600 secunde).

---

🚀 Instalare

💡 Instalare prin HACS:

1. Adaugă depozitul personalizat în HACS. 🛠️

3. Caută integrarea Hidroelectrica România și instaleaz-o. ✅
4. Repornește Home Assistant și configurează integrarea. 🔄

✋ Instalare manuală:

1. Clonează sau descarcă depozitul GitHub. 📂
2. Copiază folderul custom_components/hidroelectrica în directorul custom_components al Home Assistant. 🗂️
3. Repornește Home Assistant și configurează integrarea. 🔧

---

✨ Exemple de utilizare

🔔 Automatizare pentru Factură Restantă:

Creează o automatizare pentru a primi notificări când există o factură restantă.

alias: Notificare Factură Restantă
description: Notificare dacă există facturi restante
trigger:
  - platform: state
    entity_id: sensor.hidroelectrica_factura_restanta_XXXXXXXX
    to: "Da"
action:
  - service: notify.mobile_app_your_phone
    data:
      title: "Factură Restantă Detectată! ⚡"
      message: "Aveți o factură restantă în valoare de {{ states('sensor.hidroelectrica_factura_restanta_XXXXXXXX') }}."
mode: single

🔍 Card pentru Dashboard:

Afișează datele despre utilizator, facturi restante și istoric plăți pe interfața Home Assistant.

type: entities
title: Monitorizare Hidroelectrica România
entities:
  - entity: sensor.hidroelectrica_date_contract_XXXXXXXX
    name: Date Utilizator
  - entity: sensor.hidroelectrica_factura_restanta_XXXXXXXX
    name: Factură Restantă
  - entity: sensor.hidroelectrica_factura_restanta_XXXXXXXX
    name: Istoric Facturi Achitate

---

🧑‍💻 Contribuții

Contribuțiile sunt binevenite! Simte-te liber să trimiți un pull request sau să raportezi probleme aici.

---

🌟 Suport

Dacă îți place această integrare, oferă-i un ⭐ pe GitHub! 😊