Registro y facturación del tiempo de soporte en Dolibarr

TempsSupport para Dolibarr

Cronometre el tiempo de soporte telefónico por cliente y factúrelo directamente en Dolibarr, con bono mensual incluido

   Cronómetro de llamada
   Soporte telefónico
   Botón flotante de auriculares
   Facturación del tiempo
   Bono mensual incluido
   Pestaña de tercero
   KPI por cliente

Presentación

TempsSupport es un módulo externo para Dolibarr ERP/CRM (editor KSIDol) que añade un seguimiento del tiempo de soporte telefónico, de la llamada a la factura.

Un botón flotante (icono de auriculares) está presente en todas las páginas: con un clic se lanza un cronómetro vinculado a un cliente, se describe el asunto de la llamada y luego se guarda el tiempo. Cada ficha de tercero recibe una pestaña que lista sus tiempos y permite facturarlos, individualmente o en lote, con gestión de un bono mensual incluido.

El módulo no modifica ningún archivo del núcleo de Dolibarr.

Editor y soporte

Elemento	Información
Editor	KSIDol
Especialidad	Integrador Dolibarr
Servicios	Desarrollo a medida, alojamiento SaaS, acompañamiento Dolibarr
Sitio web	https://www.ksidol.io
Soporte	support@ksidol.io
Módulos Dolistore	https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=

Información del módulo

Información	Detalle
Nombre del módulo	TempsSupport
Uso principal	Cronometrar el tiempo de soporte telefónico por cliente y facturarlo
Tipo	Módulo externo de Dolibarr
Familia	CRM / Relación con el cliente
Versión documentada	24.0.0
Compatibilidad Dolibarr	Dolibarr 18.0 a 24.x
Compatibilidad PHP	PHP 7.4 o superior
Modificación del núcleo de Dolibarr	No
Licencia	GNU GPLv3
Idiomas disponibles	Francés, Inglés, Alemán, Español, Italiano

Enlaces oficiales

Vídeo de demostración: TempsSupport — demo (YouTube)
Tienda: KSIDol.io
Ficha del módulo: ksidol.io/es
Página del editor K.S.I en DoliStore: Módulos K.S.I en DoliStore

Objetivos del módulo

Permitir a prestadores de servicios, editores de software, SAT y líneas de atención medir con precisión el tiempo pasado al teléfono con cada cliente, sin herramienta externa, y luego transformar ese tiempo en factura:

cronometrar cada llamada (entrante o saliente) desde cualquier página de Dolibarr;
vincular el tiempo al cliente y al asunto correctos;
facturar el tiempo individualmente o en lote, con redondeo y duración mínima;
gestionar ofertas de soporte por bono (minutos incluidos por mes, facturación solo del exceso).

¿Para quién?

Prestadores de servicios y editores de software que ofrecen soporte telefónico facturable.
SAT y líneas de atención que desean registrar y valorar el tiempo telefónico.
Cualquier organización que ofrezca soporte por bono con un volumen de minutos incluido por mes.

Funcionalidades principales

Botón flotante de auriculares: presente en todas las páginas, sea cual sea el tema (eldy, moderntemplate), sin modificación del núcleo; activable/desactivable en la configuración.
Cronómetro de llamada: buscar (o crear) un tercero, elegir el sentido (entrante / saliente), lanzar el cronómetro, introducir el asunto, luego «Fin de llamada». El cronómetro persiste durante la navegación (almacenamiento local del navegador).
Registro: cada llamada se convierte en un tiempo (referencia, tercero, contacto, sentido, inicio/fin, duración real, duración facturada, asunto, estado).
Pestaña de tercero: lista de los tiempos del cliente (duración real y facturada) con acciones Facturar / Modificar / No facturar / Hacer facturable, y casillas para la facturación agrupada.
Facturación: genera una factura borrador con una línea por tiempo (cantidad en horas); el precio proviene del producto/servicio configurado o de una tarifa horaria de reserva. Se aplican redondeo (escalón) y duración mínima a la duración facturada.
KPI por tercero: número de tiempos registrados, duración real acumulada y tiempo por facturar.

