View source for Registro y facturación del tiempo de soporte en Dolibarr

[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:CRM]]
[[Category:Interface]]

{{TemplateDocDev}}
{{TemplateDocUtil}}

<div style="border:1px solid #d7e3f4; border-radius:14px; padding:22px; margin:12px 0 22px 0; background:linear-gradient(135deg,#f6faff,#ffffff); box-shadow:0 2px 10px rgba(20,60,110,0.08);">
  <div style="font-size:28px; font-weight:700; color:#17365d; margin-bottom:8px;">TempsSupport para Dolibarr</div>
  <div style="font-size:18px; color:#345; margin-bottom:14px;">Cronometre el tiempo de soporte telefónico por cliente y factúrelo directamente en Dolibarr, con bono mensual incluido</div>
  <div style="display:flex; flex-wrap:wrap; gap:8px; margin-top:10px;">
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Cronómetro de llamada</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Soporte telefónico</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Botón flotante de auriculares</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Facturación del tiempo</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Bono mensual incluido</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Pestaña de tercero</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">KPI por cliente</span>
  </div>
</div>

== 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 ==

{| class="wikitable" style="width:100%; border-collapse:collapse;"
! style="width:24%; background:#f0f6ff;" | Elemento
! style="background:#f0f6ff;" | 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 ==

{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Información
! style="background:#f7f7f7;" | 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 : [https://youtu.be/rGmtjyqEJCE TempsSupport — demo (YouTube)]
* Ficha del módulo : [https://www.ksidol.io/es/modules/detail?module=main_module_tempssupport TempsSupport en KSIDol]
* Demostración en línea : [https://www.ksidol.io/t/demo-erp/custom/tempssupport/list.php?mainmenu=tempssupport TempsSupport — abrir la demo]
* Manual del módulo : [https://www.ksidol.io/notices/ksidol_notice_es/tempssupport.html TempsSupport — consultar el manual]
* Página del editor K.S.I en DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= 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: <code>llx_tempssupport_ticket</code> (un registro por tiempo de soporte).
* Recursos cargados en todas las páginas mediante <code>module_parts</code> (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, <code>GETPOST</code>, escape.
* '''Sin modificación del núcleo de Dolibarr.'''

== Instalación ==

# Descomprima el archivo para obtener una carpeta <code>tempssupport/</code>.
# Cópiela en <code>htdocs/custom/</code> de su Dolibarr.
# Compruebe los permisos de escritura en <code>documents/tempssupport/</code>.
# 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 <code>htdocs/custom/tempssupport/</code> 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).