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 llevará desde tener la "clave API en mano" hasta un flujo de firma incrustado y activo. Seremos directos, nos centraremos en las decisiones y te enlazaremos directamente a fragmentos de código 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 clientes con espacios de trabajo

2. Crear una plantilla reutilizable

3. Enviar una solicitud de firma

4. Incrustar la experiencia de firma o redirigir

5. Hacer un seguimiento de todo con Webhooks

El precio es sencillo. Son €0,029 por sobre; realiza pruebas con documentos reales de forma gratuita para que puedas programar y probar todo de extremo a extremo.

Requisitos previos

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

• Un PDF que puedas convertir en plantilla

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

¿Necesitas refrescar el 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 al estilo SaaS sin que se filtren datos entre clientes.

Create a workspace
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Create a workspace
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Create a workspace
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Útil: los ajustes del espacio de trabajo, como el contenido del correo electrónico y la zona horaria, se configuran por espacio de trabajo.

Workspace settings guide
https://docs.firma.dev/guides/workspace-settings

Workspace settings guide
https://docs.firma.dev/guides/workspace-settings

Workspace settings guide
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, de modo que puedes enviar el mismo documento muchas veces a diferentes destinatarios.

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

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

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

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

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

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Genera el token en el servidor.

Generate JWT for template embedding
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

Generate JWT for template embedding
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

Generate JWT for template embedding
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 directo. También puedes crearla a partir de un PDF original si lo prefieres. La referencia incluye destinatarios, campos, recordatorios y reglas de validación.

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Ocupación opcional: permite que los usuarios de negocio completen los detalles y realicen el envío desde tu interfaz de usuario

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

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Genera el JWT en el servidor.

Generate JWT for signing request editor
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

Generate JWT for signing request editor
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

Generate JWT for signing request editor
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 todo esté listo, activa el envío.

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

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

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

5) Facilita 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}.

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

Obtendrás el signing_request_user_id de la API.

Get signing request users
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Get signing request users
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Get signing request users
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Firma por redirección

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

6) Haz un 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 comprobación de producción.

Webhooks guide
https://docs.firma.dev/guides/webhooks

Webhooks guide
https://docs.firma.dev/guides/webhooks

Webhooks guide
https://docs.firma.dev/guides/webhooks

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

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

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

Notas rápidas sobre arquitectura

• JWT. Genéralos en el 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 particionados. Tus operadores seguirán trabajando desde una única API.

• Precios y lanzamiento. Empieza con los sobres gratuitos incluidos y luego pasa a producción. Sin mínimos. €0,029 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 incrustar o redirigir

5. Conecta los webhooks

👉 Obtener clave API - sin necesidad de tarjeta de crédito.