Bono mensual incluido

Cada tercero puede disponer de un volumen de minutos incluidos por mes (o un bono por defecto del módulo). El seguimiento muestra el consumido, el restante y el exceso:

el tiempo cubierto por el bono se marca «Incluido» y no genera factura;
el exceso se factura al precio de la hora adicional (extrafield por tercero).

Menús

El módulo añade un menú principal Tiempo Soporte con:

Lista de tiempos — todos los tiempos registrados
Por facturar — tiempos con estado «Por facturar»
Configuración — parámetros del módulo

También se añade una pestaña Tiempo Soporte en la ficha de tercero.

Configuración

Desde Inicio → Configuración → Módulos → Tiempo Soporte:

mostrar el botón flotante (sí/no);
producto/servicio de facturación (referencia en las líneas de factura);
usar el precio del producto (sí/no);
tarifa horaria de reserva (si el producto no tiene precio);
redondeo de la duración facturada (minutos; 0 = duración real);
duración mínima facturada (minutos; 0 = ninguna);
bono de soporte por defecto / mes (minutos).

Se añaden dos extrafields en la ficha de tercero: bono incluido / mes y precio hora adicional.

Permisos de usuario

El módulo define cinco permisos:

Consultar los tiempos de soporte (read)
Crear / modificar los tiempos de soporte (write)
Facturar los tiempos de soporte (bill)
Eliminar los tiempos de soporte (delete)
Configurar el módulo (config)

Uso diario

Suena el teléfono: clic en el botón de auriculares.
Buscar el cliente, sentido «Llamada entrante», «Lanzar cronómetro».
Durante la llamada, navegar libremente por Dolibarr — el cronómetro sigue.
Introducir el asunto, «Fin de llamada»: el tiempo se registra.
A fin de mes, pestaña «Tiempo Soporte» del cliente: seleccionar los tiempos, «Facturar la selección».
Se crea la factura borrador (una línea por llamada); el tiempo cubierto por el bono se marca «Incluido».

Nota técnica

Tabla: llx_tempssupport_ticket (un registro por tiempo de soporte).
Recursos cargados en todas las páginas mediante module_parts (hook main, CSS y JS del módulo).
Persistencia del cronómetro en el navegador (almacenamiento local).
Estándares de Dolibarr respetados: hooks, permisos, tokens CSRF, GETPOST, escape.
Sin modificación del núcleo de Dolibarr.

Instalación

Descomprima el archivo para obtener una carpeta tempssupport/.
Cópiela en htdocs/custom/ de su Dolibarr.
Compruebe los permisos de escritura en documents/tempssupport/.
Active el módulo desde Inicio → Configuración → Módulos/Aplicaciones.
Al activar, la tabla y los extrafields necesarios se crean automáticamente.

Actualización

Sustituya la carpeta htdocs/custom/tempssupport/ por la nueva versión.
Recargue una página de administración: el esquema (columnas, extrafields) se verifica y completa automáticamente, de forma idempotente.
La actualización no elimina ningún dato existente.

Resolución de problemas

El botón no aparece: compruebe que la opción «Mostrar el botón flotante» está en Sí y que el usuario tiene permiso de consulta.
Nada por facturar: los tiempos deben tener el estado «Por facturar» y pertenecer al mismo tercero; un tiempo totalmente cubierto por el bono no genera línea.
Precio a cero en la factura: indique un precio en el producto/servicio o una tarifa horaria de reserva.

Véase también

Terminal de firma KSIDol: firma de todas las fichas nativas de Dolibarr, compatible con todos los módulos KSIDol.
Compatibilidad: Dolibarr 18.0 a 24.x — PHP 7.4+ — Licencia GPLv3 — Editor: KSIDol.

Resumen

TempsSupport cronometra el soporte telefónico de sus clientes desde cualquier página de Dolibarr (botón de auriculares), lo registra por tercero y lo transforma en factura — individualmente o en lote, con redondeo, duración mínima y un bono mensual incluido (facturación solo del exceso).