Nodo de documentos - Firma digital de documentos PDF desde el Conversation Manager

Explicación rápida

La operación Firmar PDF del Nodo de Documentos permite aplicar firma digital a documentos PDF directamente desde un flujo de Conversation Manager.

Esta opción toma un PDF previamente disponible en el repositorio de documentos de la cuenta y le agrega elementos de validación, como un hash y, si aplica, un código QR, para reforzar la autenticidad, integridad y trazabilidad del archivo.

Para configurarla, debe seleccionar la operación Firmar PDF, indicar la Etiqueta de Archivo asociada al campo donde se encuentra la ruta del PDF, definir la ubicación del hash y del código QR, seleccionar la página donde se aplicarán los elementos de validación y completar la información que quedará asociada a la firma.

El resultado de la firma puede guardarse en un campo de la lista de contactos, por ejemplo usando $.url, para que el documento firmado pueda enviarse, consultarse, indexarse o utilizarse en pasos posteriores del flujo.

¿Para qué sirve firmar digitalmente un documento?

La firma digital permite que un documento PDF conserve evidencia de autenticidad, integridad y trazabilidad dentro de un proceso digital.

Desde el punto de vista de la institución financiera, firmar digitalmente un documento ayuda a reforzar el control sobre los archivos generados, reducir riesgos de alteración, mantener evidencia verificable y facilitar procesos de auditoría o validación posterior. 

Esto es especialmente útil cuando se generan contratos, certificados, constancias, pólizas, comunicaciones regulatorias u otros documentos que deben conservar respaldo dentro del expediente del cliente.

Desde el punto de vista del cliente, la firma digital aporta mayor confianza sobre el documento recibido, ya que permite identificar que el archivo corresponde a una versión emitida por la institución y que puede ser verificado posteriormente si es necesario.

En DANAconnect, esta operación puede incorporarse dentro de un flujo automatizado para firmar documentos PDF previamente generados, agregando elementos de validación como hash y código QR.

Requisitos

Antes de continuar con el proceso para firmar un PDF, asegúrate de que los documentos que serán firmados estén disponibles en el repositorio de documentos de la cuenta de DANAconnect, para ser firmado.

Fuentes posibles del archivo PDF

El PDF que se va a firmar puede llegar al repositorio de documentos de la cuenta por diferentes vías. 

Las cargas de archivos pueden ser masivas o transaccionales, y pueden originarse desde:

• Formularios Web.
• Portales web de carga de documentos.
• API REST de carga de archivos adjuntos.
• Cargas manuales vía SFTP.
• Integraciones con sistemas core, CRM u otros sistemas externos.
• Canal WhatsApp integrado con la plataforma DANAconnect.

Por ejemplo, DANAconnect cuenta con funcionalidades para recibir documentos mediante formularios web personalizados, orientados a recopilar archivos de clientes de forma digital, segura y organizada. 

Independientemente del origen, la operación Firmar PDF necesita que el campo asociado a la etiqueta de archivo (la cual será explicada más adelante) contenga la ruta correcta del archivo.

¿Qué hace la operación Firmar PDF?

La operación Firmar PDF permite tomar un documento PDF existente y aplicarle firma digital desde el mismo flujo.

Desde esta operación puedes configurar:

• La etiqueta del archivo que será firmado.
• La posición del hash dentro del documento.
• La inclusión de un código QR.
• La página donde se aplicarán los elementos de validación.
• La información visible asociada a la firma.

Esta operación convierte la firma digital en una acción más dentro del flujo automatizado, permitiendo que el documento firmado quede listo para continuar con los siguientes pasos del proceso.

Agregar un Nodo de Documentos para firmar PDF

Para aplicar la firma digital, agrega un nuevo paso del Nodo de Documentos dentro del flujo.

En el campo Nombre del paso, coloca un nombre que te permita identificar fácilmente la acción.

Luego, en el campo Tipo de Operación, selecciona: Firmar PDF

Al seleccionar esta opción, se habilita la pestaña Firmar PDF, donde podrás configurar los datos de la firma.

Configurar la etiqueta de archivo

En la pestaña Firmar PDF, encontrarás el campo: Etiqueta de Archivo

Este campo permite indicar cuál es el archivo PDF que será firmado.

La etiqueta de archivo no contiene el documento PDF por sí misma. Para que la operación de firma funcione, esa etiqueta debe quedar asociada al campo de la lista de contactos que contiene la ruta del archivo PDF que será firmado.

La plataforma trabaja con documentos asociados a registros de una lista de contacto, por lo que la ruta del documento debe estar disponible como parte de la información del registro que se está procesando.

Por ejemplo, puede nombrar la etiqueta:Documento a firmar

Luego, al configurar el flujo, esa etiqueta debe mapearse con el campo de la lista de contactos donde está guardada la ruta real del PDF.

Lo importante no es que la etiqueta y el campo tengan el mismo nombre, sino que la relación entre ambos esté correctamente configurada

Configurar la alineación del hash

La firma digital puede incluir un hash, que funciona como un elemento de validación asociado al documento.

Dentro de la sección Alineación del Hash, puedes configurar la posición donde se mostrará este elemento en el PDF.

