Repository navigation
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.