Gestione stati
Il ciclo di vita di un contratto telefonia, i controlli a ogni passaggio, chi può farlo avanzare e come aggiornare gli stati in blocco.
Lo stato del contratto
Il ciclo di vita di un contratto telefonia usa esattamente lo stesso motore di stati dei contratti energia (vedi Gestione Stati): stessi stati possibili, stessa tabella permesso-per-transizione, stesso interruttore di automazione a livello di agenzia. Questa guida ne riporta i dettagli specifici alla telefonia.
Gli stati possibili
| Stato (etichetta in UtiliX) | Significato |
|---|---|
| Bozza | Il contratto è stato appena creato: dati raccolti, in attesa di conferma per iniziare la lavorazione. |
| Nuovo | Il contratto è stato promosso ed è pronto per essere preparato per l'invio al fornitore. |
| Da Inviare | Il contratto ha superato i controlli minimi ed è pronto per essere trasmesso al fornitore. |
| Inserito | 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 | Il servizio è effettivamente attivo presso il cliente. |
| Cessato | Il servizio, già attivo, è terminato. |
| Annullato | Il contratto è stato interrotto/scartato — vedi Gestione KO. |
Il percorso e le transizioni
Bozza → Nuovo → Da Inviare → Inserito → Accettato → Attivo → Cessato
Da qualunque stato, un contratto può essere spostato in Annullato (vedi Gestione KO). Un contratto annullato può essere riproposto: questo lo riporta in stato Bozza, pronto per essere corretto e rilavorato da capo — non direttamente a Nuovo, quindi dopo la riproposizione serve premere di nuovo l'azione che promuove il contratto a Nuovo.
Cosa viene controllato prima di ogni avanzamento
Prima di consentire l'avanzamento oltre Bozza, UtiliX verifica che il contratto abbia i dati essenziali:
- Il Cliente deve avere un identificativo fiscale (Codice Fiscale o Partita IVA) valorizzato.
- Il Servizio Telefonico deve essere associato al contratto.
- Il Metodo di Pagamento deve essere impostato.
Se manca anche un solo dato obbligatorio, UtiliX blocca l'avanzamento e mostra l'elenco preciso di cosa manca.
Chi può far avanzare uno stato
Come per l'energia, il permesso necessario dipende dalla transizione specifica:
| Transizione | Permesso |
|---|---|
| Bozza → Nuovo | telefonia.contratti.can_promote_to_new (assegnato di default anche agli Agenti) |
| Nuovo → Da Inviare | telefonia.contratti.can_sendable_to_supplier |
| Da Inviare → Inserito | telefonia.contratti.can_send_to_supplier |
| Inserito → Accettato | telefonia.contratti.can_accept |
| Accettato → Attivo | telefonia.contratti.can_activate |
| Attivo → Cessato | telefonia.contratti.can_cessate |
| Qualunque stato → Annullato | telefonia.contratti.can_cancel |
| Annullato → Bozza (riproposizione) | telefonia.contratti.can_repropose (assegnato di default anche agli Agenti) |
Admin e Backoffice non hanno restrizioni di stato
Un Admin o un Backoffice può sempre modificare un contratto telefonia, in qualunque stato si trovi. Un Agente, invece, resta bloccato su un contratto Attivo o Cessato anche con permessi estesi: su questi due stati può intervenire solo Admin o Backoffice.
Permessi di default
Di serie, un Agente riceve solo i permessi per creare un contratto, promuoverlo a Nuovo e riproporlo se annullato: tutte le altre transizioni (inviabile, invio, accettazione, attivazione, cessazione, annullamento) sono riservate al Backoffice finché non le assegni esplicitamente. Consulta Permessi.
Attivazione e cessazione: lo stesso interruttore dei contratti energia
Automazione stato attivo/cessato
L'interruttore nelle Impostazioni Generali che blocca il passaggio manuale ad Attivo/Cessato vale contemporaneamente per contratti energia e telefonia: se lo disattivi, nessuno (Admin incluso) può più muovere manualmente un contratto telefonia verso questi due stati.
Aggiornamento massivo degli stati
Quando ricevi dal fornitore un file con l'esito di molti contratti insieme, puoi aggiornarne lo stato in blocco tramite un file CSV/XLSX, con un'importante differenza rispetto ai contratti energia:
Elaborazione immediata, non in background
A differenza dell'importazione massiva sui contratti energia (che viene elaborata in modo asincrono, con un riepilogo via email), l'importazione stati per la telefonia viene elaborata subito, nella stessa richiesta: il risultato completo (righe aggiornate, saltate, in errore) è visibile immediatamente al termine del caricamento.
Prepara il file
Ogni riga deve identificare un contratto tramite la colonna id oppure codice_contratto_fornitore, e indicare lo stato di destinazione nella colonna stato_contratto (NUOVO, ACCETTATO, ATTIVO, CESSATO o ANNULLATO). Un template scaricabile con le colonne corrette è disponibile direttamente dal modulo di importazione.
Aggiungi le colonne per la transizione specifica
A seconda del passaggio richiesto, servono colonne aggiuntive: data_prevista_attivazione per passare a Accettato, data_attivazione per passare ad Attivo, data_cessazione (obbligatoria) e causale_cessazione per passare a Cessato, motivo_annullamento (obbligatorio, deve corrispondere esattamente al nome di un motivo configurato in agenzia) e note_annullamento per annullare.
Valida, poi importa
Puoi eseguire prima una validazione (che controlla il file senza applicare alcuna modifica) e poi lanciare l'importazione reale, con lo stesso file.
Solo alcuni passaggi sono coperti
L'importazione massiva copre i passaggi principali della pipeline (Nuovo → Accettato, Accettato → Attivo, Attivo → Cessato, e l'annullamento da qualunque stato), ma non i passaggi intermedi Da Inviare/Inserito: per quelli usa le singole azioni sulla scheda contratto. Una riga già nello stato richiesto viene semplicemente saltata, senza essere considerata un errore.
Permesso riservato
L'importazione massiva di stati è un'operazione riservata a Backoffice/Admin.
Vedi anche