Skip to content

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.