Gestione stati
Il ciclo di vita completo di un contratto, i controlli a ogni passaggio e chi può farlo avanzare.
Lo stato del contratto
Ogni contratto ha uno stato, che rappresenta a che punto è arrivato nel suo percorso verso l'attivazione. Lo stato non si può modificare a piacere: si può avanzare (o tornare indietro) solo attraverso transizioni predefinite, ciascuna con le proprie regole.
Perché funziona così
Vincolare i passaggi a transizioni fisse (invece di lasciare lo stato liberamente modificabile) garantisce che non si possa, ad esempio, attivare un contratto senza che sia mai stato accettato, o cessarne uno che non è mai stato attivo. Ogni transizione applica i propri controlli di validazione prima di essere eseguita.
Gli stati possibili
| Stato | Significato |
|---|---|
| Nuovo | Il contratto è stato appena creato: dati anagrafici e tecnici raccolti, ma non ancora pronto per essere inviato al fornitore. |
| Inviabile al fornitore | Il contratto ha superato i controlli minimi ed è pronto per essere trasmesso al fornitore. |
| Inviato | Il contratto è stato trasmesso al fornitore ed è in attesa di riscontro. |
| Accettato | Il fornitore ha accettato il contratto: è in lavorazione per l'attivazione tecnica. |
| Attivo | La fornitura è effettivamente attiva presso il cliente. |
| Cessato | La fornitura, già attiva, è terminata (switch verso altro fornitore, chiusura utenza, disdetta). |
| Annullato | Il contratto è stato interrotto/scartato prima o durante il percorso — vedi la guida Gestione KO. |
Il percorso e le transizioni
Nuovo → Inviabile al fornitore → Inviato → Accettato → Attivo → Cessato
Da qualunque stato, un contratto può essere spostato in Annullato: è l'unica transizione trasversale, pensata per gestire anomalie in qualsiasi punto del percorso (vedi Gestione KO). Un contratto annullato può a sua volta essere riproposto, tornando in stato Nuovo per essere rilavorato da capo.
Cosa viene controllato prima di ogni avanzamento
Prima di consentire un avanzamento verso "Inviabile al fornitore" o oltre, UtiliX verifica che il contratto abbia tutti i dati essenziali:
- Cliente, Punto di Prelievo, Fornitore, Prodotto e Metodo di Pagamento devono essere tutti valorizzati.
- I dati tecnici richiesti dalla prestazione selezionata devono essere completi (es. potenza e tensione per una fornitura elettrica).
- Il prodotto applicato deve avere un listino prezzi valido per il periodo del contratto.
Se manca anche un solo dato obbligatorio, UtiliX blocca l'avanzamento e mostra l'elenco preciso di cosa manca, così puoi correggere il contratto direttamente dal punto giusto invece di ricevere un errore generico.
Chi può far avanzare uno stato
Il permesso necessario dipende dalla transizione specifica, non solo dal ruolo:
| Transizione | Chi può eseguirla |
|---|---|
| Accetta (→ Accettato) | Backoffice/Admin, oppure Agente con permesso energia.contratti.can_accept |
| Attiva (→ Attivo) | Backoffice/Admin, oppure Agente con permesso dedicato all'attivazione |
| Cessa (→ Cessato) | Backoffice/Admin, oppure Agente con permesso dedicato alla cessazione |
| Annulla (→ Annullato) | Disponibile da qualunque stato a chi ha il permesso di annullamento — vedi Gestione KO |
| Riproponi (da Annullato → Nuovo) | Solo se l'annullamento non è marcato come "definitivo" — vedi Gestione KO |
Admin e Backoffice non hanno restrizioni di stato
Un Admin o un Backoffice può sempre modificare un contratto, in qualunque stato si trovi. Un Agente, invece, è bloccato dal modificare liberamente un contratto già Attivo o Cessato, anche se ha ricevuto permessi operativi estesi: su questi due stati, solo Admin e Backoffice possono intervenire.
I permessi si assegnano da Impostazioni
L'elenco completo dei permessi assegnabili sul ciclo di vita dei contratti (categoria "Energia") si configura utente per utente dalla pagina Permessi.
Attivazione e cessazione: un interruttore a livello di agenzia
Alcune agenzie vogliono che la gestione dei contratti si fermi allo stato ACCETTATO, preferendo non gestire l'attivazione e la cessazione degli stessi.
Automazione stato attivo/cessato
Nelle Impostazioni Generali dell'agenzia esiste un interruttore che, se disattivato, blocca chiunque (compresi Admin e Backoffice) dal muovere manualmente un contratto verso Attivo o Cessato. Se non sei sicuro del perché non riesci ad attivare un contratto pur avendo i permessi giusti, controlla prima questa impostazione.
Aggiornamento massivo degli stati
Quando ricevi dal fornitore un file con l'esito di molti contratti insieme (es. un elenco di attivazioni o cessazioni del mese), non serve aprirli uno per uno: puoi caricare un file CSV/Excel e far aggiornare lo stato in blocco.
Prepara il file
Un file con almeno una colonna che identifichi il contratto (es. codice contratto) e una colonna con il nuovo stato/data da applicare.
Carica il file
Dalla lista contratti, usa l'azione di importazione stati e seleziona il file.
Elaborazione in background
L'aggiornamento massivo viene elaborato in modo asincrono: puoi continuare a lavorare mentre il sistema processa le righe, e ricevi un riepilogo via mail con eventuali righe scartate (es. contratto non trovato, o transizione non valida da quello stato).
Permesso riservato
L'importazione massiva di stati è un'operazione riservata a Backoffice/Admin: un Agente semplice non la vede tra le azioni disponibili, anche con permessi estesi sul ciclo di vita del contratto.
Vedi anche