RAS End-to-End¶

Scopo¶

Questa guida descrive il flusso completo RAS:

richiesta
presa in carico
offerta
ticket
documento
servizio attivo
rinnovo

Vedi anche:

Attori coinvolti¶

amministratore di condominio
commerciale / rete commerciale
rete di gestione
tecnico
admin

Prerequisiti¶

Prima di usare il flusso:

il cliente/condominio deve esistere;
l’amministratore deve essere collegato al condominio;
il servizio RAS deve essere configurato a listino;
le relazioni cliente-servizio-rete devono essere coerenti;
se serve, il tecnico deve avere un incarico attivo.

1. Richiesta RAS¶

La richiesta puo partire da:

portale amministratore;
backoffice interno.

Nel portale l’amministratore:

apre il condominio;
seleziona RAS;
inserisce i dati iniziali:
UA
Box
UC
Mag
allega eventuali documenti;
invia.

Il sistema crea:

una Richiesta Servizio

e, per RAS, instrada anche:

una Trattativa.

2. Presa in carico¶

Dal gestionale:

Commerciale -> Richieste Servizio

Cosa fa il menu:

apre la lista richieste da cui parte la presa in carico commerciale del flusso RAS.

Il commerciale puo:

assegnare il commerciale responsabile;
usare:
Prendi in carico
In lavorazione
aggiungere note pubbliche all’amministratore.

Cosa fanno le azioni:

Prendi in carico: segna che la richiesta e stata accettata in lavorazione dal commerciale;
In lavorazione: sposta la richiesta nello stato operativo attivo;
Nota pubblica: invia un aggiornamento visibile all'amministratore nel portale.

Lo stato della richiesta cambia e il portale amministratore vede l’avanzamento.

3. Offerta RAS¶

Dalla richiesta / trattativa:

Offerta RAS

Cosa fa la vista:

apre il motore di compilazione e calcolo dell'offerta RAS sulla base della richiesta corrente.

L’offerta viene precompilata con i dati iniziali inseriti dall’amministratore.

Il motore RAS usa:

fasce;
tariffazione:
forfait,
per unita,
mista;
equivalenze unitarie;
preset tenant.

Il commerciale:

verifica i numeri;
calcola;
salva l’offerta.

4. Conversione¶

Quando l’offerta viene accettata:

si converte l’offerta;
il sistema crea:
ticket operativo;
documento offerta;
servizio attivo;
la trattativa passa a chiusa_vinta;
la richiesta viene portata a chiusa.

5. Ticket operativo¶

Il ticket serve per l’esecuzione del servizio.

Da qui puoi:

assegnare il tecnico;
usare la chat ticket;
allegare file;
pianificare appuntamenti;
monitorare l’avanzamento.

La visibilita del ticket rispetta il perimetro:

commerciale,
rete di gestione,
tecnico.

6. Documento offerta¶

Alla conversione viene generato il documento offerta.

Il documento:

viene salvato in storage;
viene registrato nel documentale;
e scaricabile tramite route applicativa scoped.

Non usa il portale storage admin come unico canale di accesso.

7. Servizio attivo¶

La conversione genera anche un record in:

Commerciale -> Servizi Attivi

Cosa fa il menu:

apre la lista dei servizi attivi, da cui si controllano scadenze, rinnovi e stato del servizio.

Qui si gestiscono:

stato del servizio;
scadenza rinnovo;
anticipo giorni;
reminder;
rinnovo.

8. Rinnovo¶

Dal servizio attivo puoi:

creare un rinnovo;
generare nuova trattativa / nuova offerta;
monitorare il rinnovo nel cruscotto commerciale.

Il reminder puo essere:

manuale;
automatico;
con SLA e soglie configurabili.

9. Compila e stampa finale RAS¶

Nel compila RAS il flusso corretto e:

compilare le risposte;
caricare e sincronizzare le immagini;
usare Finalizza versione.

Cosa fanno le azioni:

Finalizza versione: chiude la compilazione corrente e accoda la stampa finale RAS;
Scarica ultima stampa PDF: scarica l'ultimo PDF finale disponibile;
Apri libretto: apre il documento principale RAS generato nel documentale.

Per i documenti RAS, Finalizza versione:

crea la versione come prima;
accoda automaticamente la stampa finale in Celery;
evita code duplicate se una stampa e gia queued o running.

Quando il job termina:

viene creato 1 Libretto RAS come documento principale;
vengono create N SCHEDA_* come allegati del libretto;
il tutto viene salvato sul cliente/condominio, categoria RAS;
in lista documenti resta visibile solo la stampa Corrente;
le stampe precedenti finiscono in Storico Stampe.

Nel compila sono disponibili anche:

Scarica ultima stampa PDF;
Apri libretto.

Le regole di stampa sono:

si stampano solo le schede con almeno una risposta utile;
una riga scheda viene inclusa se esiste una risposta utile:
risposta principale SI / NO / In attesa, oppure
dettaglio valorizzato (es. evidenza/misure/rischio/foto) anche con risposta base vuota;
le immagini locali vengono sincronizzate prima della finalizzazione;
se restano immagini solo local:*, la finalizzazione viene bloccata.

Controlli da fare¶

Prima della richiesta¶

[ ] Cliente corretto
[ ] Amministratore collegato
[ ] Servizio RAS attivo
[ ] Relazione cliente-servizio-rete corretta

Prima dell’offerta¶

[ ] Dati iniziali coerenti
[ ] Listino corretto
[ ] Tariffazione corretta
[ ] Equivalenze coerenti

Prima della conversione¶

[ ] Totale corretto
[ ] Note e allegati verificati
[ ] Commerciale assegnato
[ ] Cliente e perimetro corretti

Dopo la conversione¶

[ ] Ticket creato
[ ] Documento generato
[ ] Servizio attivo creato
[ ] Richiesta chiusa

Errori comuni¶

L’offerta non si precompila¶

Controllare:

dati iniziali presenti nella richiesta;
trattativa collegata;
workflow ras_quote.

Il prezzo non torna¶

Controllare:

fasce;
pricing mode;
equivalenze;
preset tenant;
extra non applicati due volte.

Il tecnico non vede il ticket¶

Controllare:

incarico tecnico attivo;
cliente corretto;
servizio corretto;
utente tecnico collegato.