Registrazione e fatturazione del tempo di supporto in Dolibarr

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search


TempsSupport per Dolibarr
Cronometra il tempo di supporto telefonico per cliente e fatturalo direttamente in Dolibarr, con forfait mensile incluso
   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

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

  1. Il telefono squilla: clic sul pulsante cuffia.
  2. Cercare il cliente, verso «Chiamata in entrata», «Avvia cronometro».
  3. Durante la chiamata, navigare liberamente in Dolibarr — il cronometro continua.
  4. Inserire l'oggetto, «Fine chiamata»: il tempo è registrato.
  5. A fine mese, scheda «Tempo Supporto» del cliente: selezionare i tempi, «Fatturare la selezione».
  6. 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

  1. Decomprimi l'archivio per ottenere una cartella tempssupport/.
  2. Copiala in htdocs/custom/ del tuo Dolibarr.
  3. Verifica i permessi di scrittura su documents/tempssupport/.
  4. Attiva il modulo da Home → Configurazione → Moduli/Applicazioni.
  5. All'attivazione, la tabella e gli extrafield necessari vengono creati automaticamente.

Aggiornamento

  1. Sostituisci la cartella htdocs/custom/tempssupport/ con la nuova versione.
  2. Ricarica una pagina di amministrazione: lo schema (colonne, extrafield) viene verificato e completato automaticamente, in modo idempotente.
  3. 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.

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).