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 «tener la clave API en la mano» a un flujo de firma incrustado en vivo. Mantendremoslo ligero, nos centraremos en las decisiones y te enlazaremos directamente a fragmentos funcionales en la documentación.

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

Qué harás

1. Modela el aislamiento de clientes con Workspaces

2. Crea una plantilla reutilizable

3. Envía una solicitud de firma

4. Incrusta la experiencia de firma o redirige

5. Haz seguimiento de todo con Webhooks

El precio es sencillo. Son €0,029 por sobre, y tus primeros 25 sobres son gratis para que puedas construir y probar de principio a fin.

Requisitos previos

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

• Un PDF que puedes convertir en una plantilla

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

¿Necesitas repasar el flujo general? Consulta la Guía completa de configuración.

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 multicliente al 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: la configuración del espacio de trabajo, como el texto de los correos y la zona horaria, es específica de cada 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 incluyen el PDF, además de roles y campos, para que puedas enviar el mismo documento muchas veces a distintos 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 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 sin procesar 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: deja que los usuarios de negocio completen los detalles y envíen desde tu interfaz

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 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) Entrega 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 y consejos para iframe)
https://docs.firma.dev/guides/embeddable-signing

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

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

Obtenerás el signing_request_user_id de la API.

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

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

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

Firma mediante 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) Haz 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. 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 después de 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 despliegue. Empieza con los sobres gratuitos incluidos y luego pasa a producción. Sin mínimos. €0,029 por sobre.

¿Qué sigue?

1. Conecta tu primer espacio de trabajo

2. Añade una plantilla

3. Envía tu primera solicitud

4. Elige incrustar o redirigir

5. Configura los webhooks

👉 Obtener clave API - no credit card required.