Lo que enviamos en enero de 2026

Enero fue un mes ocupado. Publicamos un montón de actualizaciones para Firma.dev de las que estamos bastante entusiasmados, y la mayoría de ellas vinieron directamente de los comentarios que recibimos de los desarrolladores que construyen sobre la API.

El tema de este mes fue 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 en la calidad de vida. Otros desbloquean flujos de trabajo completamente nuevos. Ahora estamos en la versión 1.2.0, y todo aquí está en vivo hoy.

Aquí tienes el resumen.

Solicitudes de Firma un 40% más Rápidas

Pasamos un par de semanas investigando el rendimiento y logramos reducir nuestra latencia promedio de solicitud de firma de 820ms a alrededor de 500ms. Eso es aproximadamente un 40% de mejora en general.

Los cambios fueron principalmente trabajo de infraestructura. Limpiamos algunas consultas de bases de datos que se habían vuelto ineficientes con el tiempo, y movimos activos estáticos detrás de AWS CloudFront para el almacenamiento en caché de borde. Nada innovador, pero el tipo de trabajo que se acumula.

Si estás integrando firmas en tu producto, esto importa más de lo que parece. 300ms de latencia no suenan como mucho, 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.

Solicitudes de Firma Únicas (No se Requiere Plantilla)

Anteriormente, si querías enviar un documento para firma a través de Firma.dev, primero tenías que crear una plantilla. Eso tenía sentido para flujos de trabajo repetibles como contratos de trabajo o NDAs, pero agregaba pasos innecesarios para documentos de una sola vez.

Ahora puedes omitir por completo la plantilla. Sube un PDF directamente, define tus campos y destinatarios en línea, y envíalo. Una llamada a la API, no se requiere creación de plantillas.

Esto es útil para acuerdos ad-hoc, contratos de una sola vez, o cualquier situación en la que no vayas a reutilizar la estructura del documento. Aún obtienes todos los mismos tipos de campos, opciones de firmante y seguimiento. Simplemente no tienes que configurar primero una plantilla.

Consulta el endpoint de crear solicitud de firma para detalles de implementación.

Endpoint de Creación + Envío Atómico

Hablando de reducir llamadas a la API: agregamos un nuevo endpoint atómico que te permite crear y enviar una solicitud de firma en una sola llamada.

Anteriormente llamabas al endpoint de creación, luego llamabas al endpoint de envío. Dos solicitudes, 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 valida todo antes de crear algo. Si algo falla en la validación, no se crea nada y no se te cobra. Los créditos solo se deducen después de que la solicitud de firma se crea con éxito y se envían los correos electrónicos.

Desde los documentos: "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ás construyendo automatizaciones o flujos de trabajo de alto volumen, este endpoint es más limpio y más confiable que encadenar dos llamadas juntas.

Campos de Solo Lectura

Ahora puedes marcar campos como de solo lectura al crear o actualizar una solicitud de firma. Estos son campos que aparecen en el documento con valores pre-rellenados, pero el firmante no puede editarlos.

Esto es útil para cosas como cantidades de contratos, números de referencia, totales calculados o identificaciones de empleados. Cualquier cosa que el firmante necesite ver para obtener contexto pero que no debería 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 se vuelve visible pero no editable.

Controles de Correo Electrónico Granulares

Agregamos cuatro nuevas configuraciones que te dan control detallado sobre qué correos electrónicos envía Firma.dev en tu 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 predeterminados están en true, por lo que las integraciones existentes funcionan exactamente como antes. Pero si quieres enviar tus propios correos electrónicos de marca en lugar de los nuestros, ahora puedes desactivar cualquiera o todos estos y manejar las notificaciones por ti mismo.

Esto combina bien con los ajustes de marca blanca a continuación.

Omitir Términos de Firma.dev para Etiquetado Blanco Completo

Hay una nueva configuración en tu espacio de trabajo llamada "Requerir Aceptación de Términos." Cuando está habilitada (por defecto), los firmantes tienen que aceptar los términos y condiciones de Firma.dev antes de firmar. Cuando lo desactivas, ese paso desaparece por completo.

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

Si optas por esta ruta, recomendamos tener tus propios términos y condiciones en su lugar. 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&Cs cubren eso.

Combinado con los controles de correo electrónico arriba, ahora puedes ejecutar una experiencia de firma completamente de marca sin que aparezca ninguna interfaz de usuario de Firma.dev para tus usuarios finales.

Nuevas Guías para Desarrolladores

Reescribimos una parte de nuestra documentación este mes. Tres nuevas guías se publicaron:

Guía de Autenticación – Cubre la autenticación con clave API para solicitudes de servidor a servidor, además de tokens JWT para incrustar el editor de plantillas y solicitudes de firma en tu aplicación. También incluye el nuevo flujo de rotación de claves API con períodos de gracia de 24 horas.

Guía de Límites de Tasa – Documenta todos los niveles de límites de tasa (200 solicitudes/min para lecturas, 120/min para escrituras, y así sucesivamente). Nota importante aquí: los límites de tasa son por espacio de trabajo, y puedes tener espacios de trabajo ilimitados en tu cuenta. Eso te da una escalabilidad horizontal efectiva ilimitada. Si de alguna manera necesitas incluso límites más altos para un caso de uso específico, comunícate con soporte y podemos aumentarlos, pero los predeterminados ya están construidos para un volumen muy alto.

Guía de Configuración Completa – Un recorrido completo de principio a fin desde la creación de cuentas hasta la firma incrustada. Cubre espacios de trabajo, plantillas, solicitudes de firma, editores incrustados, webhooks y gestión de créditos. Si recién estás comenzando, este es el lugar para empezar.

Versionado Completo de API

Introdujimos un sistema de versionado formal este mes. La API ahora utiliza versionado basado en encabezados mediante el encabezado X-API-Version, y actualmente estamos en la versión v1.2.0.

La versión corta: estamos comprometidos a no romper tu integración. Desde la guía de versionado: "Los cambios que rompen la compatibilidad solo se introducen en incrementos de versión mayor... Los cambios que no rompen la compatibilidad, como nuevos campos opcionales o nuevos endpoints, no requieren una nueva versión."

Cuando eventualmente lancemos una v2, la vieja versión no desaparecerá simplemente. Recibirás advertencias de deprecación en los encabezados de respuesta durante al menos seis meses antes de que algo se suspenda. Los encabezados siguen la RFC 8594, por lo que si ya estás comprobando los encabezados de Deprecation y Sunset en otras APIs, sabrás qué esperar.

Por ahora, v1 está activa sin deprecación programada. Todo lo que enviamos este mes es aditivo, por lo que tu integración existente sigue funcionando sin cambios.

Resumiendo

Eso es enero. Muchas mejoras pequeñas a medianas que suman una API más capaz y más flexible.

Precios no ha cambiado. Sigue siendo €0,029 por sobre, pago por uso, sin mínimos. Si aún no has probado Firma.dev, obtienes 25 sobres gratuitos para probar.

Vamos a seguir enviando. Si hay algo que quieres ver en la API, háznoslo saber.

Comienza gratis – no se requiere tarjeta de crédito.