Lo que enviamos en enero de 2026

Enero fue un mes ajetreado. Enviamos un montón de actualizaciones a Firma.dev que nos entusiasman mucho, y la mayoría de ellas provienen directamente de los comentarios que recibimos de los desarrolladores que trabajan con la API.

El tema de este mes fue 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 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í está el resumen.

40% Más Rápidas Solicitudes de Firma

Pasamos un par de semanas investigando el rendimiento y logramos reducir nuestra latencia promedio de solicitud de firma de 820ms a aproximadamente 500ms. Eso es aproximadamente una mejora del 40% 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 almacenamiento en caché en el borde. Nada revolucionario, pero el tipo de trabajo que se acumula.

Si estás incrustando firmas en tu producto, esto importa más de lo que podría parecer. 300ms de latencia no suenan 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 flujos menos abandonados y menos fricción para tus usuarios.

Solicitudes de Firma Puntuales (No se Requiere Plantilla)

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

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

Esto es útil para acuerdos ad-hoc, contratos únicos o cualquier situación en la que no vas 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 una plantilla primero.

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

Endpoint Atómico de Crear + Enviar

Hablando de reducir llamadas de API: añadimos 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 /signing-requests/create-and-send combina ambos en uno.

Pero el verdadero beneficio es la integridad transaccional. El endpoint valida todo antes de crear cualquier cosa. Si algo falla en la validación, no se crea nada y no te cobran. Los créditos solo se deducen después de que la solicitud de firma se crea con éxito y los correos electrónicos se envían.

Desde los docs: "Llamada única de API en lugar de dos solicitudes separadas... Deducción atómica de crédito – solo cargos si todo tiene éxito."

Si estás creando 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 solo lectura al crear o actualizar una solicitud de firma. Estos son campos que aparecen en el documento con valores prellenados, pero el firmante no puede editarlos.

Esto es útil para cosas como montos de contratos, números de referencia, totales calculados o IDs de empleados. Cualquier cosa que el firmante necesite ver para contexto pero que no debería poder cambiar.

Encontrarás la propiedad read_only en el endpoint de actualización integral. Establecerlo en true en cualquier campo de texto, y se vuelve visible pero no editable.

Controles Granulares de Correo Electrónico

Agregamos cuatro configuraciones nuevas que te dan control detallado sobre qué correos electrónicos Firma.dev envía 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 una solicitud se cancela

Los cuatro valores predeterminados son true, así que las integraciones existentes funcionan exactamente como antes. Pero si quieres enviar tus propios correos electrónicos con marca en lugar de los nuestros, ahora puedes desactivar cualquiera o todos estos y manejar las notificaciones tú mismo.

Esto se combina bien con las configuraciones de etiqueta 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 etiquetada. 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 este camino, 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&C cubran eso.

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

Nuevas Guías para Desarrolladores

Reescribimos una parte de nuestra documentación este mes. Tres nuevas guías se pusieron en línea:

Guía de Autenticación – Cubre la autenticación de clave API para solicitudes de servidor a servidor, además de tokens JWT para incrustar la plantilla y editores de solicitud de firma en tu aplicación. También incluye el nuevo flujo de rotación de clave 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, etc.). 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 escalabilidad horizontal efectivamente ilimitada. Si de alguna manera necesitas límites aún más altos para un caso de uso específico, comunícate con el soporte y podemos aumentarlos, pero los valores 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 la cuenta 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

Implementamos un sistema de versionado formal este mes. La API ahora utiliza versionado basado en encabezados a través del encabezado X-API-Version, y actualmente estamos en v1.2.0.

La versión corta: estamos comprometidos a no romper tu integración. Del guía de versionado: "Se introducen cambios disruptivos solo en incrementos de versión mayor... Cambios no disruptivos como nuevos campos opcionales o nuevos endpoints no requieren una nueva versión."

Cuando eventualmente lancemos una v2, la versión anterior no desaparecerá. Recibirás advertencias de descontinuación en los encabezados de respuesta por al menos seis meses antes de que algo sea descontinuado. Los encabezados siguen RFC 8594, así que si ya estás revisando los encabezados de Deprecation y Sunset en otras APIs, sabrás qué esperar.

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

Para Concluir

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

Los precios no han cambiado. Sigue siendo $0.029 por sobre, pagas sobre la marcha, sin mínimos. Si aún no has probado Firma.dev, obtienes 25 sobres gratis para probar.

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

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