Guías
Envía tu primer flujo de firma electrónica rápidamente con Firma: Una guía rápida para desarrolladores
¿Es desarrollador y ya tiene su cuenta de Firma? Excelente. Esta guía le llevará desde tener la «clave API en mano» hasta un flujo de firma incrustado y activo. Seremos directos, nos centraremos en las decisiones de diseño y le enlazaremos directamente con fragmentos de código listos para usar en la documentación.
¿Busca la guía no técnica? Haga clic aquí.
Qué hará
Modelar el aislamiento de clientes con espacios de trabajo
Crear una plantilla reutilizable
Enviar una solicitud de firma
Incrustar la experiencia de firma o redirigir
Hacer un seguimiento de todo con webhooks
Los precios son sencillos. Cuesta €0,049 por sobre, puede hacer pruebas con documentos reales y es gratis para que pueda construir y probar de extremo a extremo.
Requisitos previos
Clave API de empresa o espacio de trabajo de su panel de control
Un PDF que pueda convertir en plantilla
Un lugar para ejecutar el código del servidor para la generación de JWT y webhooks
¿Necesita un recordatorio del flujo general? Consulte la Guía de configuración completa.
1) Cree un espacio de trabajo para cada cliente
Los espacios de trabajo ofrecen a cada cliente un espacio privado y particionado con plantillas, documentos y uso aislados. Es la forma más limpia de crear una separación multiinquilino de estilo SaaS sin filtrar datos entre clientes.
Útil: la configuración del espacio de trabajo, como la copia de correo electrónico y la zona horaria, se define por espacio de trabajo.
2) Cree una plantilla reutilizable
Las plantillas contienen el PDF además de los roles y campos, de modo que puede enviar el mismo documento muchas veces a diferentes destinatarios.
Opción A: Deje que los usuarios diseñen plantillas dentro de su aplicación
Incruste el editor de plantillas con un JWT de corta duración.
Genere el token en el lado del servidor.
3) Cree la solicitud de firma
Convierta su plantilla en una transacción activa. También puede crearla a partir de un PDF original si lo prefiere. La referencia cubre destinatarios, campos, recordatorios y reglas de validación.
Opcional: permita que los usuarios comerciales completen detalles y envíen desde su interfaz de usuario
Incruste el editor de solicitudes de firma con un JWT de 7 días.
Genere el JWT en el lado del servidor.
4) Envíe la solicitud de firma
Cuando esté listo, active el envío.
5) Entregue la firma dentro de su producto o mediante redirección
Firma incrustada
Cada destinatario firma en una URL única que sigue este patrón:
https://app.firma.dev/signing/{signing_request_user_id}.
Obtendrá el signing_request_user_id de la API.
Redirección de firma
Como alternativa, puede enviar a los destinatarios a la interfaz de firma alojada. Consulte la misma guía anterior para obtener más detalles.
6) Realice el seguimiento de todo con webhooks
Escuche eventos como creados, enviados, vistos, firmados y completados para actualizar su sistema en tiempo real. La guía incluye verificación HMAC, rotación, reintentos y una lista de verificación de producción.
Notas rápidas sobre arquitectura
JWT. Genérelos en el lado del servidor. Los tokens del editor de plantillas son de corta duración; los tokens del editor de solicitudes de firma caducan después de 7 días.
Espacios de trabajo para SaaS. Mantenga a los clientes totalmente particionados. Sus operadores seguirán trabajando desde una única API.
Precios y lanzamiento. Comience con los sobres gratuitos incluidos y luego comience a usarlos de forma activa. Sin mínimos. €0,049 por sobre.
¿Qué sigue?
Conecte su primer espacio de trabajo
Añada una plantilla
Envíe su primera solicitud
Subraye si desea incrustar o redirigir
Conecte los webhooks
👉 Obtener clave API - no se requiere tarjeta de crédito.
Artículos relacionados
Nuestra plataforma está diseñada para capacitar a las empresas de todos los tamaños para trabajar de manera más inteligente y alcanzar sus objetivos con confianza.
