Lo que enviamos en enero de 2026

Enero fue un mes ocupado. Enviamos una serie de actualizaciones a Firma.dev que nos entusiasman bastante, y la mayoría de ellas provienen directamente de los comentarios que recibimos de los desarrolladores que construyen sobre la API.

El tema de este mes fue hacer que la API fuera 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 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.

Solicitudes de Firma 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 aproximadamente 500ms. Eso es aproximadamente una mejora del 40% en general.

Los cambios fueron principalmente trabajos de infraestructura. Limpiamos algunas consultas de base de datos que se habían vuelto ineficientes con el tiempo y movimos activos estáticos detrás de AWS CloudFront para caché en el 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 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 firmar a través de Firma.dev, tenías que crear primero una plantilla. Eso tenía sentido para flujos de trabajo repetibles como contratos de trabajo o NDAs, 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 llamada a la API, no se requiere creación de plantilla.

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

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

Endpoint Atómico de Crear + Enviar

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.

Pero el verdadero beneficio es la integridad transaccional. El endpoint valida todo antes de crear algo. Si algo falla 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 los correos electrónicos se envían.

De los documentos: "Una sola llamada a la API en lugar de dos solicitudes separadas... Deducción atómica de créditos – solo se cobra 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 de 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 el contexto, pero que no debería poder cambiar.

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

Controles de Email Granulares

Agregamos cuatro nuevas configuraciones que te dan control detallado sobre qué emails Firma.dev envía en tu nombre:

• send_signing_email – la notificación inicial de "por favor firma este documento"

• send_finish_email – la confirmación de "firma completa"

• 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, por lo que las integraciones existentes funcionan exactamente igual que antes. Pero si deseas enviar tus propios emails 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 la configuración 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 (el valor predeterminado), los firmantes deben aceptar los términos y condiciones de Firma.dev antes de firmar. Cuando lo deshabilitas, ese paso desaparece por completo.

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

Si tomas esta ruta, recomendamos tener tus propios términos y condiciones establecidos. 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 email arriba, ahora puedes ejecutar una experiencia de firma completamente con tu marca sin que aparezca ninguna interfaz 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 han salido en vivo:

Guía de Autenticación – Cubre la autenticación de clave API para solicitudes servidor a servidor, además de tokens JWT para integrar 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, 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 efectivamente una escalabilidad horizontal 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 diseñados 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, solicitudes de firma, editores integrados, webhooks y gestión de créditos. Si recién estás comenzando, este es el lugar para empezar.

Versionado Completo de la API

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

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

Cuando eventualmente lancemos una v2, la versión antigua no desaparecerá de inmediato. Recibirás advertencias de depreciación en los encabezados de respuesta durante al menos seis meses antes de que se elimine cualquier cosa. Los encabezados siguen RFC 8594, por lo que si ya estás verificando los encabezados Deprecation y Sunset en otras APIs, sabrás qué esperar.

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

Conclusión

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

Los precios no han cambiado. Todavía son $0.029 por sobre, pago por uso, 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 quieres ver en la API, háznoslo saber.

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