Descarga parcial de documentos y ajustes de marca de agua (API v1.16.0)

La API v1.16.0 introduce dos funciones que resuelven un problema habitual: descargar los documentos de solicitud de firma antes de que todos los firmantes hayan terminado y controlar el aspecto de esos PDF parciales con una marca de agua configurable.

Descargar documentos en cualquier etapa

Antes de esta actualización, solo podías descargar el PDF de una solicitud de firma después de que todos los firmantes hubieran finalizado. Eso funciona bien para acuerdos sencillos entre dos partes, pero se queda corto cuando tienes contratos con varios firmantes en los que los equipos legales o de cumplimiento necesitan visibilidad del progreso antes de que llegue la última firma.

El nuevo GET /signing-requests/{id}/download punto de conexión devuelve una URL de descarga firmada previamente para el documento en su estado actual. Funciona con todos los estados de la solicitud de firma: in-progress, cancelled, declined y expired.

Para las solicitudes de firma completadas, obtienes el PDF final firmado como antes. Para todo lo demás, obtienes una instantánea que incluye solo los campos completados por los firmantes que ya han terminado. Los campos de los firmantes pendientes se omiten por completo, de modo que el documento refleja exactamente lo que se ha ejecutado hasta ahora.

Cada PDF parcial también incluye una página de auditoría con una tabla de estado por firmante y un marco probatorio, ofreciéndote un registro claro de quién ha firmado, quién no y cuándo.

Para habilitar las descargas parciales en una solicitud de firma, establece allow_partial_download: true en la configuración de la solicitud de firma. El documento se genera bajo demanda la primera vez que lo solicitas y se almacena en caché para llamadas posteriores. Si el documento aún no se ha generado, recibirás un 503 con un encabezado Retry-After.

Control de marca de agua por espacio de trabajo

Algunos equipos quieren que los PDF parciales estén claramente marcados como incompletos. Otros quieren documentos limpios que puedan reenviar a las partes interesadas sin ruido visual. La nueva show_partial_watermark configuración en configuración del espacio de trabajo te da ese control.

Cuando está activada, los PDF parciales incluyen una marca de agua diagonal "EN CURSO — AÚN NO EJECUTADO" en cada página. Cuando está desactivada (el valor predeterminado), el documento se descarga limpio.

Esta es una configuración a nivel de espacio de trabajo, así que si utilizas Espacios de trabajo de clientes para segmentar los clientes de tu plataforma, cada espacio de trabajo puede tener su propia preferencia de marca de agua.

Detalles de la API

Aquí tienes un breve resumen de lo nuevo en la API:

• Nuevo punto de conexión: GET /signing-requests/{id}/download devuelve una download_url firmada previamente con una marca de tiempo expires_at

• Nueva configuración: allow_partial_download (booleano) en la configuración de la solicitud de firma habilita las descargas parciales

• Nueva configuración del espacio de trabajo: show_partial_watermark (booleano | null) controla la marca de agua diagonal en los PDF parciales

• Estados admitidos: finished, in_progress, cancelled, declined, expired

Para ver la especificación completa del punto de conexión, consulta la documentación de descarga de solicitudes de firma. Para las notas de migración, consulta el registro de cambios de la API.

Esta es una actualización no disruptiva. No cambia el comportamiento existente y las integraciones existentes seguirán funcionando sin necesidad de modificaciones.

Empieza

Si ya utilizas la API de Firma.dev, puedes empezar a usar el nuevo punto de conexión de inmediato actualizando el encabezado de versión de tu API a v01.16.00. Si eres nuevo en Firma.dev, consigue ahora tu clave de API y empieza a crear gratis, no necesitas tarjeta de crédito.