Table of Contents
📌 ¿Qué es este módulo?
Este módulo conecta Saturn Studio con la plataforma tufirma.digital, permitiendo automatizar por completo el ciclo de vida de la firma de documentos electrónicos con validez legal. Los robots pueden crear, enviar, consultar y gestionar documentos directamente desde un flujo de automatización.
La integración con Saturn Studio es ideal para procesos de negocio que requieren formalización. Por ejemplo, un robot puede tomar los datos de un nuevo cliente desde un CRM, generar un contrato, enviarlo a firmar a través de este módulo y, una vez firmado, descargarlo y archivarlo en el sistema correspondiente, todo sin intervención humana.
📚 Descripción de los comandos
A continuación se detallan los comandos disponibles para la integración con tufirma.digital:
✍️ Get Available Signatures
Obtiene las firmas disponibles desde tufirma.digital.
| Parámetro | Descripción | Ejemplo |
| Credential | Credencial de tufirma.digital necesaria para la consulta. | credential |
| Assign result to variable | Variable donde se almacenará el resultado. | {“table”:[{“id”:4,”created_at”:”2025-03-31T164319.794747+0000″,”name”:”John”,”lastname”:”Doe”},{“id”:5,”created_at”:”2025-03-31T164356.786912+0000″,”name”:”John”,”lastname”:”Doe”}]} |
🔍 Get Signature
Obtiene una firma por su Id desde tufirma.digital.
| Parámetro | Descripción | Ejemplo |
| Credential | Credencial de tufirma.digital necesaria para la consulta. | credential |
| Signature Id | ID de la firma que se desea obtener. | 5128391293 |
| Assign result to variable | Variable donde se almacenará el resultado. | {“documentos”:{“nombre”:”Contrato de Servicios”,”descripcion”:”Contrato firmado para prestación de servicios”,”firmantes”:[{“nombre”:”Pedro Perez”,”email”:”pedro.perez@example.com”,”tipo”:”simple”,”ready”:false}],”firmantesFea”:[],”viewers”:[{“nombre”:”Ana López”,”email”:”ana.lopez@example.com”}],”tags”:[“servicio”,”contrato”],”url”:”https//aws-tufirma-dev-v2.s3.us-east-2.amazonaws.com/1746817287261Contrato“,”fields”:[{“filler”:”pedro.perez@example.com”,”type”:”signature”,”required”:true,”name”:”Firma Principal”,”ready”:false},{“filler”:”Observaciones”,”type”:”text”,”required”:false,”name”:”Campo de Texto”,”ready”:false}],”historial”:[{“date”:”202550″,”data”:”CREATED”,”contexto”:”admin@example.com”}],”costCenterCode”:[]}} |
📄 Get Document
Obtiene un documento por su Id desde tufirma.digital.
| Parámetro | Descripción | Ejemplo |
| Credential | Credencial de tufirma.digital necesaria para la consulta. | credential |
| Document Id | ID del documento que se desea obtener. | 5128391293 |
| Assign result to variable | Variable donde se almacenará el resultado. | {“documentos”:{“nombre”:”Contrato de Servicios”,”descripcion”:”Contrato firmado para prestación de servicios”,”firmantes”:[{“nombre”:”Pedro Perez”,”email”:”pedro.perez@example.com”,”tipo”:”simple”,”ready”:false}],”firmantesFea”:[],”viewers”:[{“nombre”:”Ana López”,”email”:”ana.lopez@example.com”}],”tags”:[“servicio”,”contrato”],”url”:”https//aws-tufirma-dev-v2.s3.us-east-2.amazonaws.com/1746817287261Contrato“,”fields”:[{“filler”:”pedro.perez@example.com”,”type”:”signature”,”required”:true,”name”:”Firma Principal”,”ready”:false},{“filler”:”Observaciones”,”type”:”text”,”required”:false,”name”:”Campo de Texto”,”ready”:false}],”historial”:[{“date”:”202550″,”data”:”CREATED”,”contexto”:”admin@example.com”}],”costCenterCode”:[]}} |
📂 List Documents
Lista documentos desde tufirma.digital, con opción de filtrar por rango de fechas.
| Parámetro | Descripción | Ejemplo |
| Credential | Credencial de tufirma.digital necesaria para la consulta. | credential |
| From Date | Fecha “desde” para filtrar. Formato: YYYY-MM-DD. | 2025-03-25 |
| To Date | Fecha “hasta” para filtrar. Formato: YYYY-MM-DD. | 2025-03-31 |
| Assign result to variable | Variable donde se almacenará el resultado. | {“documentos”:[{“nombre”:”Probando email”,”descripcion”:”lA dEsC”,”firmantes”:[{“nombre”:”daniel”,”email”:”usuariotestorg@yopmail.com”,”tipo”:”simple”,”ready”:false}],”firmantesFea”:[],”viewers”:[],”tags”:[“tag1″,”tag2″],”url”:”https//aws-tufirma-dev-v2.s3.us-east-2.amazonaws.com/1746717666511Probando%20email“,”fields”:[{“filler”:”usuariotestorg@yopmail.com”,”type”:”signature”,”required”:true,”name”:”NEW_FIELD_EMPTY”,”ready”:false},{“filler”:”Firmante”,”type”:”text”,”required”:true,”name”:”NEW_FIELD_EMPTY”,”ready”:false}],”historial”:[{“date”:”202548″,”data”:”CREATED”,”contexto”:”david@rocketbot.com”}],”costCenterCode”:[]},{“nombre”:”65806″,”firmantes”:[{“nombre”:”daviod”,”email”:”david@rocketbot.com”,”tipo”:”simple”,”ready”:true}],”firmantesFea”:[],”viewers”:[],”tags”:[],”documentoMimeType”:”application/pdf”,”url”:”https//aws-tufirma-dev-v2.s3.us-east-2.amazonaws.com/1746652691942-65806.pdf“,”fields”:[{“filler”:”david@rocketbot.com”,”type”:”signature”,”required”:true,”name”:”NEW_FIELD_EMPTY”,”ready”:false}],”historial”:[{“date”:”202547″,”data”:”SIGNED”,”contexto”:”david@rocketbot.com”},{“date”:”202547″,”data”:”CREATED”,”contexto”:”david@rocketbot.com”}]}]} |
➕ Create Document
Crea un nuevo documento para ser firmado en tufirma.digital.
| Parámetro | Descripción | Ejemplo |
| Credential | Credencial de tufirma.digital necesaria para crear el documento. | credential |
| File path | Ruta al archivo local a subir. | document.pdf |
| Document Name | Nombre del documento a crear. | Service Agreement |
| Description | Descripción del documento a crear. | A contract defining the terms of service between provider and client. |
| Signer’s Email | Correo del firmante del documento. | johndoe@example.com |
| Signer’s Name | Nombre del firmante del documento. | John Doe |
| Viewer Email | Correo del visualizador del documento. | johndoe@example.com |
| Viewer Name | Nombre del visualizador del documento. | John Doe |
| Tag | Etiqueta para el documento a crear. | Tag Service Agreement |
| Assign result to variable | Variable donde se almacenará el resultado. | {“document”:{“_id”:”123e4567e89b12d3a4564267″,”attachedDoc”:{“name”:”Contrato_Trabajo”,”mimetype”:”application/pdf”, …}}} |
🧪 Ejemplo de uso
- Automatización de RRHH: Al dar de alta a un nuevo empleado, el robot puede generar su contrato, usar “Create Document” para enviarlo a firmar y luego usar “Get Document” periódicamente para verificar si ya fue firmado.
- Gestión de Acuerdos Comerciales: Un robot puede leer una lista de nuevos clientes desde un CRM, crear un acuerdo de servicios para cada uno y enviarlo a firmar, añadiendo al gerente de ventas como “visualizador”.
- Auditoría y Reportería: Programar un robot para que, a fin de mes, use “List Documents” para obtener todos los documentos firmados y archive sus detalles en una hoja de cálculo o base de datos.
- Consulta de Estado: Un chatbot interno podría permitir a los empleados consultar el estado de un documento. El usuario proporciona un ID, y el robot usa “Get Document” para devolverle la información de los firmantes y el historial.
🧩 Requisitos
- Tener una cuenta activa en la plataforma tufirma.digital.
- Disponer de la credencial de API (API Key o Token) proporcionada por tufirma.digital para ser utilizada en el parámetro Credential.
- Para crear documentos, el archivo base (ej: PDF) debe estar en una ruta local accesible para el robot.
- Conocer los IDs de las firmas o documentos para los comandos de consulta específica (“Get Signature” o “Get Document”).