Documentacion KSIDol > Modulos KSIDol > PropalQR

Guia del modulo: PropalQR

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

Firma del clienteEn 1 escaneo

Ubicaciones del QRFicha, PDF, correo

Colores de acento6 tonos

Páginas del PDF seleccionadas1ª, todas o última

1. Descripcion del modulo

PropalQR ("Firma de presupuesto por código QR") añade un código QR junto al enlace de firma en línea de sus propuestas comerciales (presupuestos) de Dolibarr. En la práctica, el cliente ya no necesita volver a teclear una dirección ni buscar un enlace en un correo: escanea el código QR con la cámara de su teléfono y llega directamente a la página de firma en línea del presupuesto. Es un atajo que acelera la aceptación de un presupuesto, sobre todo durante una reunión o al entregar un documento en papel. El módulo no crea ningún dato nuevo y no sustituye nada: se apoya por completo en los objetos nativos de Dolibarr. El código QR se limita a codificar la URL de firma en línea que Dolibarr ya proporciona para la propuesta. Por lo tanto, funciona allí donde su presupuesto ya vive: en la ficha de la propuesta, en el PDF generado y en los correos enviados desde Dolibarr.

Convierte el enlace de firma en línea de un presupuesto en un código QR que el cliente escanea para firmar
Se muestra automáticamente en la ficha de la propuesta, junto al enlace existente
Puede añadirse al PDF del presupuesto e insertarse en las plantillas de correo
Se apoya únicamente en la firma en línea nativa de Dolibarr: no se expone nada más que el enlace ya transmitido al cliente
Sin configuración obligatoria: el módulo elige por defecto unos ajustes adecuados

2. Código QR en la ficha de la propuesta

En la pantalla de un presupuesto, el módulo añade un recuadro "Código QR de firma en línea" bajo la información de la propuesta, junto al enlace de firma ya presente.

Muestra un bloque con el título, el enlace público de firma (en el que se puede hacer clic) y la imagen del código QR
El código QR codifica la dirección de la página de firma en línea del presupuesto
El recuadro solo aparece en la vista normal del presupuesto (no durante la preparación de un correo), para no ralentizar las pantallas
El colaborador puede hacer que el cliente presente escanee el código directamente en la pantalla

3. Código QR en el PDF de la propuesta

Cuando Dolibarr genera el PDF de un presupuesto, el módulo le añade un bloque con el código QR de firma, práctico para un presupuesto impreso o enviado como adjunto.

Añade el código QR al PDF del presupuesto producido por Dolibarr (el enlace escrito con todas sus letras no se repite en el PDF)
La posición del bloque (coordenadas X e Y, en milímetros) se puede ajustar en la configuración
El color del código QR y de su título sigue el tono de acento elegido
Usted elige en qué páginas aparece: solo la primera, todas, o solo la última
El cliente escanea el código QR del documento en papel o PDF para abrir la firma en línea en su teléfono

4. Código QR y enlace en los correos

El módulo pone a disposición dos "campos de fusión" (sustituciones) que puede insertar en sus plantillas de correo de Dolibarr para integrar el código QR o el enlace de firma.

__PROPAL_SIGNATURE_QRCODE__: inserta la imagen del código QR en el cuerpo del correo
__PROPAL_SIGNATURE_QRCODE_URL__: inserta el enlace público de firma (útil si el cliente bloquea la visualización de imágenes)
La imagen del código QR se genera a demanda, para no ralentizar la apertura del formulario "Enviar un correo"
Estos campos se colocan en las plantillas de correo, como las demás variables de Dolibarr

5. Configuración del módulo

El módulo añade una entrada "Propal QR" en el menú y una página de ajustes. Ningún ajuste es obligatorio: los valores por defecto sirven en la mayoría de los casos.

Posición del QR en el PDF: coordenadas X (desde el borde izquierdo) e Y (desde arriba), en milímetros; dejarlo vacío conserva la colocación automática
Vista previa visual: una maqueta de página (espécimen de la plantilla Cyan) muestra en directo dónde caerá el código QR cuando ajuste X e Y
Color de acento: 6 tonos propuestos (Negro tinta, Azul océano, Verde esmeralda, Violeta, Naranja ámbar, Rojo carmín)
Visualización del QR en el PDF: solo la primera página, todas las páginas, o solo la última página
Botones "Guardar" y "Restablecer la posición por defecto" para volver a los ajustes originales

6. Condiciones de visualización del código QR

El código QR solo aparece cuando la firma tiene sentido, para evitar ofrecer un enlace inactivo.

La firma en línea de las propuestas debe estar activada en Dolibarr
La propuesta ya no debe estar en estado borrador (el presupuesto debe estar validado)
Si no se cumplen estas condiciones, no se muestra ni se añade al PDF ningún bloque QR
El módulo gestiona los entornos multiempresa (multientidad) para calcular la dirección pública correcta

7. Vinculos con Dolibarr

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

Propuestas comerciales (presupuestos) : El módulo depende del módulo nativo Propuestas comerciales: el bloque QR se añade en la ficha del presupuesto y en su PDF, sin modificar la estructura de las propuestas.
Firma en línea de Dolibarr : El código QR codifica la URL de firma en línea proporcionada por Dolibarr. Por tanto, la firma en línea de las propuestas debe estar activada. El módulo no expone nada más que este enlace público ya transmitido al cliente.
Generación de los PDF : El módulo se integra en la generación de PDF nativa (plantillas de propuestas) para depositar en ellos el bloque QR, en la posición y en las páginas que usted elija.
Plantillas de correo (sustituciones) : Proporciona dos variables de fusión (__PROPAL_SIGNATURE_QRCODE__ y __PROPAL_SIGNATURE_QRCODE_URL__) reutilizables en las plantillas de correo de Dolibarr, como los demás campos estándar.
Clientes / terceros destinatarios : Es el cliente destinatario del presupuesto quien escanea el código QR para firmar en línea; el módulo facilita este recorrido sin crear ninguna ficha ni dato adicional.
Estado del documento : El comportamiento sigue el estado nativo de la propuesta: el QR solo se ofrece para un presupuesto validado (nunca para un borrador).