Modulo CRM / Pipeline
Gestione opportunità commerciali — Pipeline Kanban, Attività, Documenti, Forecast
Riferimenti normativi
- GDPR — Reg. UE 2016/679 art. 6 (Base giuridica del trattamento): il trattamento dei dati personali nell'ambito di opportunità commerciali e attività CRM deve fondarsi su una base giuridica lecita. L'interesse legittimo del titolare (art. 6, comma 1, lett. f) può giustificare il trattamento per finalità di vendita diretta a clienti esistenti, mentre per prospect e nuovi contatti è necessario il consenso esplicito dell'interessato.
- D.Lgs. 196/2003 (Codice Privacy — Consenso marketing): in conformità con l'art. 130, le comunicazioni commerciali (email, telefonate, visite) registrate nelle attività CRM richiedono il consenso preventivo dell'interessato. Il modulo consente di verificare lo stato del consenso marketing del soggetto prima della creazione di attività di contatto.
- Reg. UE 2016/679 art. 17 (Diritto alla cancellazione): l'interessato ha diritto di ottenere la cancellazione dei propri dati personali. Le opportunità CRM collegate a un soggetto che esercita il diritto all'oblio devono essere anonimizzate. Il sistema supporta la procedura di anonimizzazione mantenendo i dati aggregati per finalità statistiche.
La vista Pipeline Kanban rappresenta graficamente il flusso delle opportunità commerciali. Ogni colonna corrisponde a uno stadio della pipeline, e ogni card rappresenta un'opportunità.
| Stadio | Probabilità % | Colore | Descrizione |
|---|---|---|---|
| Contatto iniziale | 10% | Grigio | Primo contatto con il prospect, qualificazione preliminare |
| Qualificazione | 25% | Azzurro | Analisi delle esigenze e verifica del budget |
| Proposta | 50% | Blu | Presentazione dell'offerta commerciale |
| Negoziazione | 75% | Arancione | Trattativa in corso su termini e condizioni |
| Chiuso — Vinto | 100% | Verde | Opportunità conclusa con successo |
| Chiuso — Perso | 0% | Rosso | Opportunità non andata a buon fine |
Drag-and-drop
Per spostare un'opportunità tra gli stadi, trascinare la card dalla colonna di origine alla colonna di destinazione. Il sistema aggiorna automaticamente la probabilità e registra la transizione nello storico stadi.
- Accedere al menu CRM → Pipeline per visualizzare la board Kanban.
- Utilizzare i filtri in alto per restringere la vista per agente, periodo o valore minimo.
- Trascinare una card su un nuovo stadio per aggiornare l'opportunità.
- Fare clic su una card per aprire il dettaglio opportunità.
- Premere + Nuova Opportunità per creare un'opportunità direttamente dalla board.
L'archivio presenta tutte le opportunità in formato lista tabellare, con possibilità di ordinamento e filtri avanzati.
Filtri disponibili
| Filtro | Descrizione |
|---|---|
| Stadio | Filtra per uno o più stadi della pipeline |
| Agente | Opportunità assegnate a un agente specifico |
| Soggetto | Ricerca per nome o ragione sociale del cliente |
| Periodo | Intervallo di date sulla data chiusura prevista |
| Valore minimo / massimo | Range di valore dell'opportunità |
| Stato | Aperta, Chiusa — Vinta, Chiusa — Persa |
- Accedere a CRM → Opportunità per aprire l'archivio.
- Utilizzare la barra di ricerca per cercare per titolo o codice opportunità.
- Espandere il pannello Filtri avanzati per combinare più criteri.
- Fare clic sull'intestazione di una colonna per ordinare i risultati.
- Fare clic su una riga per aprire il dettaglio dell'opportunità.
La scheda di dettaglio contiene tutti i dati relativi all'opportunità commerciale.
| Campo | Obbligatorio | Descrizione |
|---|---|---|
| Titolo | Sì | Descrizione sintetica dell'opportunità |
| Codice | Automatico | Formato OPP-YYYY-NNN (es. OPP-2026-001), generato sequenzialmente |
| Valore | Sì | Importo stimato in euro; aggiornato automaticamente dal totale righe prodotto |
| Data chiusura prevista | Sì | Scadenza stimata per la conclusione della trattativa |
| Soggetto | Sì | Cliente collegato dall'anagrafica Soggetti |
| Contatto aziendale | No | Referente specifico all'interno dell'azienda cliente |
| Agente | No | Agente commerciale responsabile dell'opportunità |
| Stadio | Sì | Fase corrente della pipeline (v. sezione 1) |
| Probabilità | Automatico | Determinata dallo stadio; modificabile manualmente |
| Note | No | Annotazioni libere sulla trattativa |
- Dalla lista o dalla Kanban, aprire l'opportunità desiderata.
- Compilare o aggiornare i dati base (titolo, valore, data chiusura prevista).
- Selezionare il soggetto tramite il campo di ricerca autocomplete.
- Assegnare un agente e un contatto aziendale se applicabile.
- Modificare lo stadio tramite il selettore o il drag-and-drop dalla Kanban.
- Premere Salva per confermare le modifiche.
La sezione Righe prodotto consente di dettagliare i prodotti o servizi oggetto dell'opportunità. Il totale delle righe aggiorna automaticamente il valore dell'opportunità.
| Campo | Descrizione |
|---|---|
| Articolo | Selezione dal catalogo prodotti con ricerca autocomplete |
| Descrizione | Precompilata dal catalogo, modificabile manualmente |
| Quantità | Numero di unità |
| Prezzo unitario | Precompilato dal listino associato al soggetto |
| Sconto % | Sconto percentuale applicato alla riga |
| Totale riga | Calcolato: quantità × prezzo unitario × (1 − sconto%) |
- Nel dettaglio opportunità, scorrere alla sezione Righe prodotto.
- Premere + Aggiungi riga per inserire una nuova voce.
- Selezionare l'articolo dal catalogo; prezzo e descrizione vengono precompilati.
- Specificare quantità e un eventuale sconto %.
- Ripetere per ogni prodotto/servizio da includere.
- Il totale opportunità si aggiorna automaticamente. Premere Salva.
Le attività tracciano tutte le interazioni con il cliente nell'ambito dell'opportunità. Ogni attività ha un tipo, una data scadenza e uno stato di completamento.
| Tipo attività | Descrizione |
|---|---|
| CHIAMATA | Telefonata in uscita o in entrata con il contatto |
| Comunicazione via posta elettronica | |
| RIUNIONE | Incontro formale, anche in videoconferenza |
| VISITA | Visita presso la sede del cliente |
| DEMO | Dimostrazione di prodotto o servizio |
| OFFERTA | Invio o presentazione di un'offerta commerciale |
- Nel dettaglio opportunità, aprire la sezione Attività.
- Premere + Nuova Attività.
- Selezionare il tipo di attività dall'elenco.
- Compilare oggetto, descrizione e data scadenza.
- Premere Salva. L'attività appare nella timeline dell'opportunità.
- Al completamento, contrassegnare l'attività come Completata tramite la checkbox o il pulsante dedicato.
Dall'opportunità è possibile generare documenti commerciali che ereditano i dati del soggetto e le righe prodotto.
| Tipo documento | Descrizione |
|---|---|
| Preventivo | Offerta formale con validità temporale, generata dalle righe prodotto |
| Ordine | Conferma d'ordine derivata dal preventivo o creata direttamente |
| Documento | Documento generico collegato all'opportunità (contratto, allegato tecnico, ecc.) |
Crea Documento da Opportunità
- Nel dettaglio opportunità, premere il pulsante Crea Documento da Opportunità.
- Selezionare il tipo di documento da generare (Preventivo, Ordine, Documento).
- Il sistema precompila automaticamente: soggetto, righe prodotto con prezzi e quantità, condizioni di pagamento.
- Verificare e completare eventuali campi aggiuntivi.
- Premere Salva. Il documento viene collegato all'opportunità e visibile nella sezione Documenti.
Il sistema registra automaticamente un audit trail completo di ogni transizione di stadio dell'opportunità.
| Campo | Descrizione |
|---|---|
| Data/ora | Timestamp della transizione |
| Stadio precedente | Stadio di partenza |
| Stadio successivo | Stadio di destinazione |
| Utente | Operatore che ha effettuato la modifica |
| Permanenza | Tempo trascorso nello stadio precedente (giorni) |
Lo storico stadi è consultabile nella tab Storico del dettaglio opportunità. Non è modificabile dall'utente e costituisce un registro di audit a supporto dell'analisi dell'efficacia del processo commerciale.
Il modulo CRM è integrato con il modulo Soggetti. Nella scheda di ogni soggetto con ruolo Cliente è presente la sezione Opportunità CRM.
Sezione "Opportunità CRM" nella scheda soggetto
La sezione visualizza l'elenco di tutte le opportunità collegate al soggetto, con stadio, valore e data chiusura prevista. Da questa sezione è possibile:
- Consultare lo storico completo delle opportunità (aperte e chiuse)
- Aprire il dettaglio di un'opportunità facendo clic sulla riga
- Creare una nuova opportunità tramite il pulsante Nuova Opportunità
- Aprire la scheda del soggetto dal menu Anagrafiche → Soggetti.
- Scorrere alla sezione Opportunità CRM (visibile se il soggetto ha ruolo Cliente).
- Per creare una nuova opportunità, premere Nuova Opportunità.
- Il soggetto viene precompilato automaticamente. Completare i restanti campi obbligatori.
- Premere Salva. L'opportunità appare sia nell'archivio CRM che nella scheda soggetto.
La dashboard principale di NOX Enterprise Suite include una stat card "Opportunità aperte" che mostra in tempo reale:
| Indicatore | Descrizione |
|---|---|
| Numero opportunità aperte | Conteggio delle opportunità in stadi attivi (non chiuse) |
| Valore totale pipeline | Somma dei valori di tutte le opportunità aperte |
| Valore ponderato | Somma dei valori moltiplicati per la probabilità di chiusura |
| Prossime scadenze | Opportunità con data chiusura prevista nei prossimi 7 giorni |
Facendo clic sulla stat card si accede direttamente alla vista Pipeline Kanban filtrata sulle opportunità aperte.
• Pacchetto
VENDITE_B2B attivo sul workspace (configurabile da SUPERADMIN in /admin/pacchetti)
• Profilo attività compatibile: Ferramenta, Elettronica, Associazione (gestione soci), Agente di Commercio
• Permesso utente abilitato in Modifica Utente → Moduli
I tre livelli si applicano in intersezione. Dettagli completi in Gerarchia Pacchetti+Profilo+Utente.
Le opportunità cancellate vengono spostate in un cestino interno invece di essere rimosse fisicamente. Ripristino sempre possibile, eliminazione definitiva solo da admin.
Come funziona
- Colonne DB:
cancellatoIl,cancellatoDa - Endpoint cestino:
GET /api/crm/opportunita/_/cestino - Ripristino:
POST /api/crm/opportunita/:id/ripristina[Admin] - Eliminazione definitiva:
DELETE /api/crm/opportunita/:id/definitivo[Admin + motivazione]
Lista attivi filtra le cancellate
Il GET principale di opportunità esclude di default le righe con cancellatoIl non null. Per includerle esplicitamente: ?includiCancellate=true.
Ogni modifica rilevante viene persistita nella tabella log_modifiche_opportunita.
Campi tracciati
| Campo | Note |
|---|---|
| stadio | cambio fase pipeline |
| esito | APERTA / VINTA / PERSA |
| priorita | ALTA / MEDIA / BASSA |
| valoreStimato / valorePrevisto | importi in euro |
| dataChiusuraPrevista | slittamenti tracciati |
| cancellatoIl | invio al cestino / ripristino |
Consultabile via GET /api/crm/opportunita/:id/audit-log. Include operatore, motivazione opzionale, timestamp.
Endpoint POST /api/crm/opportunita/bulk per operazioni su più opportunità. Richiede ruolo ADMIN.
| Azione | Effetto | Parametri |
|---|---|---|
| cambia-stadio | Sposta N opportunità allo stadio indicato | valore: stadioId |
| marca-persa | Chiude come PERSA con data chiusura corrente | — |
| soft-delete | Sposta nel cestino | opzionale motivazione |
Risposta: { ok, fail, errori[] }. Gli errori per riga sono riportati singolarmente (nessuna transazione atomica).
Vista cronologica che unisce audit log modifiche + storico stadi (tabella OpportunitaStorico già presente).
Endpoint: GET /api/crm/opportunita/:id/timeline. Ordine cronologico descendente. Ogni evento ha tipologia (audit o stadio), data, titolo, descrizione, operatore.
I campi sensibili eventualmente presenti nell'audit log (email, telefono, IBAN se memorizzati per pagamento) sono mascherati automaticamente dall'helper audit-mask.js.