Zoho tiene una particularidad frente a otras suites: el documento que hay que firmar puede nacer en cualquiera de sus aplicaciones. Una cotización aprobada en CRM, una factura en Books, un contrato armado con una plantilla en Writer, un acta de ingreso en People. Cada una guarda archivos a su manera y expone su propia interfaz, y la integración de firma tiene que decidir si se hace una vez por aplicación o una sola vez para todas.
La respuesta corta es la segunda: un único punto de firma al que todas las aplicaciones llaman. La respuesta larga tiene que ver con los límites del entorno de scripting de Zoho y con cómo se mueven los archivos dentro de la suite.
Un mapa de dónde nace cada documento
- CRM: cotizaciones, órdenes de venta y contratos generados desde plantillas. El disparador natural es un cambio de etapa o un campo de aprobación.
- Books e Invoice: comprobantes y documentos con efecto contable. Aquí no alcanza con firmar el PDF: el comprobante electrónico ecuatoriano se firma sobre el XML.
- Writer y Sign: documentos redactados con campos combinados, con un ciclo de revisión antes de la firma.
- People: contratos laborales, adendas y actas, con picos por fecha de ingreso.
- Creator: aplicaciones internas a medida, que suelen ser el mejor lugar para centralizar el estado de las solicitudes de firma.
Antes de programar conviene escribir esta tabla para la empresa concreta, con el volumen mensual de cada origen. En la mayoría de los casos, dos o tres orígenes concentran el 90% del volumen y el resto puede seguir siendo manual sin costo real.
Deluge sirve para orquestar, no para procesar
Deluge, el lenguaje de scripting de la suite, resuelve muy bien lo que fue diseñado para resolver: reaccionar a un evento, leer y escribir registros, llamar a un servicio externo y actualizar campos. Lo que no conviene es empujarlo más allá: manipulación de binarios grandes, esperas largas o lógica de reintentos compleja chocan con los límites de ejecución del entorno, y esos límites cambian según el plan y la aplicación.
El patrón que funciona es simple de describir:
- Una función corta detecta el evento y arma la solicitud: identificador del registro, tipo de documento, firmante previsto y referencia al archivo.
- Esa función llama a un servicio externo propio, que responde de inmediato con un acuse y un identificador de solicitud.
- El trabajo real (descarga del archivo, firma, sellado de tiempo, verificación) ocurre fuera de Zoho.
- El resultado vuelve por notificación al webhook expuesto en Zoho, que actualiza el registro y adjunta el documento firmado.
Así, si el servicio de firma tarda o falla, la aplicación de negocio no se bloquea ni deja al usuario mirando una pantalla girando. La mecánica del retorno está desarrollada en webhooks de firma electrónica.
Archivos: el punto que rompe más integraciones
Los archivos son la parte frágil. Tres precauciones concretas:
- Evita mover binarios codificados en texto entre pasos. La codificación en base64 aumenta el tamaño alrededor de un tercio y consume memoria en cada salto. Es preferible que el servicio externo descargue el archivo por su cuenta con un enlace temporal.
- El PDF firmado se adjunta como archivo nuevo, no reemplaza al original ni se regenera desde la plantilla. Si la plantilla vuelve a renderizar el documento, la firma desaparece del archivo que ve el usuario.
- Los documentos grandes necesitan otra ruta. Un contrato con anexos escaneados de decenas de megabytes no debe circular por el mismo camino que una cotización de dos páginas.
Autenticación y cuentas de servicio
La integración se autentica con el esquema de tokens de la plataforma, y ahí hay dos decisiones que se toman una sola vez y se pagan durante años:
- La conexión va a nombre de una cuenta de servicio dedicada, no de la cuenta del gerente comercial. Cuando esa persona cambia de rol o sale de la empresa, la integración sigue funcionando.
- Los permisos se otorgan al mínimo necesario. Si la integración solo lee cotizaciones y adjunta archivos, no necesita permisos de administración sobre toda la organización.
Además conviene monitorear la caducidad de los tokens y tener una alerta cuando la renovación falla, porque el síntoma típico es una integración que deja de firmar en silencio durante días.
Books y el comprobante electrónico
Este punto merece su propio apartado porque genera confusiones caras. En Ecuador, el comprobante electrónico es un archivo XML con firma XAdES incrustada, que se envía al SRI para su autorización. El PDF que recibe el cliente es una representación impresa de ese comprobante: firmarlo no reemplaza la firma del XML ni genera obligación tributaria alguna.
Si el sistema contable no emite el XML con el formato y la firma que exige el organismo, no hay integración de firma que lo arregle. Lo que corresponde es usar un sistema de facturación autorizado y dejar que Zoho conserve la información comercial. El grupo ofrece Azur, facturación electrónica autorizada por el SRI que se encarga del ciclo de firma, envío y autorización del comprobante: azur.com.ec. El contexto normativo está en firma electrónica y factura electrónica para empresas.
Estados, no banderas sueltas
| Estado | Qué significa | Acción esperada |
|---|---|---|
| Pendiente | El documento existe pero no se envió a firmar | Ninguna, es el estado inicial |
| En proceso | Solicitud aceptada por el servicio de firma | Esperar la notificación de retorno |
| Firmado | Documento firmado y verificado | Adjuntar, notificar y cerrar el caso |
| Error recuperable | Tiempo agotado o servicio no disponible | Reintento automático con espera creciente |
| Error definitivo | Certificado vencido, datos inválidos | Bandeja de revisión humana, sin reintentos |
Distinguir los dos tipos de error es lo que evita que un certificado caducado dispare miles de reintentos inútiles. Para prevenirlo, revisa cómo verificar si un certificado está caducado.
Cuándo conviene un automatizador en vez de código
No toda empresa necesita un servicio propio. Con volumen bajo y procesos que cambian seguido, un orquestador visual conectado a la suite cubre el caso con menos mantenimiento; las alternativas están descritas en firma electrónica con Make y firma electrónica con Zapier. El punto de quiebre suele aparecer cuando la empresa necesita trazabilidad detallada de cada intento o cuando el volumen mensual pasa de unos pocos cientos de documentos.
Si el camino elegido es código propio, la base conceptual está en la guía técnica para desarrolladores y en qué es un SDK de firma electrónica.
Los certificados
Firmas.com.ec emite certificados con trámite 100% en línea y entrega en aproximadamente 30 minutos, en archivo .p12, token USB o firma en la nube, con validez legal y ante el SRI. Para integraciones desatendidas con Zoho, la firma en la nube es la opción habitual porque no exige hardware conectado. Consulta el precio actualizado en la página de precios.
La coordinación que ninguna integración captura
El grupo también desarrolla Omnifox, una plataforma omnicanal que reúne WhatsApp, correo, redes sociales y llamadas en una sola bandeja compartida.
Las empresas que trabajan con Zoho suelen atender a sus clientes por WhatsApp y redes sociales desde cuentas dispersas. Omnifox unifica esos canales en una bandeja con historial por contacto, asignación de responsables y métricas de tiempos de respuesta, de modo que la conversación que acompaña a un contrato quede registrada igual que el contrato. Más información en omnifox.io.
Preguntas frecuentes
¿La firma nativa de la suite reemplaza al certificado ecuatoriano?
No para trámites que exigen firma electrónica emitida por una entidad de certificación acreditada en Ecuador. Para esos casos hace falta un certificado emitido localmente, independientemente de la herramienta que gestione el flujo.
¿Puedo firmar desde una función de Deluge sin servicios externos?
Puedes invocar un servicio de firma desde Deluge, pero la operación criptográfica y el manejo de la clave privada no ocurren ahí. Deluge orquesta; el servicio firma.
¿Cómo evito duplicados cuando un flujo se dispara dos veces?
Con una clave de idempotencia formada por el identificador del registro y su versión. El servicio devuelve el mismo resultado ante una segunda solicitud idéntica en lugar de firmar otra vez.
¿Dónde guardo el documento firmado?
Lo habitual es adjuntarlo al registro de origen y, en paralelo, conservar una copia en el repositorio documental de la empresa con su hash, para poder demostrar después que no fue alterado.
¿Cuántas personas de la empresa necesitan certificado?
Solo quienes firman documentos que obligan a la compañía frente a terceros o ante entidades. El resto puede aprobar dentro del sistema sin certificado propio.
Si estás definiendo cómo conectar la suite de Zoho con firma electrónica ecuatoriana, conversa con un asesor corporativo de Firmas.com.ec y revisa el plan por volumen. Solicita tu cotización corporativa.