Lo que enviamos en enero de 2026

Enero ha sido un mes muy ocupado. Hemos lanzado un montón de actualizaciones en Firma.dev que nos hace mucha ilusión presentar, y la mayoría de ellas proceden directamente de los comentarios que recibimos de los desarrolladores que crean en la API.

El tema de este mes ha sido hacer la API 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 las puertas a flujos de trabajo totalmente nuevos. Ya estamos en la versión 1.2.0, y todo lo que hay aquí ya está disponible.

A continuación, el resumen.

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

Pasamos un par de semanas investigando el rendimiento y conseguimos reducir la latencia media de las solicitudes de firma de 820 ms a unos 500 ms. Esto supone una mejora aproximada del 40 % en general.

Los cambios han consistido 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 el almacenamiento en caché perimetral. Nada revolucionario, pero es el tipo de trabajo que acumula resultados.

Si integra firmas en su producto, esto importa más de lo que parece. Una latencia de 300 ms no parece gran cosa, pero es la diferencia entre un flujo de firma que parece instantáneo y uno que parece lento. Unas respuestas más rápidas se traducen en menos flujos abandonados y menos fricción para sus usuarios.

Solicitudes de firma puntuales (no se requiere plantilla)

Anteriormente, para enviar un documento para su firma a través de Firma.dev, primero debía 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 puntuales.

Ahora puede saltarse la plantilla por completo. Suba un PDF directamente, defina sus campos y destinatarios en línea y envíelo. Una sola llamada a la API, sin necesidad de crear una plantilla.

Esto resulta muy útil para acuerdos ad-hoc, contratos puntuales o cualquier situación en la que no se vaya a reutilizar la estructura del documento. Seguirá disponiendo de los mismos tipos de campos, opciones de firmante y seguimiento. Solo que no tendrá que configurar primero una plantilla.

Consulte el punto de conexión para crear solicitudes de firma para obtener detalles sobre la implementación.

Punto de conexión atómico de creación y envío

Hablando de reducir llamadas a la API: hemos añadido un nuevo punto de conexión atómico que le permite crear y enviar una solicitud de firma en una sola llamada.

Antes tenía que llamar al punto de conexión de creación y luego al de envío. Dos solicitudes, dos viajes de ida y vuelta. El nuevo punto de conexión /signing-requests/create-and-send combina ambos en uno solo.

Pero la verdadera ventaja es la integridad transaccional. El punto de conexión lo valida todo antes de crear nada. Si algo falla en la validación, no se crea nada y no se le cobra. Los créditos solo se deducen una vez que la solicitud 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 solicitudes separadas... Deducción de créditos atómica: solo cobra si todo tiene éxito".

Si está creando automatizaciones o flujos de trabajo de gran volumen, este punto de conexión es más limpio y fiable que encadenar dos llamadas.

Campos de solo lectura

Ahora puede marcar los campos como de solo lectura al crear o actualizar una solicitud de firma. Se trata de campos que aparecen en el documento con valores precargados, pero que el firmante no puede editar.

Esto resulta útil para elementos como importes de contratos, números de referencia, totales calculados o identificaciones de empleados. Cualquier cosa que el firmante necesite ver para contextualizar pero que no deba poder modificar.

Encontrará la propiedad read_only en el punto de conexión de actualización integral. Establézcala en true en cualquier campo de texto para que sea visible pero no editable.

Controles detallados del correo electrónico

Hemos añadido cuatro nuevos ajustes que le permiten controlar detalladamente qué correos electrónicos envía Firma.dev en su nombre:

• send_signing_email: la notificación inicial de "por favor, firme este documento"

• send_finish_email: la confirmación de "firma completada"

• send_expiration_email: el recordatorio cuando una solicitud está a punto de expirar

• send_cancellation_email: la notificación cuando se cancela una solicitud

Los cuatro están configurados de forma predeterminada en true, por lo que las integraciones existentes funcionan exactamente igual que antes. Pero si prefiere enviar sus propios correos personalizados con su marca en lugar de los nuestros, ahora puede desactivar cualquiera de ellos o todos y gestionar las notificaciones usted mismo.

Esto combina perfectamente con los ajustes de marca blanca que se detallan a continuación.

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

Hay una nueva configuración en su espacio de trabajo llamada "Requerir aceptación de términos". Cuando está activada (por defecto), los firmantes tienen que aceptar las condiciones de Firma.dev antes de firmar. Cuando la desactiva, ese paso desaparece por completo.

Esto está diseñado para equipos que desean una experiencia de firma con una marca blanca total. Sus firmantes ven su marca, sus correos electrónicos (si ha desactivado los nuestros) y sus condiciones. Firma.dev permanece invisible.

Si opta por este camino, le recomendamos que disponga de sus propias condiciones de uso. Está asumiendo la responsabilidad de informar a los firmantes sobre las consecuencias jurídicas de su firma, así que asegúrese de que sus propias condiciones de uso cubren este aspecto.

En combinación con los controles de correo electrónico anteriores, ahora puede ofrecer una experiencia de firma con una imagen de marca completa sin que sus usuarios finales vean la interfaz de usuario de Firma.dev.

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 de API para solicitudes de servidor a servidor, además de tokens JWT para integrar los editores de plantillas y solicitudes de firma en su aplicación. También incluye el nuevo flujo de rotación de claves de API con períodos de gracia de 24 horas.

Guía de límites de velocidad: documenta todos los niveles de límites de velocidad (200 solicitudes/min para lecturas, 120/min para escrituras, etc.). Nota importante: los límites de velocidad se aplican por espacio de trabajo, y puede tener espacios de trabajo ilimitados en su cuenta. Esto le ofrece una escalabilidad horizontal prácticamente ilimitada. Si por alguna razón necesita límites aún mayores para un caso de uso específico, póngase en contacto con el servicio de asistencia 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 principio a fin, desde la creación de la cuenta hasta la firma integrada. Cubre espacios de trabajo, plantillas, solicitudes de firma, editores integrados, webhooks y gestión de créditos. Si está empezando por primera vez, este es el lugar para comenzar.

Control de versiones completo de la API

Este mes hemos introducido un sistema formal de control de versiones. La API utiliza ahora un control de versiones basado en cabeceras a través de la cabecera X-API-Version, y actualmente nos encontramos en la v1.2.0.

La versión resumida: nos comprometemos a no romper su integración. De la guía de versiones: "Los cambios incompatibles solo se introducen en los incrementos de versiones principales... Los cambios compatibles, como nuevos campos opcionales o nuevos puntos de conexión, no requieren una nueva versión".

Cuando finalmente publiquemos una v2, la versión antigua no desaparecerá sin más. Recibirá avisos de obsolescencia en las cabeceras de respuesta durante al menos seis meses antes de que se deje de dar soporte. Las cabeceras siguen el estándar RFC 8594, por lo que si ya comprueba las cabeceras Deprecation y Sunset en otras API, ya sabrá qué esperar.

Por ahora, la v1 está activa y no hay ninguna obsolescencia programada. Todo lo que hemos lanzado este mes es acumulativo, por lo que su integración actual sigue funcionando sin cambios.

Para terminar

Eso es todo lo relacionado con enero. Un montón de pequeñas y medianas mejoras que se traducen en una API más capaz y flexible.

Las tarifas no han cambiado. Sigue siendo de €0,049 por sobre, de pago por uso y sin mínimos. Si aún no ha probado Firma.dev, puede realizar pruebas con documentos reales de forma gratuita y sin límites, y solo pagará cuando empiece a utilizarlos en el entorno real.

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

Empiece gratis: no se necesita tarjeta de crédito.