Envía tu primer flujo de firma electrónica rápidamente con Firma: Una guía rápida para desarrolladores

¿Eres desarrollador y ya tienes tu cuenta de Firma? Perfecto. Esta guía te lleva desde tener la “clave API en mano” hasta un flujo de firma incrustado y en vivo. La mantendremos ágil, nos enfocaremos en las decisiones y te enlazaremos directamente a fragmentos listos para usar en la documentación.

¿Buscas la guía no técnica? Haz clic aquí.

Qué vas a hacer

1. Modelar el aislamiento de los clientes con Espacios de trabajo (Workspaces)

2. Crear una Plantilla (Template) reutilizable

3. Enviar una Solicitud de firma

4. Incrustar la experiencia de firma o redirigir

5. Seguir todo el proceso con Webhooks

Los precios son sencillos. Cuesta €0.049 por sobre, prueba con documentos reales, gratis para que puedas construir y probar de extremo a extremo.

Requisitos previos

Clave API de la empresa o espacio de trabajo de tu panel de control

• Un PDF que puedas convertir en una plantilla

• Un lugar donde ejecutar código de servidor para la generación de JWT y webhooks

¿Necesitas un recordatorio del flujo general? Consulta la Guía de configuración completa.

1) Crea 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.

Crear un espacio de trabajo
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Crear un espacio de trabajo
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Crear un espacio de trabajo
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Útil: las configuraciones del espacio de trabajo, como el contenido del correo electrónico y la zona horaria, se definen por espacio de trabajo.

Guía de configuración del espacio de trabajo
https://docs.firma.dev/guides/workspace-settings

Guía de configuración del espacio de trabajo
https://docs.firma.dev/guides/workspace-settings

Guía de configuración del espacio de trabajo
https://docs.firma.dev/guides/workspace-settings

2) Crea una plantilla reutilizable

Las plantillas contienen el PDF además de los roles y los campos, para que puedas enviar el mismo documento muchas veces a diferentes destinatarios.

Crear plantilla (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Crear plantilla (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Crear plantilla (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Opción A: Deja que los usuarios diseñen plantillas dentro de tu aplicación

Incrusta el editor de plantillas con un JWT de corta duración.

Editor de plantillas incrustable (guía)
https://docs.firma.dev/guides/embeddable-template-editor

Editor de plantillas incrustable (guía)
https://docs.firma.dev/guides/embeddable-template-editor

Editor de plantillas incrustable (guía)
https://docs.firma.dev/guides/embeddable-template-editor

Genera el token en el lado del servidor.

Generar JWT para incrustar plantillas
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

Generar JWT para incrustar plantillas
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

Generar JWT para incrustar plantillas
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

3) Crea la solicitud de firma

Convierte tu plantilla en una transacción en vivo. También puedes crearla a partir de un PDF original si lo prefieres. La referencia cubre destinatarios, campos, recordatorios y reglas de validación.

Crear solicitud de firma
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Crear solicitud de firma
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Crear solicitud de firma
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Opcional: permite que los usuarios de negocio rellenen los datos y realicen el envío desde tu interfaz de usuario

Incrusta el editor de solicitudes de firma con un JWT de 7 días.

Editor de solicitudes de firma incrustable (guía)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Editor de solicitudes de firma incrustable (guía)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Editor de solicitudes de firma incrustable (guía)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Genera el JWT en el lado del servidor.

Generar JWT para el editor de solicitudes de firma
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

Generar JWT para el editor de solicitudes de firma
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

Generar JWT para el editor de solicitudes de firma
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

4) Envía la solicitud de firma

Cuando estés listo, activa el envío.

Enviar solicitud de firma
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

Enviar solicitud de firma
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

Enviar solicitud de firma
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

5) Ofrece la firma dentro de tu 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}.

Firma incrustable (patrón iframe y consejos)
https://docs.firma.dev/guides/embeddable-signing

Firma incrustable (patrón iframe y consejos)
https://docs.firma.dev/guides/embeddable-signing

Firma incrustable (patrón iframe y consejos)
https://docs.firma.dev/guides/embeddable-signing

Obtendrás el signing_request_user_id de la API.

Obtener usuarios de solicitud de firma
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Obtener usuarios de solicitud de firma
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Obtener usuarios de solicitud de firma
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Firma por redirección

Como alternativa, puedes enviar a los destinatarios a la interfaz de firma alojada. Consulta la misma guía anterior para obtener más detalles.

6) Realiza el seguimiento de todo con webhooks

Escucha eventos como creado, enviado, visto, firmado y completado para actualizar tu sistema en tiempo real. La guía incluye verificación HMAC, rotación, reintentos y una lista de verificación para producción.

Guía de webhooks
https://docs.firma.dev/guides/webhooks

Guía de webhooks
https://docs.firma.dev/guides/webhooks

Guía de webhooks
https://docs.firma.dev/guides/webhooks

Crear webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Crear webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Crear webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Notas rápidas de arquitectura

• JWTs. Generados 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 a los 7 días.

• Espacios de trabajo para SaaS. Mantén a los clientes completamente aislados. Tus operadores siguen trabajando desde una única API.

• Precios y lanzamiento. Empieza con los sobres gratuitos incluidos y luego pasa a producción. Sin mínimos. €0.049 por sobre.

¿Qué es lo siguiente?

1. Conecta tu primer espacio de trabajo

2. Añade una plantilla

3. Envía tu primera solicitud

4. Elige entre incrustar o redirigir

5. Configura los webhooks

👉 Obtener clave API - no se requiere tarjeta de crédito.