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 de "clave API en mano" a un flujo de firma en vivo y embebido. Lo mantendremos sencillo, nos enfocaremos en decisiones y te vincularemos directamente a fragmentos funcionales en la documentación.

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

Lo que harás

1. Modelar aislamiento de clientes con Espacios de Trabajo

2. Crear una Plantilla reutilizable

3. Enviar una Solicitud de Firma

4. Integrar la experiencia de firma o redirigir

5. Rastrear todo con Webhooks

La tarifa es simple. Es €0.029 por sobre, con tus primeros 25 sobres gratuitos para que puedas construir y probar de principio a fin.

Requisitos previos

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

• Un PDF que puedas convertir en plantilla

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

¿Necesitas un repaso sobre 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 construir una separación multiinquilino estilo SaaS sin filtrar datos entre los 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: la configuración del espacio de trabajo como la copia de correo electrónico y la zona horaria son 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) Crear una plantilla reutilizable

Las plantillas contienen el PDF más roles y campos, para que puedas enviar el mismo documento muchas veces con 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: Permitir que los usuarios diseñen plantillas dentro de tu aplicación

Integrar 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

Generar el token del lado del 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) Crear la solicitud de firma

Convierte tu plantilla en una transacción en vivo. También puedes crear desde un PDF sin procesar si prefieres. La referencia cubre 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

Opcional: permitir que los usuarios de negocio completen detalles y envíen desde tu interfaz de usuario

Integrar 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

Generar el JWT del lado del 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) Enviar la solicitud de firma

Cuando estés 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) Entregar firma dentro de tu producto o mediante redireccionamiento

Firma embebida

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 redireccionamiento

Alternativamente, puedes enviar a los destinatarios a la interfaz de firma hospedada. Consulta la misma guía anterior para más detalles.

6) Rastrear 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.

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 de arquitectura

• JWTs. Generarlos del lado del servidor. Los tokens del editor de plantillas son de corta duración; los tokens del editor de solicitudes de firma expiran después de 7 días.

• Espacios de trabajo para SaaS. Mantén a los clientes totalmente particionados. Tus operadores todavía trabajan desde una única API.

• Precios y lanzamiento. Comienza con los sobres gratuitos incluidos, luego ve en vivo. Sin mínimos. €0.029 por sobre.

¿Qué sigue?

1. Conecta tu primer espacio de trabajo

2. Añadir una plantilla

3. Envía tu primera solicitud

4. Elige entre integrar o redireccionar

5. Configura los webhooks

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