Versión 3.6.19 de Documents

En esta nueva revisión del producto incorporamos nuevas funcionalidades orientadas a la mejora en la experiencia de usuario así como ayuda a integradores con más servicios en el API. A continuación te hacemos un resumen de lo que podrás encontrar en la nueva revisión 3.6.19 ya disponible en el entorno cloud de Viafirma.

Nueva funcionalidad auto-submit en procesos de firma web

Ref. #26964

En los procesos de firma a distancia el usuario final podrá seguir los pasos propuestos por el asistente, completando paso a paso todas las evidencias o firmas electrónicas definidas en la política de tu documento, y el último paso siempre hacer click en el botón finalizar.

Sin embargo, con la funcionalidad “auto-finalizar”, podemos encargarnos de finalizar el procesos de automáticamente si el usuario ha finalizado todas las evidencias y firmas que sean obligatorias.

¿Debo activar esta funcionalidad?

Si todas las evidencias y firmas de tus políticas son obligatorias podría ser útil activar el auto-finalizar. Conseguirás optimizar los procesos y evitarás que algún usuario deje el proceso sin finalizar de manera involuntaria.

Si por el contrario, cuentas con políticas con muchas evidencias y firmas electrónicas opcionales, y activas el auto-finalizar, podrías encontrarte con casos en los que el usuario ha elegido voluntariamente, desde el “árbol de pasos del menú lateral”, las evidencias obligatorias y el proceso se auto-finaliza sin darle tiempo a éste a que complete las opcionales.

También podrías contar con procesos en los que sabes positivamente que tus usuarios no finalizan el proceso en el mismo día, sino que van completando las evidencia en distintas sesiones, accediendo al mismo enlace donde guardamos el último estado. Estos casos no serían compatibles con el auto-finalizar si el usuario completa todas las obligatorias.

¿Cómo activar esta funcionalidad?

Si usas nuestra interfaz web de usuario encontrarás una opción al final de la página llamada “Envío automático tras finalización”, que activarás o desactivarás en cada caso. Si quieres configurar el estado por defecto de esta funcionalidad, para todas las operaciones de tu grupo de trabajo, tendrás que agregar la configuración adecuada en los ajustes de tu grupo.

Y si eres integrador, podrás activar esta funcionalidad agregando al objeto “Documents” el siguiente atributo: “autoFinalize» : true

Aquí encontrarás más info sobre esta funcionalidad: https://www.viafirma.com/documents/es/envio-automatico-finalizar/ 

Nueva gestión de sellos con textos dinámicos

Ref. 26965 

Podrás agregar textos personalizados en las imágenes asociadas tus sellos de firmas con certificados o representaciones gráficas de evidencias.

Texto asociado a los sellos de tus EVIDENCIAS

Recuerda que las imágenes asociadas a las evidencias del tipo CHECK, OTP SMS y OTP Mail son configurables. Por defecto se usarán una iconografía para cada una de ellas, pero si necesitas una nueva podrás definirla en la configuración de ESTILOS de tu grupo de trabajo.

Una vez tengas adaptada la imagen que desees, o bien la imagen por defecto usada por Viafirma, podrás hacer uso de la propiedad “ImageText”, que se encargará de agregar el texto deseado a la derecha de tu imagen, manteniendo ésta alineada a la izquierda.

Esta propiedad resulta muy útil para incorporar información semántica al aspecto final del PDF firmado, por ejemplo:

<iconografía-OTP-SMS> : Firma OTP SMS remitido al +34666666666 y validado correctamente.

En el diseñador de políticas recuerda que podrás escribir el texto deseado o en su lugar hacer uso de variables dinámicas, indicando el nombre de la variable en el que buscaremos el texto, por ejemplo en el formulario o en la lista de metadatos recibidos vía API.

Por ejemplo:

“mi texto” o bien “{{text_to_print}}”

Si eres integrador podrás agregar esta funcionalidad haciendo uso del atributo “imageText”.

