Documentacion KSIDol > Modulos KSIDol > OTP por SMS

Guia del modulo: OTP por SMS

Guía de uso no técnica: para qué sirve el módulo, cómo utilizarlo y cómo se integra con Dolibarr.

Firma en líneaMediante código SMS (OTP)

Documentos afectadosPresupuestos, pedidos, facturas, contratos

CompatibilidadDolibarr 18 a 24

TrazabilidadExpediente de prueba + registro inalterable

1. Descripcion del modulo

El módulo OTP por SMS (Firma OTP) añade a Dolibarr una firma electrónica reforzada: al firmar un documento en línea (presupuesto, pedido, factura, contrato), el firmante recibe un código de un solo uso (OTP) por SMS en su teléfono. Debe introducir este código y, a continuación, confirmar explícitamente su consentimiento antes de que aparezca la zona de firma. Por lo tanto, la firma solo puede ser realizada por una persona que haya recibido efectivamente el SMS en el número previsto, lo que refuerza el valor jurídico del acuerdo obtenido a distancia. En cada firma, el módulo constituye automáticamente un expediente de prueba con sello de tiempo (documento realmente presentado al firmante, huella SHA-256 para verificar que el archivo no ha sido modificado, dirección IP, navegador, número de móvil, mención de consentimiento) y registra cada etapa en un registro inalterable. El módulo se apoya en la firma en línea nativa de Dolibarr y en sus objetos estándar (terceros, presupuestos, pedidos, facturas, contratos, documentos), sin modificar el núcleo de la aplicación: se limita a redirigir el recorrido de firma hacia su propia página segura cuando esto está activado.

Envía un código de verificación (OTP) por SMS a través de la pasarela OVH SMS antes de cualquier firma
Bloquea la firma mientras el código SMS no sea válido y no se confirme el consentimiento
Constituye un expediente de prueba con sello de tiempo y control de integridad del documento (huella SHA-256)
Conserva un registro de firma inalterable, consultable, filtrable y exportable a PDF
Se activa documento por documento: cada tipo puede permanecer en la firma nativa de Dolibarr o pasar a OTP
No aporta ninguna modificación al núcleo de Dolibarr: el recorrido nativo permanece disponible en todo momento

2. Firma en línea reforzada mediante código SMS

Es la función central del módulo: transformar la firma en línea de Dolibarr en una firma verificada por SMS, sin cambiar nada en el núcleo de la aplicación.

Cuando la integración está activada, los enlaces de firma enviados al cliente desde una ficha de Dolibarr apuntan a la página de firma segura del módulo en lugar de a la página nativa
El firmante consulta primero el documento que se tendrá realmente en cuenta y, a continuación, solicita un código de verificación por SMS
El código recibido por SMS debe introducirse y validarse antes de que se desbloquee el resto del recorrido
Si la integración se deja inactiva, el enlace permanece en la página de firma nativa de Dolibarr, sin ninguna intervención del módulo
Ningún código se envía automáticamente: es el firmante quien desencadena el envío desde el recorrido público

3. Recorrido de firma del firmante (página segura)

El módulo guía al firmante paso a paso en una página pública dedicada, con varios cierres de seguridad antes de la firma.

El firmante abre el documento presentado y confirma el número de móvil que recibirá el código
Introduce el código OTP recibido por SMS; un código caducado o erróneo se rechaza y puede reenviarse (dentro del límite configurado)
Una vez validado el código, debe confirmar explícitamente su consentimiento (casilla de verificación y mención legal) antes de que aparezca la zona de firma
A continuación se aplica la firma, y se registran el documento firmado y el expediente de prueba
Una firma ya registrada queda bloqueada: el enlace ya no permite volver a firmar el mismo documento (protección contra la repetición)

4. Envío de SMS y parámetros OTP

El módulo gestiona el envío de SMS a través de una cuenta OVH SMS y permite ajustar con precisión el mensaje y las reglas del código.

Conexión a la pasarela OVH SMS (endpoint, claves de aplicación, clave de consumidor, servicio), con un asistente para generar la clave con los permisos adecuados
Plantilla de mensaje OTP personalizable (inserción automática del código y del plazo de expiración)
Longitud del código (4 a 10 dígitos, 6 por defecto), duración de validez (1 a 60 minutos, 10 por defecto) y número máximo de reenvíos configurables
Ajustes de envío: remitente por defecto, prioridad, tipo de mensaje (transaccional/marketing), retardo antes del envío, cláusula STOP
Gestión del prefijo de país (adición automática, forzado de un prefijo por defecto o ninguna acción) y modo de prueba
Reutilización de los ajustes existentes del módulo de envío de SMS (conservación de los parámetros ya establecidos)

5. Cuotas de SMS y seguimiento del consumo

El módulo permite controlar el gasto en SMS asignando cuotas y supervisando el stock disponible.