Los campos disponibles son:

• Horizontal
• Vertical

La combinación de ambos campos define en qué zona del documento aparecerá el hash.
Por ejemplo:

Recomendación práctica

Elige una ubicación que no tape información importante del documento.

Antes de usar la configuración y activar la conversación, genera una prueba y revisa visualmente que el hash:

• No se superponga con textos importantes.
• No tape firmas, sellos, tablas o logos.
• Quede ubicado en una zona legible.
• Mantenga una posición consistente en el PDF final.

Incluir código QR

La operación Firmar PDF también permite incluir un código QR.
Para activarlo, marca la opción: Incluir código QR

El código QR puede facilitar la validación del documento firmado o permitir el acceso a información relacionada con la firma, según la configuración definida para el proceso.

Cuando esta opción está activada, podrás configurar su posición dentro del documento.

Configurar la posición del código QR

Dentro de la sección Código QR, encontrarás los campos:

• Horizontal
• Vertical

Al igual que con el hash, la combinación de ambos campos determina dónde aparecerá el QR dentro del PDF.

Recomendación práctica

Ubica el código QR en una zona visible, pero que no interfiera con el contenido principal del documento.

En documentos formales, puede ser recomendable ubicarlo en:

• La parte superior izquierda.
• La parte inferior izquierda.
• La parte inferior derecha.
• Una sección destinada a validación o verificación.

Evita colocar el QR sobre:

• Tablas.
• Datos del cliente.
• Montos.
• Firmas visuales.
• Códigos legales.
• Textos largos.

Seleccionar la página donde se aplicará la firma

El campo Página permite definir en qué página del documento se insertarán los elementos de firma o validación.
Por ejemplo:

Esto indica que el hash y el código QR se mostrarán en la primera página del PDF.

Recomendación práctica

Selecciona la página según el tipo de documento:

Si el documento tiene varias páginas, revisa que la página seleccionada sea la más adecuada para la validación.

Completar el campo Información

El campo Información permite agregar cualquier texto o dato que quiera ser asociado a la firma digital.

Por ejemplo: 

• Una referencia interna del proceso. 
• Número de expediente, solicitud o contrato.
• Texto de validación como: “Documento emitido y firmado digitalmente por [Nombre de la institución]”.

Guardar el URL del documento firmado

Después de completar la pestaña Firmar PDF, debes configurar cómo se guardará el resultado de la firma.

Esto es importante porque la operación Firmar PDF genera una respuesta. Si necesitas usar el documento firmado más adelante dentro del flujo, debes guardar el URL resultante en un campo.

Para hacerlo, ve a la pestaña: Configuración

Luego haz clic en: Add Field to Update

Allí podrás agregar el campo donde se guardará el dato que necesitas extraer de la respuesta.
Para guardar el URL del documento firmado, configura los siguientes campos:

Por ejemplo:

En este ejemplo, el URL del documento firmado se guardará en el campo URLFIRMADO.

Diferencia entre Field Name y nombre visible del campo

En Field Name debes colocar el código del campo, no necesariamente el nombre visible que aparece en la lista de contactos.
El código del campo es el identificador que DANAconnect usa para saber dónde debe guardar el valor extraído de la respuesta. Es importante que este código se escriba en mayúsculas en su totalidad.

Por ejemplo, un campo puede mostrarse visualmente como: URL firmado

Pero su código puede ser:

URLFIRMADO

En ese caso, en Field Name debes colocar: URLFIRMADO

No el nombre visual del campo.

Recomendación práctica

Antes de configurar la pestaña Configuración, revisa el código exacto del campo donde quieres guardar el URL del documento firmado.

Usar el documento firmado en el flujo

Una vez que el URL del documento firmado queda guardado en un campo, puedes utilizarlo en los siguientes pasos del flujo según la necesidad del proceso.

Por ejemplo, el documento firmado puede ser:

• Enviado al destinatario.
• Almacenado.
• Consultado posteriormente.
• Indexado.
• Procesado por otro nodo.
• Usado como parte de una comunicación automatizada.

El uso posterior dependerá del flujo configurado. Lo importante es que el resultado de la firma quede guardado en un campo disponible para los siguientes pasos.

Cómo validar una firma digital con DANAconnect

Validar una firma digital en DANAconnect es un proceso en línea.
Esta validación es útil cuando un cliente, auditor, área interna o tercero necesita confirmar la autenticidad del documento y revisar la información asociada a su firma.

Para realizar la validación, necesitas el Envelope ID que aparece en el documento firmado.

Sigue estos pasos:

1. Ingresa al portal de validación de firma de DANAconnect.
2. Ubica el campo de validación.
3. Escribe el Envelope ID del documento.
4. Haz clic en Solicitar validación.
5. Revisa la información devuelta por el sistema.

La validación puede mostrar información asociada al documento, como:

• Compañía.
• Nombre del documento.
• Cantidad de páginas.
• Fecha de generación.
• Estado o resultado de validación.
• Información del archivo

Verifica que los datos mostrados por la herramienta coincidan con la información del documento firmado.

Actualizado el: 07/07/2026