Cod original: https://github.com/cnecrea/e-bloc

🏠 Integrarea E-bloc.ro pentru Home Assistant

Integrarea E-bloc.ro permite utilizatorilor să afișeze și să monitorizeze informații despre apartamentul lor direct din platforma E-bloc.ro în Home Assistant. Aceasta oferă senzori pentru detalii despre client, indexurile individuale de consum pentru fiecare contor și plățile efectuate.

---

📋 Funcționalități

🧑‍💻 Senzor Detalii Client (Date client)

• Afișează informații despre client și apartament.
• Atribute disponibile:
  • Cod client – Codul unic al clientului.
  • Apartament – Numărul apartamentului asociat.
  • Persoane declarate – Numărul de persoane declarate în apartament.
  • Restanță de plată – Suma restantă de plată (în RON).
  • Ultima zi de plată – Termenul limită pentru plata datoriei.
  • Contor trimis – Starea trimiterii indexului de consum (Da/Nu).
  • Începere citire contoare – Data de început pentru citirea contoarelor.
  • Încheiere citire contoare – Data de final pentru citirea contoarelor.
  • Luna cu datoria cea mai veche – Luna celei mai vechi datorii.
  • Luna afișată – Luna curentă afișată în interfață.
  • Nivel restanță – Gradul acumulării datoriilor.

📊 Senzori Index Contor (câte un senzor per contor)

• Se creează automat câte un senzor pentru fiecare contor detectat în contul dvs. (ex. „Index AR buc.", „Index AR baie").
• Atribute disponibile pentru fiecare contor:
  • Titlu – Denumirea contorului (ex. „AR buc.", „AR baie").
  • Index vechi – Indexul precedent (în mc).
  • Index nou – Indexul curent (în mc).
  • Data citire – Data ultimei citiri.
  • ID contor – Identificatorul unic al contorului.

💳 Senzor Plăți și Chitanțe (Plăți și chitanțe)

• Afișează informațiile despre plățile efectuate.
• Atribute disponibile:
  • Număr total de chitanțe – Numărul total de plăți înregistrate.
  • Detalii pentru fiecare chitanță:
    • Chitanță – Numărul chitanței.
    • Data – Data plății.
    • Sumă plătită – Suma achitată (în RON).

---

🛠️ Configurare

1️⃣ Instalare

💡 Instalare prin HACS:

1. Adaugă depozitul personalizat în HACS. 🛠️
2. Caută integrarea Integrare pentru e-bloc.ro și instaleaz-o. ✅
3. Repornește Home Assistant și configurează integrarea. 🔄

✋ Instalare manuală:

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

---

2️⃣ Adăugare în Home Assistant

1. Mergeți la Settings > Devices & Services > Add Integration.
2. Căutați E-bloc.ro și completați datele de autentificare:
   • Utilizator: Email-ul asociat contului E-bloc.ro.
   • Parolă: Parola contului.
   • ID Asociație: ID-ul asociației de locatari (găsit în contul E-bloc.ro).
   • ID Apartament: ID-ul apartamentului (disponibil în contul E-bloc.ro).

---

🖼️ Prezentare

Exemplu senzori:

Detalii Client:

Cod client: AXXXXF
Apartament: 22
Persoane declarate: 2
Restanță de plată: 221.75 RON
Ultima zi de plată: 2025-01-12
Contor trimis: Nu

Index Contor – AR buc.:

Titlu: AR buc.
Index vechi: 1481 mc
Index nou: 1484 mc
Data citire: 2026-03-05
ID contor: 721

Index Contor – AR baie:

Titlu: AR baie
Index vechi: 885 mc
Index nou: 887 mc
Data citire: 2026-03-05
ID contor: 723

Plăți și Chitanțe:

Număr total de chitanțe: 2

Chitanță: 43XXXXXXXXXX
Data: 2024-11-27
Sumă plătită: 262.51 RON

Chitanță: 43XXXXXXXXXX
Data: 2024-10-30
Sumă plătită: 213.60 RON

---

🔄 Actualizări

Integrarea se actualizează automat la fiecare 5 minute pentru a sincroniza cele mai recente date de pe platforma E-bloc.ro. Sesiunile expirate sunt detectate automat și re-autentificate fără intervenție.

---

🐛 Rezolvări și îmbunătățiri recente

• Senzori individuali per contor – Fiecare contor (ex. „AR buc.", „AR baie") are propriul senzor în Home Assistant.
• Luna dinamică – Indexurile sunt preluate pentru luna curentă, nu una fixată.
• Protecție la răspunsuri null – API-ul e-bloc.ro poate returna null pentru anumite endpoint-uri; acum este tratat corect.
• Re-autentificare automată – Dacă sesiunea expiră, integrarea se re-autentifică automat.
• Curățare sesiune HTTP – La dezinstalare, sesiunea este închisă corect.

---

✍️ Autor

Această integrare a fost creată pentru utilizarea personală a datelor din platforma E-bloc.ro în Home Assistant.

---

🧑‍💻 Contribuții

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

---

📜 Licență

Distribuit sub licența MIT.