Asignación de una cuota de SMS por usuario, con seguimiento del número asignado, utilizado y disponible
Visualización de una insignia que indica el número de SMS restantes para el usuario
Alerta de stock bajo (insignia en la parte superior de la pantalla y tarjeta de alerta) cuando se alcanza el umbral
Enlace de reabastecimiento configurable para pedir nuevos SMS
Visualización del crédito disponible en la cuenta OVH

6. Expediente de prueba y control de integridad

Cada firma genera automáticamente un conjunto de pruebas destinado a demostrar la validez del acuerdo en caso de litigio.

Registro del documento exacto presentado al firmante (archivo congelado) y del documento firmado
Cálculo de una huella SHA-256 que permite verificar que el documento no ha sido modificado antes o después de la firma
Producción de un PDF de prueba (expediente de prueba con sello de tiempo) que recoge los elementos técnicos de la firma
Constitución de un archivo de prueba descargable que agrupa los documentos, el manifiesto y las pruebas
Elementos recopilados según la configuración: fecha y hora UTC, dirección IP, navegador, número de móvil, clave de seguridad, huella del documento y mención de consentimiento

7. Caja fuerte de prueba (parámetros de conservación)

Una pestaña dedicada permite adaptar las reglas de archivo y conservación de las pruebas a sus exigencias de cumplimiento.

Elección del modo de caja fuerte y del algoritmo de hash (SHA-256 por defecto)
Duración de conservación de las pruebas configurable (en años)
Definición de un perímetro de cumplimiento (p. ej. FR/UE) y de una mención legal presentada al firmante
Activación o no de la recopilación de la dirección IP y del navegador del firmante
Opción de registro de solo adición (append-only) para impedir cualquier alteración de los registros

8. Registro e historial de firma

Una pestaña Historial centraliza todos los eventos de firma en un registro consultable e inalterable.

Lista con sello de tiempo de cada etapa: apertura del enlace, confirmación del número, envío y validación del código, consentimiento, firma capturada, archivo o fallo
Búsqueda y filtros por fecha, firma, tercero, tipo de documento, evento, estado, referencia, dirección IP o detalle
Ordenación y paginación de los registros
Descarga directa del PDF de prueba, del PDF firmado y del archivo de pruebas desde la lista
Encadenamiento de los eventos (huellas sucesivas) que garantiza la inalterabilidad del registro, sin modificar el núcleo de Dolibarr

9. Elección por tipo de documento y diagnóstico

El módulo se controla con precisión, tipo de documento por tipo de documento, con herramientas de verificación integradas.

Para cada tipo (presupuesto, contrato, parte de intervención, pedido, factura), elección entre gestión por OTP SMS o firma nativa de Dolibarr
El parte de intervención, por ejemplo, se recomienda en modo nativo para una firma in situ
Botón de diagnóstico que verifica el endpoint, las credenciales, el servicio, el acceso a la API de OVH y la presencia de las tablas necesarias
Herramienta de reinicio del módulo (eliminación de los datos y registros de SMS) tras confirmación
Activación global de la integración en la firma en línea nativa, activable/desactivable en todo momento

10. Vinculos con Dolibarr

El modulo no funciona de forma aislada: se integra con los bloques nativos de Dolibarr.

Presupuestos, pedidos, facturas, contratos : El módulo se acopla a las fichas de propuestas comerciales (presupuestos), pedidos, facturas y contratos de Dolibarr. El enlace de firma en línea generado para estos documentos se redirige al recorrido OTP del módulo cuando el tipo correspondiente está configurado para su gestión por OTP.
Firma en línea nativa de Dolibarr : El módulo se apoya en el mecanismo de firma en línea estándar de Dolibarr y en su clave de seguridad. Solo sustituye la dirección del enlace de firma (por sustitución), sin modificar el núcleo: si la integración está desactivada, el recorrido nativo permanece plenamente funcional.
Terceros y contactos : El módulo retoma el nombre del tercero y el número de teléfono del firmante vinculados al documento para el envío del SMS y su visualización en el registro. El número de móvil puede confirmarse o corregirse en el momento del recorrido de firma.
Documentos (archivos de Dolibarr) : El documento presentado, el documento firmado y el archivo de prueba se registran en el espacio de documentos de Dolibarr, en un directorio dedicado al módulo, y permanecen descargables desde el historial.
Usuarios y derechos de acceso : El módulo se apoya en las cuentas de usuario de Dolibarr para las cuotas de SMS y en los derechos (lectura, escritura, administración) para el acceso a la configuración y al historial. El acceso a la configuración está reservado a los administradores.
Eventos de validación (desencadenadores) : El módulo reacciona a los eventos estándar de Dolibarr sobre los documentos (validación de un presupuesto, de un pedido o de una factura, firma de una propuesta, modificación de un contrato) para mantener la coherencia del recorrido de firma.