Registrazione e fatturazione del tempo di supporto in Dolibarr
Cronometro chiamata Supporto telefonico Pulsante cuffia flottante Fatturazione del tempo Forfait mensile incluso Scheda terzo KPI per cliente
Presentazione
TempsSupport è un modulo esterno per Dolibarr ERP/CRM (editore KSIDol) che aggiunge il monitoraggio del tempo di supporto telefonico, dalla chiamata alla fattura.
Un pulsante flottante (icona cuffia) è presente su tutte le pagine: con un clic si avvia un cronometro collegato a un cliente, si descrive l'oggetto della chiamata e poi si registra il tempo. Ogni scheda terzo riceve una scheda che elenca i suoi tempi e permette di fatturarli, singolarmente o in blocco, con gestione di un forfait mensile incluso.
Il modulo non modifica alcun file del core di Dolibarr.
Editore e supporto
| Elemento | Informazione |
|---|---|
| Editore | KSIDol |
| Specialità | Integratore Dolibarr |
| Servizi | Sviluppo su misura, hosting SaaS, affiancamento Dolibarr |
| Sito web | https://www.ksidol.io |
| Supporto | support@ksidol.io |
| Moduli Dolistore | https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= |
Informazioni sul modulo
| Informazione | Dettaglio |
|---|---|
| Nome del modulo | TempsSupport |
| Uso principale | Cronometrare il tempo di supporto telefonico per cliente e fatturarlo |
| Tipo | Modulo esterno di Dolibarr |
| Famiglia | CRM / Relazione con il cliente |
| Versione documentata | 24.0.0 |
| Compatibilità Dolibarr | Dolibarr 18.0 a 24.x |
| Compatibilità PHP | PHP 7.4 o superiore |
| Modifica del core di Dolibarr | No |
| Licenza | GNU GPLv3 |
| Lingue disponibili | Francese, Inglese, Tedesco, Spagnolo, Italiano |
Collegamenti ufficiali
- Video dimostrativo: TempsSupport — demo (YouTube)
- Negozio: KSIDol.io
- Scheda del modulo: ksidol.io/it
- Pagina editore K.S.I su DoliStore: Moduli K.S.I su DoliStore
Obiettivi del modulo
Consentire a fornitori di servizi, software house, assistenza e hotline di misurare con precisione il tempo trascorso al telefono con ogni cliente, senza strumenti esterni, e poi trasformare quel tempo in fattura:
- cronometrare ogni chiamata (in entrata o in uscita) da qualsiasi pagina di Dolibarr;
- collegare il tempo al cliente e all'oggetto corretti;
- fatturare il tempo singolarmente o in blocco, con arrotondamento e durata minima;
- gestire offerte di supporto a forfait (minuti inclusi al mese, fatturazione del solo eccedente).
Per chi?
- Fornitori di servizi e software house con supporto telefonico fatturabile.
- Assistenza e hotline che vogliono tracciare e valorizzare il tempo telefonico.
- Qualsiasi organizzazione che offra supporto a forfait con un volume di minuti incluso al mese.
Funzionalità principali
- Pulsante cuffia flottante: presente su tutte le pagine, qualunque sia il tema (eldy, moderntemplate), senza modifica del core; attivabile/disattivabile in configurazione.
- Cronometro chiamata: cercare (o creare) un terzo, scegliere il verso (in entrata / in uscita), avviare il cronometro, inserire l'oggetto, poi «Fine chiamata». Il cronometro persiste durante la navigazione (memoria locale del browser).
- Registrazione: ogni chiamata diventa un tempo (riferimento, terzo, contatto, verso, inizio/fine, durata reale, durata fatturata, oggetto, stato).
- Scheda terzo: elenco dei tempi del cliente (durata reale e fatturata) con azioni Fatturare / Modificare / Non fatturare / Rendere fatturabile, e caselle per la fatturazione raggruppata.
- Fatturazione: genera una fattura bozza con una riga per tempo (quantità in ore); il prezzo proviene dal prodotto/servizio configurato o da una tariffa oraria di ripiego. Arrotondamento (scaglione) e durata minima applicati alla durata fatturata.
- KPI per terzo: numero di tempi registrati, durata reale cumulata e tempo da fatturare.
Forfait mensile incluso
Ogni terzo può disporre di un volume di minuti inclusi al mese (o un forfait predefinito del modulo). Il monitoraggio mostra il consumato, il residuo e leccedente:
- il tempo coperto dal forfait è contrassegnato «Incluso» e non genera fattura;
- l'eccedente è fatturato al prezzo dell'ora aggiuntiva (extrafield per terzo).
Menu
Il modulo aggiunge un menu principale Tempo Supporto con:
- Elenco dei tempi — tutti i tempi registrati
- Da fatturare — tempi con stato «Da fatturare»
- Configurazione — parametri del modulo
Una scheda Tempo Supporto è aggiunta anche sulla scheda terzo.
Configurazione
Da Home → Configurazione → Moduli → Tempo Supporto:
- mostrare il pulsante flottante (sì/no);
- prodotto/servizio di fatturazione (riferimento sulle righe di fattura);
- usare il prezzo del prodotto (sì/no);
- tariffa oraria di ripiego (se il prodotto non ha prezzo);
- arrotondamento della durata fatturata (minuti; 0 = durata reale);
- durata minima fatturata (minuti; 0 = nessuna);
- forfait di supporto predefinito / mese (minuti).
Vengono aggiunti due extrafield sulla scheda terzo: forfait incluso / mese e prezzo ora aggiuntiva.
Permessi utente
Il modulo definisce cinque permessi:
- Consultare i tempi di supporto (read)
- Creare / modificare i tempi di supporto (write)
- Fatturare i tempi di supporto (bill)
- Eliminare i tempi di supporto (delete)
- Configurare il modulo (config)
Uso quotidiano
- Il telefono squilla: clic sul pulsante cuffia.
- Cercare il cliente, verso «Chiamata in entrata», «Avvia cronometro».
- Durante la chiamata, navigare liberamente in Dolibarr — il cronometro continua.
- Inserire l'oggetto, «Fine chiamata»: il tempo è registrato.
- A fine mese, scheda «Tempo Supporto» del cliente: selezionare i tempi, «Fatturare la selezione».
- La fattura bozza è creata (una riga per chiamata); il tempo coperto dal forfait è contrassegnato «Incluso».
Nota tecnica
- Tabella:
llx_tempssupport_ticket(un record per tempo di supporto). - Risorse caricate su tutte le pagine tramite
module_parts(hook main, CSS e JS del modulo). - Persistenza del cronometro lato browser (memoria locale).
- Standard Dolibarr rispettati: hook, permessi, token CSRF,
GETPOST, escaping. - Nessuna modifica del core di Dolibarr.
Installazione
- Decomprimi l'archivio per ottenere una cartella
tempssupport/. - Copiala in
htdocs/custom/del tuo Dolibarr. - Verifica i permessi di scrittura su
documents/tempssupport/. - Attiva il modulo da Home → Configurazione → Moduli/Applicazioni.
- All'attivazione, la tabella e gli extrafield necessari vengono creati automaticamente.
Aggiornamento
- Sostituisci la cartella
htdocs/custom/tempssupport/con la nuova versione. - Ricarica una pagina di amministrazione: lo schema (colonne, extrafield) viene verificato e completato automaticamente, in modo idempotente.
- L'aggiornamento non elimina alcun dato esistente.
Risoluzione dei problemi
- Il pulsante non appare: verifica che l'opzione «Mostrare il pulsante flottante» sia su Sì e che l'utente abbia il permesso di consultazione.
- Niente da fatturare: i tempi devono avere lo stato «Da fatturare» e appartenere allo stesso terzo; un tempo interamente coperto dal forfait non genera riga.
- Prezzo a zero sulla fattura: indica un prezzo sul prodotto/servizio o una tariffa oraria di ripiego.
Vedi anche
- Terminale di firma KSIDol: firma di tutte le schede native di Dolibarr, compatibile con tutti i moduli KSIDol.
- Compatibilità: Dolibarr 18.0 a 24.x — PHP 7.4+ — Licenza GPLv3 — Editore: KSIDol.
Riepilogo
TempsSupport cronometra il supporto telefonico dei tuoi clienti da qualsiasi pagina di Dolibarr (pulsante cuffia), lo registra per terzo e lo trasforma in fattura — singolarmente o in blocco, con arrotondamento, durata minima e un forfait mensile incluso (fatturazione del solo eccedente).