Alert — Cliente 84521, contratto GAS-F-2024-09. Bolletta aprile 2026 bloccata. Anomalia: componente QVD applicata con il valore del trimestre precedente invece del valore aggiornato al 1° aprile 2026. Differenza sul totale: €18,40 a favore del cliente. Disclosure "confronto con Placet" assente per questa offerta a prezzo variabile.
AGENTE · BOLLETTA VALIDATOR
La bolletta esce verificata su calcolo e disclosure ARERA.
Bolletta Validator verifica pre-invio ogni bolletta energia o gas: correttezza del calcolo (componenti energia, oneri di sistema, accise, IVA), presenza delle disclosure obbligatorie ARERA, coerenza con il contratto attivo del cliente. Blocca l'invio e scala al team fatturazione se identifica anomalie.
Bolletta Validator al lavoro.
Correggiamo entrambi. Ricalcola con QVD corretto e aggiungi la disclosure.
Ricalcolo completato con valore QVD del primo trimestre 2026. Disclosure "confronto con Placet" aggiunta secondo il template ARERA vigente. Bolletta aggiornata pronta per il secondo check. Attendo conferma per procedere all'invio.
Perché esiste.
La bolletta utility è il documento più ricevuto dal cliente retail e il punto più frequente di reclamo. ARERA regola il formato con vincoli stringenti — formato "bolletta 2.0", elementi obbligatori, formulazioni dichiarate. Gli errori di calcolo o le disclosure mancanti generano contestazioni, reclami formali al Servizio Conciliazione, sanzioni ARERA.
Come verifica pre-invio.
Bolletta Validator si attiva pre-invio. Legge la bolletta dal sistema di fatturazione utility, verifica il calcolo delle componenti tariffarie (energia, oneri di sistema, accise statali e regionali, IVA), verifica la presenza delle disclosure obbligatorie ARERA, controlla la coerenza con il contratto attivo del cliente. Identifica anomalie e scala al team contabilità tecnica.
La decisione resta al responsabile fatturazione.
Per bollette standard senza anomalie l'invio procede automaticamente. Per anomalie identificate, blocco con escalation al team fatturazione con il punto specifico in evidenza. La completezza delle regole di calcolo rispetto ai tariffari ARERA aggiornati è responsabilità del team fatturazione e compliance della utility.
Per chi è utile e dove si applica.
Responsabile fatturazione
Vede ridursi gli errori di calcolo sistematici che generano il flusso di reclami più costoso operativamente: la bolletta sbagliata in favore del cliente che non si accorge, e la bolletta sbagliata in favore della utility che genera contestazione formale al Servizio Conciliazione.
fnol.receive 09:14:22 ALLOW
triage.classify 09:14:25 ALLOW
idd.check 09:14:31 WARN
liquidation.propose 09:15:02 ALLOW
SELECT * FROM audit_log WHERE claim_id = '2024-0847'
Compliance officer ARERA
Dispone della traccia ispezionabile della verifica disclosure per ogni bolletta inviata. In caso di audit ARERA sulla qualità delle comunicazioni commerciali, il registro è interrogabile con client SQL standard.
fnol.receive 09:14:22 ALLOW
triage.classify 09:14:25 ALLOW
idd.check 09:14:31 WARN
liquidation.propose 09:15:02 ALLOW
SELECT * FROM audit_log WHERE claim_id = '2024-0847'
Team customer service
Vede ridursi le richieste di spiegazione bolletta che arrivano per anomalie di calcolo — il problema viene intercettato prima dell'invio, non dopo la contestazione del cliente. Le chiamate del customer service tornano a essere su cose nuove, non su correzioni a posteriori.
Outage in corso ETA 35'
Zona Nord-Est cluster B
Field team 3 squadre · in transito
SLA cliente reset · 20'
Report ARERA in preparazione · 4h
Un esempio concreto.
Una bolletta gas entra nel flusso di verifica.
Per una utility mid-market con 200.000 clienti retail, il sistema di fatturazione genera mediamente 16.000 bollette al mese. L'agente è integrato con il sistema di fatturazione via webhook pre-invio. Una bolletta gas del cliente ID 84521 — contratto a prezzo variabile — entra nel flusso di verifica. L'agente analizza il calcolo.
QVD trimestre vecchio e disclosure mancante.
Rileva che la componente tariffaria QVD è stata applicata con il valore del trimestre precedente invece del valore aggiornato dalla delibera ARERA entrata in vigore il 1° aprile. La differenza sul totale è di €18,40 a favore del cliente. Rileva anche l'assenza della disclosure "confronto con Placet" — obbligatoria per i clienti con offerta a prezzo variabile.
Il responsabile conferma, la bolletta si rilascia.
Blocco bolletta e alert al responsabile fatturazione con i due punti in evidenza. Il responsabile conferma la correzione. L'agente ricalcola con il valore QVD corretto e aggiunge la disclosure dal template ARERA vigente. Seconda verifica: tutto conforme. Bolletta rilasciata per l'invio. L'evento resta nel registro audit per ispezione compliance ARERA.
Configurazione e risorse tecniche.
Le regole di Bolletta Validator sono dichiarative. Il team fatturazione e il compliance officer ARERA della utility definiscono in formato leggibile i tariffari attivi per tipo di contratto, le disclosure obbligatorie per canale di comunicazione e tipo di offerta, le regole di calcolo dei componenti tariffari, le soglie di anomalia. Le regole vivono nel repository della utility, versionate, validate all'avvio dell'agente.
- Linguaggio
- TypeScript (Node.js)
- Modello LLM
- a scelta del cliente: Anthropic, OpenAI, Mistral, modelli open source ospitati internamente, AWS Bedrock per modello privato
- Controlli built-in usati
- pii-detector, tool-param-validator
- Canali nativi
- Slack, Telegram, HTTP OpenAI-compatible
- Integrazione sistema fatturazione utility
- adapter dedicato realizzato in fase di delivery
- Tariffari ARERA
- dichiarativi, aggiornati dal team compliance al momento di ogni nuova delibera
- Memoria
- persistente per istanza, pgvector + PostgreSQL FTS
- Registro
- immutabile, audit ARERA ispezionabile
Domande frequenti sull'agente.
Le regole di calcolo nel repository vengono aggiornate dal team fatturazione ogni volta che ARERA pubblica nuovi valori tariffari — QVD, CCR, oneri di sistema. La responsabilità della tempestività e della completezza degli aggiornamenti resta del team fatturazione e compliance della utility. Il repository è versionato: ogni modifica è tracciata con data e autore.
Le bollette di conguaglio rientrano nel flusso di verifica standard se le regole di calcolo del conguaglio sono configurate nel repository. Il tipo di verifica dipende dalla complessità del calcolo di conguaglio specifico della utility e dal formato del documento.
Il pattern tipico per Bolletta Validator è 12-18 settimane. Discovery e mappatura dei tipi di contratto attivi 2-3 settimane, configurazione delle regole di calcolo e disclosure per i tipi principali 4-6 settimane, integrazione con il sistema di fatturazione 4-6 settimane, validazione su sample reale e hand-off al team 2-3 settimane.
L'agente elabora le bollette in parallelo via webhook per istanza. La capacità di elaborazione si dimensiona in fase di delivery sulla base del volume mensile e della finestra di elaborazione disponibile (es. tutte le bollette di un batch elaborate entro la finestra notturna).
Da una conversazione di 30 minuti alla squadra in produzione.
Una conversazione di 30-45 minuti per capire come Bolletta Validator si configurerebbe sulla struttura di fatturazione della utility. Quale sistema di fatturazione, quali tipi di contratto, quale volume mensile.