Texto asociado a los sellos de tus FIRMAS CON CERTIFICADO:

Las firmas con certificados digitales puedes acompañarlas de sellos gráficos, como QR-Code, Barcode o simplemente Textos acompañados de una URL de verificación. Con la propiedad “helpText” podrás además incorporar texto personalizado que se incluirá en el sello.

nota: esta funcionalidad no está soportada para los formatos de sellos PDF-417.

En el diseñador de políticas recuerda que podrás escribir el texto deseado o en su lugar hacer uso de variables dinámicas, indicando el nombre de la variable en el que buscaremos el texto, por ejemplo en el formulario o en la lista de metadatos recibidos vía API.

Por ejemplo:

“mi texto” o bien “{{text_to_print}}”

Si eres integrador podrás agregar esta funcionalidad haciendo uso del atributo “helpText”.

Nueva configuración del Timezone por defecto para el CSV

Ref. 27685

Con esta propiedad “timeZoneId” podrás forzar a la impresión del Timezone en el sello asociado a tu firma con certificado digital. Esto te resultará útil cuando intercambies documentos firmados con usuarios de otros países en otra zona horaria.

Redirección externa al finalizar el proceso de firma

Ref. 27711

Si eres integrador y deseas que redirigir a tus usuarios a una página en concreto cuando éste finalice el proceso de firma, ahora podrás incorporar en tu API el atributo “callbackRedirectURL”, con la URL a la que el usuario será redirigido.

API: nuevo servicio para la descarga del Audit-Trail

Ref. 27730

Si eres integrador y deseas descargar de forma explícita el AUDIT-TRAIL asociado a un proceso de firma ahora podrás consumir el siguiente servicio:

Nombre del servicio: descargar Audit Trail
Método: GET
Servicio: /api/v3/documents/download/trail/<messageCode>
Respuesta: contentType/JSON
{
    "link": "url temporal en la que se expone el PDF",
    "fileName": "messagecode_audit_trail.pdf",
    "expires": fecha en milisegundos con la caducidad del link temporal de descarga
}

API: actualización del servicio de firma desatendida

Ref. 27738

Se agrega más información a la Response del servicio. En versiones anteriores a la v3.6.19 la response devolvía lo siguiente:

{
   "md5": "241c59b6d0736111c9541da69f5dcbfc",
   "fileName": "4YPW1583163262428R290.pdf",
   "base64": "JVBERi0xLjcKJfbk..." 
}

Ahora obtendrás dos atributos adicionales que te ayudarán a la gestión del proceso:

{
   "md5": "241c59b6d0736111c9541da69f5dcbfc",
   "fileName": "4YPW1583163262428R290.pdf",
   "base64": "JVBERi0xLjcKJfbk..." 
   "code": “string con el messageCode del proceso“,
   "signedID": “ID del documento firmado asociado en la URL de verificación y con patrón XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XX” 
}

Habilitar y deshabilitar documento firmado desde el panel de gestión web

Ref. 27734

Podrás desactivar la descarga de un documento firmado accediendo al detalle de la solicitud. En la pantalla resumen de la solicitud encontrarás el botón “Deshabilitar”. A esta pantalla solo tendrá acceso el propietario del proceso y los administradores de su grupo de trabajo.

Mejoras en la pantalla de configuración de notificaciones

Ref. 27717

Hemos mejorado la presentación de la página de configuración de las notificaciones asociadas a los distintos estados del ciclo de vida de tus procesos de firma. 

Otras mejoras y correcciones menores

A continuación te enumeramos algunas mejoras y correcciones menores que también hemos incluido en esta versión. Si estás a la espera de alguna de ellas busca el número de seguimiento y consúltanos.

Y en nuestras APPs encontrarás las siguientes revisiones

Nuevas versiones 3.6.1 para iOS y Android

Nueva v3.6.0 del cliente escritorio para Mac OS

Si tienes alguna duda sobre el uso de esta información contacta directamente con nosotros en: ayuda@viafirma.com