Repository navigation
Releases
ATS v0.4.1 — Maintainer metadata
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
codeownersdel 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
LICENSEmantengono 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.1per 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
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=trueprevale suToPayper il conteggio delle fatture da pagare. Gestione del campoSupplyNoanche quando ATS lo restituisce come array. - PDF autenticati: servizio
ats.download_invoicesper 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 PDFeScarica 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'attributoats_metricidentifica 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
/mediacontengono dati personali e richiedono protezione degli accessi. unique_ide identificativi registrati degli utenti esistenti restano invariati. Le impostazioni API/cookie legacy rimangono disponibili nelle opzioni.- I
codeownersoriginali sono mantenuti per attribuzione e continuità con il progetto upstream; documentazione e issue tracker della release puntano al fork.
Installazione / aggiornamento
- Aggiungi
EnrCol/ats-hacome repository personalizzato nella sezione Integrazioni del Marketplace/HACS. - Installa la release
v0.4.0e riavvia Home Assistant. - Per una nuova installazione inserisci username/password dello Sportello ATS. Per un aggiornamento conserva la config entry: non eliminare e ricreare l'integrazione.
- 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.
- Se vuoi archiviare i PDF premi
Scarica fatture ATS mancantie 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
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
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
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
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
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
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
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
Clarify beta branch installation versus HACS default main (EN)