Operaciones para interactuar con Viafirma Documents usando un campo de tipo tabla y el documento principal

Para procesos de firma muy personalizados, es posible en lugar de la integración nativa de producto, usar operaciones y campos de tipo tabla para indicar la información que se necesita para construir la petición de firma en Viafirma Documents. Los documentos a enviar a firma pueden ser los relacionados, o el documento principal. Este artículo explica el segundo caso. 

Operación para realizar las peticiones de firma

Esta operación permite interactuar con ViaFirma Documents para enviar a firmar el documento principal, apoyándose en una tabla que recoge a los firmantes y el orden de las firmas.

La operación que debe instalar es:

op_viafirma_main_document_request_table_metadata

Configuración de la tabla

Para configurar la operación, en primer lugar necesitas crear una tabla en el formulario como la que se muestra a continuación:

• Email: Email del firmante.
• Estado firma: Estado en el que se encuentra la firma.
• Nombre: Nombre del firmante.
• Orden firmante: Orden en el que realiza la firma el firmante.

Debes tener en cuenta que en la columna Nombre, debes introducir identificadores únicos que se usarán posteriormente para configurar la operación.

Configuración de la operación

A continuación, configura la operación utilizando los identificadores únicos mencionados anteriormente.

• Email evidence: Marcar para solicitar evidencia por correo electrónico a los firmantes.
• Signature evidence: Marcar para solicitar evidencia de firma a los firmantes.
• Signature order column identifier: Identificador único de la columna que contendrá el orden de firma.
• Signature status column identifier: Identificador único de la columna que contendrá el estado de la firma.
• Signer name column identifier: Identificador único de la columna que contendrá el nombre del firmante.
• Signature order column identifier: Identificador único de la columna que contendrá el orden de firma.
• Table field: Campo con la tabla configurada para rellenar los firmantes.
• Type of server signature stamp: Tipo de sello de firma del servidor.

Parámetros para personalizar el sello de firma del servidor:

• Stamper width: Ancho del sello de firma del servidor.
• Stamper height: Alto del sello de firma del servidor.
• Stamper position on the X axis: Posición en el eje X del sello de firma del servidor.
• Stamper position on the Y axis: Posición en el eje Y del sello de firma del servidor.
• Stamper page on the document: Página en la que se quiere ver el sello de firma del servidor.

Parámetros para personalizar el correo de solicitud de firma:

• Request mail body: Texto o HTML que define el cuerpo del correo electrónico.
• Request mail subject: Texto o HTML que define el asunto del correo electrónico.

Uso de la operación

Rellenar la tabla en el documento que quieras enviar a firmar con todos los firmantes que desees estableciendo un orden de firma. A continuación se muestra un ejemplo:

La columna Estado firma, es la única columna que no debes rellenar puesto que se irá actualizando automáticamente durante el proceso de firma.

Actualizar el estado de las firmas

op_viafirma_document_message_callback_update_signature_status_table_metadata_main_document.py

Esta operación permite que se actualicen los estados tras un "callback" de ViaFirma, para ello es necesario añadir set_callback_viafirma_document a la categoría de la operación para que se actualice de forma automática la tabla.

Los parámetros que se deben configurar para su funcionamiento son:

• Signature column identifier: Identificador único de la columna que contendrá la información del estado de la firma por firmante.
• Table field: Campo que define la tabla.