Lo que enviamos en enero de 2026

Enero ha sido un mes de mucha actividad. Hemos lanzado una serie de actualizaciones en Firma.dev que nos entusiasman bastante, y la mayoría de ellas provienen directamente de los comentarios que recibimos de los desarrolladores que crean sobre la API.

El tema de este mes ha sido hacer que la API sea más rápida, más flexible y más fácil de integrar. Algunos de estos cambios son pequeñas mejoras de calidad de vida. Otros abren flujos de trabajo completamente nuevos. Ahora estamos en la versión 1.2.0, y todo lo que se detalla aquí ya está activo.

A continuación, el resumen de las novedades.

Peticiones de firma un 40 % más rápidas

Pasamos un par de semanas investigando el rendimiento y logramos reducir nuestra latencia promedio en las peticiones de firma de 820 ms a unos 500 ms. Eso representa aproximadamente una mejora del 40 % en todos los ámbitos.

Los cambios consistieron principalmente en trabajos de infraestructura. Limpiamos algunas consultas de bases de datos que se habían vuelto ineficientes con el tiempo y movimos los activos estáticos detrás de AWS CloudFront para almacenamiento en caché periférico (edge caching). Nada revolucionario, pero es el tipo de trabajo que se va acumulando de manera positiva.

Si estás integrando firmas en tu producto, esto es más importante de lo que parece. Una latencia de 300 ms no parece gran cosa, pero es la diferencia entre un flujo de firma que se siente instantáneo y uno que se siente lento. Respuestas más rápidas significan menos flujos abandonados y menos fricción para tus usuarios.

Peticiones de firma puntuales (sin necesidad de plantilla)

Anteriormente, si querías enviar un documento para firma a través de Firma.dev, primero tenías que crear una plantilla. Esto tenía sentido para flujos de trabajo repetitivos como contratos de trabajo o acuerdos de confidencialidad, pero añadía pasos innecesarios para documentos de una sola vez.

Ahora puedes omitir la plantilla por completo. Sube un PDF directamente, define tus campos y destinatarios en línea y envíalo. Una sola llamada a la API, sin necesidad de crear una plantilla primero.

Esto es útil para acuerdos específicos, contratos de una sola vez o cualquier situación en la que no vayas a reutilizar la estructura del documento. Sigues teniendo los mismos tipos de campos, opciones de firmante y seguimiento. Solo que no tienes que configurar una plantilla primero.

Consulta el endpoint para crear peticiones de firma para obtener detalles sobre la implementación.

Endpoint atómico creación + envío

Hablando de reducir las llamadas a la API: hemos añadido un nuevo endpoint atómico que te permite crear y enviar una petición de firma en una sola llamada.

Anteriormente, llamabas al endpoint de creación y luego al endpoint de envío. Dos peticiones, dos viajes de ida y vuelta. El nuevo endpoint /signing-requests/create-and-send combina ambos en uno solo.

Pero el verdadero beneficio es la integridad transaccional. El endpoint lo valida todo antes de crear cualquier cosa. Si algo falla en la validación, no se crea nada y no se te cobra ningún crédito. Los créditos solo se deducen después de que la petición de firma se ha creado correctamente y se han enviado los correos electrónicos.

De la documentación: «Una sola llamada a la API en lugar de dos peticiones separadas... Deducción atómica de créditos: solo cobra si todo tiene éxito».

Si estás creando automatizaciones o flujos de trabajo de gran volumen, este endpoint es más limpio y confiable que encadenar dos llamadas.

Campos de solo lectura

Ahora puedes marcar campos como de solo lectura al crear o actualizar una petición de firma. Estos son campos que aparecen en el documento con valores precompletados, pero que el firmante no puede editar.

Esto es útil para cosas como importes de contratos, números de referencia, totales calculados o identificadores de empleados. Cualquier cosa que el firmante necesite ver para tener contexto pero que no deba poder cambiar.

Encontrarás la propiedad read_only en el endpoint de actualización integral. Establécela en true en cualquier campo de texto y pasará a ser visible pero no editable.

Controles granulares de correo electrónico

Hemos añadido cuatro nuevas configuraciones que te brindan un control detallado sobre qué correos electrónicos envía Firma.dev en tu nombre:

• send_signing_email – la notificación inicial de «por favor, firma este documento»

• send_finish_email – la confirmación de «firma completada»

• send_expiration_email – el recordatorio cuando una petición está a punto de caducar

