Skip to content

Releases

ATS v0.4.1 — Maintainer metadata

Choose a tag to compare

@github-actions github-actions released this 11 Nov 12:05
776cfa4

ATS v0.4.1 — Manutentore e metadati

Data: 11 novembre 2026 · Repository: EnrCol/ats-ha · Tipo: release stabile di manutenzione

Modifiche rispetto alla v0.4.0

  • Made by the community: il campo codeowners del manifest ora indica @EnrCol, manutentore del fork e destinatario delle segnalazioni.
  • Attribuzione originale preservata: il progetto deriva da Manu-Nat/ats-ha; README italiano/inglese e file LICENSE mantengono i crediti e il copyright originale a Manu-Nat.
  • Documentazione e installazione: README IT/EN, link al tag stabile, checklist e note di rilascio allineati alla v0.4.1. Il collegamento a documentazione e issue tracker rimane sul fork EnrCol/ats-ha.
  • Risorsa Lovelace: il parametro di versione del modulo JavaScript ATS passa a ?v=0.4.1 per il normale aggiornamento della cache. La card e la relativa logica non cambiano.
  • Test e pubblicazione: controlli aggiornati per verificare versione, manutentore, link e descrizioni. Il tag stabile viene pubblicato solo dopo la CI verde di main.

Compatibilità

Nessuna modifica funzionale a login, sensori, ats_metric, unique_id, fatture, download PDF, visualizzatore PDF.js, database Recorder o algoritmi di calcolo.

Per aggiornare da v0.4.0 installa v0.4.1 tramite Marketplace/HACS e riavvia Home Assistant. Non eliminare e ricreare l'integrazione: così vengono mantenuti la config entry e gli identificativi registrati. La libreria JavaScript aggiorna il proprio URL in Lovelace; se necessario ricarica completamente la pagina o riapri la Companion App.

Nessuna credenziale, dato personale, bolletta o backup è incluso nel repository.

Per tutte le funzionalità, i limiti e le informazioni sulla privacy, consulta il README italiano, il README inglese e le note della v0.4.0.

ATS v0.4.0 — Stable

Choose a tag to compare

@github-actions github-actions released this 08 Nov 17:09
2000d19

ATS v0.4.0 — Prima release stabile del fork

Data: 8 novembre 2026 · Repository: EnrCol/ats-ha

Questa è la prima release stabile (non prerelease) del fork di Alto Trevigiano Servizi (ATS) per Home Assistant. Basata sulla beta.8 collaudata su Home Assistant TEST Core 2026.11.0. Il progetto è non ufficiale e non è affiliato a ATS. Crediti al progetto originale Manu-Nat/ats-ha.

Novità e funzioni disponibili

  • Login semplificato: servono solo username/password dello Sportello Online ATS e intervallo di aggiornamento (default 60 min). URL, token, codice cliente e API vengono individuati automaticamente; supportati rinnovo di sessione e riautenticazione.
  • 19 sensori: forniture attive/cessate, conteggio e dettagli fatture, importi pagati e residui, prossime scadenze, consumi fatturati, letture, storico, data ultima lettura, previsione annua quando i dati sono sufficienti e stima annua fornita da ATS.
  • Storico annuale fatture: ordinamento per anno di emissione con numero, importi, pagamenti e dettagli disponibili; campi mancanti non convertiti arbitrariamente in 0.
  • Correzioni contabili: Payed=true prevale su ToPay per il conteggio delle fatture da pagare. Gestione del campo SupplyNo anche quando ATS lo restituisce come array.
  • PDF autenticati: servizio ats.download_invoices per scaricare le bollette disponibili e mancanti nella cartella privata /media/ats/fatture/ANNO/. Sorgente firmata e risposta PDF validate; file esistenti saltati, dimensione limitata.
  • Viewer in-app: card Lovelace inclusa con Apri PDF e Scarica PDF, PDF.js, zoom e cambio pagina, senza browser esterno o Browser Mod. File serviti dall'endpoint Home Assistant autenticato /api/ats/invoice/{year}/{number}.
  • Esempi portabili: card completa e dashboard completa, senza riferimenti obbligatori agli entity_id. L'attributo ats_metric identifica la metrica e la card trova automaticamente lo storico.
  • Registrazione automatica risorsa Lovelace: aggiunta/aggiornamento del JavaScript in modalità storage, senza installare una card di terze parti.

Privacy e compatibilità

  • Novità rispetto a beta.8: tutti i sensori ATS usano _unrecorded_attributes = frozenset({MATCH_ALL}). I dati e gli attributi correnti restano visibili nel frontend, ma nelle nuove registrazioni di Recorder vengono omessi gli attributi personalizzati che potrebbero includere indirizzi, POD, contatori, dettagli economici e storia fatture. Stati e metadati necessari alle statistiche restano registrabili.
  • Nessuna cancellazione automatica: dati già registrati dalle beta e copie di backup rimangono potenzialmente sensibili; i PDF completi nella cartella /media contengono dati personali e richiedono protezione degli accessi.
  • unique_id e identificativi registrati degli utenti esistenti restano invariati. Le impostazioni API/cookie legacy rimangono disponibili nelle opzioni.
  • I codeowners originali sono mantenuti per attribuzione e continuità con il progetto upstream; documentazione e issue tracker della release puntano al fork.

