Una de las opciones de las que dispones al preparar una solicitud de firma con Viafirma, es la de solicitar documentos adjuntos (obligatorios o no) a los firmantes de tu petición. Para el uso de esta funcionalidad podrás configurar tus políticas con adjuntos de tres formas: desde la redacción de solicitudes, en el diseñador de políticas que encontrarás en el panel de gestión de tus plantillas, o directamente en la definición del servicio cuando lo consumes a través de API.
Desde la redacción de solicitudes
Para ello en el paso 2 «Firmantes» selecciona la opción Solicitar adjuntos , cuya imagen es un clip. Te aparecerá una pantalla con la opción de Solicitar un archivo. Necesitas al menos un archivo que solicitar si quieres solicitar adjuntos. Este archivo adjunto dispone de varias opciones: Solicitar a:
- Todos los Firmantes –> Cualquier firmante participante de la petición puede adjuntar este archivo. Da prioridad al primer usuario en adjuntarlo.
- Nombre del firmante –>Selecciona un firmante por su nombre para asignarle este adjunto.
Tipo de archivo:
- PDF o imagen (PNG, JPEG).
- PDF.
- Imagen (PNG, JPEG).
- Grabación de vídeo.
- Grabación de audio.
Título –> Nombre del archivo adjunto. Descripción –> Explicación del motivo o asunto del archivo adjunto. Obligatorio –> Check que marcará la obligatoriedad del archivo adjunto. Puedes solicitar todos los archivos que desees seleccionando Solicitar otro archivo y configurándolo con sus opciones. ** IMPORTANTE: Si solicitas documentación personal debes tener en cuenta la normativa de protección de datos personales y obtener una aceptación por parte del usuario firmante de la recogida de datos y su finalidad . Viafirma permite de manera muy sencilla incluir texto marcado de lectura y aprobación inequívoca.
Configuración desde el diseñador de plantillas
En la gestión de plantillas, módulo políticas, podrás agregar y configurar los distintos tipos de adjuntos soportados. Lo encontrarás en la vista avanzada.
Al añadir el adjunto podrás elegir entre los distintos tipos soportados: VIDEO, AUDIO, IMAGE y PDF.
Recuerda que NO tendrás que configurar ninguna posición sobre el documento.
Uso mediante API
La configuración de la política debe incorporar el objeto attachments, eligiendo el tipo de adjunto deseado.
"policies" : [ { "evidences" : [ {…} ] } ], "signatures" : [ {…} ] } ], "attachments" : [ { "type" : "VIDEO|AUDIO|IMAGE|PDF", "helpText" : "string", "helpDetail" : "string", “optional” : boolean } ] } ]
Ejemplo JSON
Una vez finalizado el proceso, tu adjunto incorporará metadata que te ayudará en tu gestión.
"attachments" : [ { "type" : "VIDEO|AUDIO|IMAGE|PDF", "status" : "PENDING|RECEIVED", "helpText" : "string", "helpDetail" : "string", “optional” : boolean, "date" : miliseconds, "hash" : "sha256 string" } ]
Una vez finalizado el proceso podrás acceder al detalle de la solicitud y a todos los adjuntos anexados a ella, permitiendo su descarga.
USO AVANZADO. Procesar adjuntos
El módulo de adjuntos está diseñado para incorporar en futuras versiones implementaciones de servicios encargados de procesar los adjuntos.
Por ejemplo, podrás configurar un procesamiento «OCR» encargado de analizar un extracto bancario adjuntado en formato PDF, donde se procesarían el nombre del titular y el número de la cuenta. También se podría utilizar, por ejemplo, para validación de imágenes, por ejemplo, validar un pasaporte o validar una cara.
Para ello podrás hacer uso de los atributos processType y processid que te servirán para identificar al proveedor y tipo de servicio a consumir, ayudándote del metadataList, donde se podrán agregar los parámetros de configuración necesarios para cada caso.
"attachments": [{ "type": " VIDEO|AUDIO|IMAGE|PDF ", "code": "string", "status": " PENDING|RECEIVED ", "helpText": "string", "helpDetail": "string", "optional": booelan, "date": milliseconds, "hash": "string sha256", "processType": "string", "processId": "string", "metadataList": [ { "key": "string", "value": "string" } ] }]
Consulta las implementaciones y tipos de servicios para el procesamiento de adjuntos disponible en tu versión.
Si tienes alguna duda sobre el uso de esta información contacta directamente con nosotros.