Evidencia electrónica basada en check explícito avanzado
Viafirma Documents permite agregar evidencias basadas en el uso Checks Explícitos Avanzados. Resultarán útiles para capturar aceptaciones voluntarias del usuario destacando clásulas o condiciones críticas o de especial importancia, por ejemplo, aquellas cláusulas recomendadas por GDPR, MIFID II, etc.
Podrás agregarlas directamente desde el diseñador visual de políticas para referenciarlas a partir de un identificador único de política, o bien podrás definirla al vuelo en tu servicio consumido vía API.
Estas evidencias podrás usarlas tanto en procedimientos de firma presencial, con la app de viafirma, o en procedimientos de firma a distancia, desde cualquier browser.
Uso en procedimientos de firma a distancia (firma web)
Uso en procedimientos de firma presencial (app iOS/Android)
Cómo configurar la evidencia en el diseñador
Los checks podrás configurarlos y gestionarlos desde el diseñador visual de políticas y evidencias, disponible en el backend de viafirma documents. Para ello sólo tendrás que agregar una nueva evidencia del tipo Check y configurarlo.
Una vez agregada la evidencia, haciendo click sobre el icono de edición accederás a la configuración básica.
A continuación te explicamos algunos ajustes básico para su uso:
- ID: este identificador lo genera automáticamente el sistema para cada evidencia, y te servirá para definir reglas de validación.
- Tipo: podrás cambiar el tipo de evidencia: IMAGE,SIGNATURE,FINGERPRINT,GENERIC. Para las evidencias del tipo CHECK que nos ocupa en esta documentación usaremos el tipo Genérica.
- Texto de ayuda: título del Check que aparecerá en el panel de acciones, por ejemplo “Protección de datos personales”.
- Detalle de la ayuda: texto adicional para incorporar ayuda contextual del check.
- Identificador de posiciones: si tu documento PDF cuenta con campos de formulario del tipo Acrofields, aquí podrás seleccionarlo, y lo usaremos para estampar la imagen asociada al Check.
- providerId: valor fijo para este tipo de evidencias que no debes cambiar: Check
- text: contenido completo del texto que asociamos al check, por ejemplo el contenido completo de la cláusula sobre la que queremos recabar un consentimiento.
Metadatos
Haciendo click sobre «Edición Avanzada» podrás acceder a más propiedades y opciones de uso, como las que te explicamos a continuación.
A través de esta configuración avanzada de metadatos podrás definir las siguientes propiedades y comportamientos:
- text: texto que mostraremos al usuario asociado al check. El contenido de este texto se registrará como parte de la evidencia en el XML anexo al PDF junto a otra información.
- groupCode: sólo para checks agrupados; te permitirá identificar el grupo de checks al que quieres asociar tu evidencia.
- groupTitle: sólo para checks agrupados; título del grupo de checks, y podrás informarlo únicamente en uno de los checks que formen parte del mismo grupo.
- groupDesc: sólo para checks agrupados; descripción del grupo de checks, y podrás informarlo únicamente en uno de los checks que formen parte del mismo grupo, por ejemplo en la evidencia check done haya definido el metadato groupTitle.
- requiredValue: podrás forzar a que el check esté activado (true) o desactivado (false).
- defaultValue: podrás informar de un valor predefindo (true o false); si el usuario no accede a la evidencia su valor será null.
Reglas de validación
Podrás agregar reglas de validación para el uso del CHECK, teniendo en cuenta el valor de otras evidencias incorporadas a tus políticas.
Por ejemplo:
La cláusula «Autorizo el uso de mi email para comunicaciones comerciales«, se habilitará sólo si la cláusula «Deseo publicidad» está marcada.
Podrás anidar tantas validaciones como desees, con operadores «and/or«, y haciendo referencia al ID de la cualquier evidencia incluida en las políticas.
Otras propiedades
También podrás hacer uso de otras propiedades avanzadas que pudieras necesitar en tus procesos de firma y que te explicamos a continuación.
- Formato de firma: define el formato de firma utilizado para el XML donde se consolidan todos los datos capturados para este evidencia. Se permiten los siguiente formatos: XADES-B, XADES-T, XADES-LT, XADES-LTA; se recomienda formato XADES_T.
- Alias de encriptación: es opcional, por defecto se usa una clave pública de cifrado definida en el sistema; se usa sólo en caso de querer usar otra clave de cifrado distinta.
- Alias de certificado: es opcional, por defecto se usa un alias de certificado definido en el sistema, y se usa para la firma desatendida del documento (PDF) así como para la firma del XML que contiene la evidencia. En caso de querer usar otro certificado para la firma aquí se debe indicar el alias. Dicho alias y certificado deben estar registrados en el sistema.
- Contraseña de certificado: es opcional, por defecto se usa la contraseña del certificado de firma asignado por defecto. Usar sólo en caso de usar un certificado alias específico.
- Mínimo de sellos: te permite definir un número mínimo de estampers asociados al check en cada página.
- Política de sellos: te permite definir un número total de estampers asociados al check el documento completo.
Propiedades dinámicas
Cuando uses el diseñador de políticas y evidencias podrás usar propiedades dinámicas, es decir, podrás hacer uso de valores que aún no conoces pero que puedes conseguirlos durante el proceso de firma, por ejemplo, desde un formulario donde le pides al usuario el dato, o bien a través de metadatos si el proceso de firma fue lanzado desde un sistema externo, por ejemplo un CRM, haciendo uso de nuestras APIs.
Para ello sólo tendrás que ayudarte de los operadores {{AQUÍ_TU_VARIABLE}}, y su valor será sustituido automáticamente si en el formulario o en los metadatos se informa esa variable.
Pruébalo tú mismo
Te invitamos a que pruebes el uso de los Checks Avanzados.
PROBAR
Consumo vía API
Si haces uso del API visita esta otra guía donde te explicamos su uso.