Installazione / aggiornamento

  1. Aggiungi EnrCol/ats-ha come repository personalizzato nella sezione Integrazioni del Marketplace/HACS.
  2. Installa la release v0.4.0 e riavvia Home Assistant.
  3. Per una nuova installazione inserisci username/password dello Sportello ATS. Per un aggiornamento conserva la config entry: non eliminare e ricreare l'integrazione.
  4. Incolla examples/ats-card.yaml nell'editor YAML di una scheda manuale (oppure usa examples/ats-dashboard.yaml). Ricarica la pagina o riapri la Companion App.
  5. Se vuoi archiviare i PDF premi Scarica fatture ATS mancanti e proteggi la persistenza di /media.

Leggi README italiano, English README e checklist TEST.

Collaudo e limiti noti

La beta.8 di partenza ha superato 133 test Python, 3 subtest, 6 test JavaScript, oltre a sintassi, Hassfest e HACS. Su Home Assistant TEST sono stati confermati login reale, 19 sensori, 22 fatture, riepilogo dinamico, apertura PDF in-app e funzionamento senza Browser Mod. Anche la release stabile supera la propria CI prima della pubblicazione.

Limiti: un cliente ATS per istanza Home Assistant, nessun accesso SPID/CIE, API WebForms suscettibili a modifiche del portale e futura firma HMAC ATS non implementata. La previsione annua resta unknown se non ci sono almeno due letture valide per contatore attivo. I conflitti Recorder riscontrati durante reinstallazioni ripetute su un ambiente TEST sono residui del precedente storico; non sono stati riprodotti su una nuova installazione realmente priva di database preesistente.

Nessuna credenziale, fattura o backup dell'utente è inclusa nella release. La produzione Home Assistant dell'utente non è stata modificata per pubblicare questo pacchetto.

ATS v0.4.0-beta.8

ATS v0.4.0-beta.8 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 08 Nov 15:47

Beta.8: live-parity ATS sensors, corrected payments and SupplyNo, authenticated on-demand PDF archive, bundled PDF.js Lovelace card, example dashboards, Italian/English docs and clean-instance tests. No user credentials or invoices are bundled. This is a pre-release from EnrCol/ats-ha, not an upstream release.

ATS v0.4.0-beta.7

ATS v0.4.0-beta.7 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 08 Nov 15:17

Beta.7: live-parity ATS sensors, corrected payments and SupplyNo, authenticated on-demand PDF archive, bundled PDF.js Lovelace card, example dashboards, Italian/English docs and clean-instance tests. No user credentials or invoices are bundled. This is a pre-release from EnrCol/ats-ha, not an upstream release.

ATS v0.4.0-beta.6

ATS v0.4.0-beta.6 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 08 Nov 11:35

Beta.6: live-parity ATS sensors, corrected payments and SupplyNo, authenticated on-demand PDF archive, bundled PDF.js Lovelace card, example dashboards, Italian/English docs and clean-instance tests. No user credentials or invoices are bundled. This is a pre-release from EnrCol/ats-ha, not an upstream release.

ATS v0.4.0-beta.5 — Formato data ultima lettura

Choose a tag to compare

@EnrCol EnrCol released this 06 Nov 20:02

La beta.5 comprende sia il nuovo formato GG-MM-AAAA sia le correzioni al parsing delle date, alle scadenze e ai conteggi.

ATS v0.4.0-beta.4 — Unità e visualizzazione

Choose a tag to compare

@EnrCol EnrCol released this 06 Nov 18:56

ATS v0.4.0-beta.4 — Unità e visualizzazione

  • Corretta l'unità di misura m³ del sensore Consumo fatturato totale.
  • Suggerita la visualizzazione senza decimali per i sensori di consumo idrico, mantenendo invariata la precisione dei valori interni.
  • Rinominato il sensore Dettagli utenze, che comprende forniture attive e cessate.
  • Conservati gli identificativi dei 19 sensori e la compatibilità con le installazioni esistenti.
  • Tutti i controlli GitHub Actions superati.

ATS v0.4.0-beta.3 — Storico economico

Pre-release

Choose a tag to compare

@EnrCol EnrCol released this 05 Nov 22:13

ATS v0.4.0-beta.3 — Storico economico

  • Storico completo delle fatture negli attributi di Fatture presenti.
  • Riepilogo economico per anno: numero fatture, totale fatturato e totale pagato.
  • Date visualizzate in formato GG-MM-AAAA.
  • Conservazione degli attributi originali e delle date ISO per compatibilità.
  • Gestione di importi mancanti e fatture prive di data di emissione.
  • Include i nuovi sensori annuali della beta.2.
  • Test di regressione e validazioni GitHub Actions superati.

ATS v0.4.0-beta.2 — Metriche annuali

Pre-release

Choose a tag to compare

@EnrCol EnrCol released this 05 Nov 21:57

ATS v0.4.0-beta.2 — Metriche annuali

  • Aggiunto il sensore Totale fatture anno corrente, basato sulla data di emissione.
  • Aggiunto il sensore Previsione consumo annuo, calcolato dalle ultime due letture effettive validate di ciascun contatore attivo.
  • Confronto con la stima annuale comunicata da ATS negli attributi.
  • Gestione di letture mancanti, contatori cessati e più forniture attive.
  • Aggiunti test di regressione.
  • Aggiornata la documentazione italiana e inglese.
  • Tutti i controlli GitHub Actions superati.

Versione beta da validare su Home Assistant reale.

v0.4.0-beta.1

v0.4.0-beta.1 Pre-release
Pre-release

Choose a tag to compare

@EnrCol EnrCol released this 05 Nov 21:04
Clarify beta branch installation versus HACS default main (EN)