• send_cancellation_email – la notificación cuando se cancela una petición

Las cuatro opciones están activadas de manera predeterminada en true, por lo que las integraciones existentes funcionan exactamente igual que antes. Pero si prefieres enviar tus propios correos electrónicos corporativos en lugar de los nuestros, ahora puedes desactivar cualquiera o todas estas opciones y encargarte tú mismo de las notificaciones.

Esto combina perfectamente con la configuración de marca blanca que se detalla a continuación.

Omitir los términos de Firma.dev para una marca blanca completa

Hay una nueva configuración en tu espacio de trabajo llamada «Requerir aceptación de términos». Cuando está habilitada (por defecto), los firmantes deben aceptar los términos y condiciones de Firma.dev antes de firmar. Cuando la deshabilitas, ese paso desaparece por completo.

Esto está diseñado para equipos que desean una experiencia de firma con una marca blanca total. Tus firmantes verán tu identidad visual, tus correos electrónicos (si has desactivado los nuestros) y tus propios términos de servicio. Firma.dev permanece invisible.

Si optas por esta vía, te recomendamos tener listos tus propios términos y condiciones. Estás asumiendo la responsabilidad de informar a los firmantes sobre las implicaciones legales de su firma, así que asegúrate de que tus propios Términos y Condiciones lo cubran.

En combinación con los controles de correo electrónico anteriores, ahora puedes ofrecer una experiencia de firma completamente personalizada con tu marca sin que aparezca ninguna interfaz de usuario de Firma.dev para tus usuarios finales.

Nuevas guías para desarrolladores

Este mes hemos reescrito una parte de nuestra documentación. Se han publicado tres nuevas guías:

Guía de autenticación – cubre la autenticación con clave API para peticiones servidor a servidor, además de tokens JWT para integrar los editores de plantillas y peticiones de firma en tu aplicación. También incluye el nuevo flujo de rotación de claves API con periodos de gracia de 24 horas.

Guía de límites de tasa – documenta todos los niveles de límite de tasa (200 peticiones/min para lecturas, 120/min para escrituras, etc.). Nota importante aquí: los límites de tasa se aplican por espacio de trabajo, y puedes tener espacios de trabajo ilimitados en tu cuenta. Eso te ofrece una escalabilidad horizontal prácticamente ilimitada. Si por alguna razón necesitas límites aún más altos para un caso de uso específico, ponte en contacto con nuestro servicio de soporte y podremos aumentarlos, pero los valores predeterminados ya están preparados para volúmenes muy altos.

Guía de configuración completa – un recorrido completo de extremo a extremo, desde la creación de la cuenta hasta la firma integrada. Cubre espacios de trabajo, plantillas, peticiones de firma, editores integrados, webhooks y gestión de créditos. Si estás dando tus primeros pasos, este es el lugar ideal para comenzar.

Control de versiones completo de la API

Este mes hemos introducido un sistema formal de control de versiones. Ahora la API utiliza versiones basadas en cabeceras a través de la cabecera X-API-Version, y actualmente estamos en la v1.2.0.

En resumen: nos comprometemos a no romper tu integración. De la guía de versiones: «Los cambios incompatibles solo se introducen en versiones principales... Los cambios compatibles, como nuevos campos opcionales o nuevos endpoints, no requieren una nueva versión».

Cuando finalmente lancemos una v2, la versión anterior no desaparecerá de inmediato. Recibirás avisos de obsolescencia en las cabeceras de respuesta durante al menos seis meses antes de que se discontinúe por completo. Las cabeceras siguen el estándar RFC 8594, por lo que si ya controlas las cabeceras Deprecation y Sunset en otras API, sabrás qué esperar.

Por ahora, la v1 está activa sin una fecha de obsolescencia programada. Todo lo que hemos lanzado este mes es complementario, por lo que tu integración existente seguirá funcionando sin necesidad de cambios.

Conclusión

Eso ha sido todo en enero. Una gran cantidad de pequeñas y medianas mejoras que se traducen en una API más potente y flexible.

Los precios no han cambiado. Sigue costando €0.029 por sobre, pago por uso y sin mínimos. Si aún no has probado Firma.dev, puedes realizar pruebas con documentos reales de forma gratuita, sin límites y solo pagar cuando pases a producción.

Seguiremos lanzando mejoras. Si hay algo que te gustaría ver en la API, háznoslo saber.

Comienza gratis – sin tarjeta de crédito obligatoria.