Calificación de 4.8 estrellas en g2.com
¿PDF actualizado? No tienes que reconstruir tu plantilla.
Si alguna vez has gestionado firmas de plantillas en producción, has encontrado este problema. Un abogado actualiza una cláusula. Legal envía un PDF revisado. Tu plantilla de NDA de 14 campos ahora necesita ser reconstruida desde cero: vuelve a cargar el documento, reemplaza cada campo, reasigna cada firmante.
Para una plantilla eso es una hora de trabajo. Para diez plantillas en cincuenta espacios de trabajo de clientes, se convierte en un problema real.
El reemplazo de documentos de plantilla lo soluciona. Intercambia el PDF subyacente en cualquier plantilla y cada campo, asigneación de firmante y configuración se mantiene exactamente donde estaba.
El problema que resuelve
Las plantillas son donde reside el verdadero trabajo
A menudo encuentran que el acceso a la API tiene sentido porque ya están pagando por la plataforma. Agregar acceso para desarrolladores a un acuerdo Empresarial existente suele ser negociable, y el trabajo legal/de adquisición ya está hecho.
La misma estructura. Los mismos campos. Sin forma de mantenerlos... Hasta ahora.
Los desencadenantes son comunes: una corrección de error tipográfico, una revisión de cláusula, un encabezado renovado, una actualización del equipo legal, un cambio regulatorio. La estructura del documento se mantiene igual, las páginas se mantienen igual, los campos deberían mantenerse igual. Anteriormente no había forma de preservar ese trabajo. Ahora sí la hay.
Cómo Funciona
Intercambia el PDF. Mantén todo lo demás.
Sube un nuevo PDF. Firma.dev valida que el recuento de páginas coincida con el original y que las dimensiones de las páginas estén dentro de una tolerancia de 1 punto. Si ambas comprobaciones pasan, el documento se intercambia instantáneamente. Cada posición de campo, cada asignación de firmante, cada configuración de plantilla permanece intacta.
Por qué existen las reglas de validación
Las reglas de validación no son restricciones arbitrarias, son salvaguardas. Si el recuento de páginas cambia o las dimensiones se alteran significativamente, las posiciones de los campos se desplazarían fuera de la página o aterrizarían en la ubicación incorrecta. La tolerancia de 1pt cubre pequeñas diferencias de renderizado entre exportaciones de PDF desde el mismo archivo fuente, mientras bloquea reemplazos que desalinearían tus campos.
Tres superficies soportan el reemplazo de documentos
Editor de plantillas principal
Un botón de Reemplazar Documento en el encabezado de la plantilla. Subir directamente desde la interfaz de usuario.
Editor integrado
Validación del lado del servidor mediante la función edge con autenticación JWT. Funciona en cualquier integración embebida.
API REST
POST /templates/{id}/replace-document
con un PDF codificado en base64.
Usando la API
El endpoint es simple. Codifica tu PDF de reemplazo como base64 y haz un POST al template (referencia API: https://docs.firma.dev/api-reference/v01.09.00/templates/replace-template-document)
La respuesta es el objeto de plantilla actualizado. Si la validación falla, recibes un 400 con un error claro que indica si el problema es una discrepancia en el número de páginas, una discrepancia en las dimensiones o un PDF no válido.
Reglas de validación
Las cargas de archivos DOC y DOCX a través de la interfaz de usuario se convierten automáticamente a PDF antes de la validación. La API acepta PDF directamente.
Comprobar
Requisito
Número de páginas
Debe coincidir exactamente con el original
Dimensiones de la página
Debe coincidir dentro de una tolerancia de 1 punto por página
Formato de archivo
PDF codificado en Base64 a través de API; PDF, DOC o DOCX (hasta 60MB) a través de la interfaz de usuario
Para quién es esto
Equipos legales y de cumplimiento iterando en el lenguaje del contrato
Cuando se actualizan sus acuerdos estándar, una llamada de API ahora reemplaza el documento en cualquier plantilla sin alterar la configuración del campo.
Plataformas SaaS que gestionan plantillas en los espacios de trabajo de los clientes
Renombrar o actualizar un documento que se ha desplegado en docenas de espacios de trabajo ya no significa reconstrucciones manuales en cada uno. Actualiza la plantilla fuente y habrás terminado.
Actualizaciones de documentos orientadas al cumplimiento
Las industrias reguladas a veces requieren actualizaciones de documentos según un cronograma. Reemplazar el PDF sin perder ubicaciones de campos significa que la actualización puede ser automatizada, probada y desplegada sin reasignación humana.
La sustitución del documento de plantilla está disponible en la API v1.9.0 sin cambios importantes de la v1.8.0.
