
Calificación de 4.8 estrellas en g2.com

La recopilación de documentos no debería ser un flujo de trabajo separado
Campos de carga de archivos: Todo en un solo lugar, una llamada a la API
Los campos de carga de archivos de Firma.dev te permiten recopilar documentos de apoyo dentro del flujo de firma en sí. Los firmantes pueden subir imágenes o PDFs directamente junto a su firma, iniciales y otros campos del formulario. Una experiencia, una llamada API, todo en un solo lugar.
Los campos de carga de archivos fueron lanzados en v1.11.0 y están disponibles en todas las cuentas.
¿Qué son los campos de carga de archivos?

Colocación y Configuración de Campos de Carga de Archivos
El tipo de campo file funciona como cualquier otro campo en Firma.dev. Lo colocas en un documento, lo asignas a un destinatario y lo marcas como requerido u opcional.
Cuando el firmante abre el documento, ve un área de carga donde puede adjuntar un archivo.
Tipos de archivo aceptados
La diferencia es lo que recopila. En lugar de capturar una firma o entrada de texto, un campo de archivo acepta cargas de imágenes (JPG, PNG) y archivos PDF. El firmante elige un archivo de su dispositivo, Firma.dev lo valida del lado del servidor, y el archivo adjunto se convierte en parte de la solicitud de firma completada.


todo en una sola presentación
Esto significa que puedes crear flujos de trabajo donde el acuerdo firmado y su documentación de respaldo lleguen juntos, no como envíos separados días después.
Cómo funciona
Cada campo de carga de archivos tiene un objeto format_rules que controla qué tipos de archivos son aceptados. Hay tres modos:
imagen_y_pdf
Acepta tanto imágenes (JPG, PNG) como archivos PDF. Esta es la configuración predeterminada.
imagen
Acepta solo JPG y PNG.
pdf
Solo acepta archivos PDF.
El tamaño máximo del archivo es de 10 MB por carga. Los archivos se procesan en el lado del servidor a través de funciones en el borde, no se almacenan en el lado del cliente.
Aquí se explica cómo agregar un campo de carga de archivo a una solicitud de firma:
Esto crea una solicitud de firma con un campo de firma y un campo de carga de archivos en la misma página. El campo de archivo está configurado para aceptar solo imágenes, lo cual tiene sentido para algo como una foto de identificación.

Validación de bytes mágicos
Firma.dev valida los archivos subidos inspeccionando su contenido real (bytes mágicos), no solo la extensión del archivo. Si alguien renombra un .exe a .jpg e intenta subirlo, la validación lo detecta.
Esta es una capa de seguridad significativa que la mayoría de las plataformas de firma electrónica omiten, confiando en cambio en comprobaciones basadas en extensiones que son triviales de eludir.
La validación ocurre del lado del servidor antes de que el archivo sea aceptado, por lo que los archivos inválidos nunca ingresan en los datos de su solicitud de firma.
Casos de Uso
Los campos de carga de archivos son útiles en cualquier lugar donde necesites documentación de apoyo junto a un acuerdo firmado.
Integración de empleados
Recoge una carta de oferta firmada y una foto de la identificación emitida por el gobierno del nuevo empleado en el mismo flujo. Establece acceptedFileTypes a image para el campo de carga de ID, y el firmante toma una foto o selecciona una de su dispositivo.
Flujos de trabajo de seguros
Requiere prueba de seguro como una carga de PDF junto con el acuerdo de política firmado. Una experiencia de firma captura tanto el compromiso como la evidencia.
Aprobaciones de gastos
Adjunte imágenes de recibos a un informe de gastos firmado. Marque el campo del archivo como opcional si los recibos no siempre son necesarios, o requerido si su política los exige.
Cumplimiento e inspecciones
Recoge pruebas fotográficas (inspecciones de seguridad, informes sobre el estado de la propiedad) junto con el formulario de cumplimiento firmado. El archivo y la firma están vinculados a la misma solicitud de firma, por lo que no hay ambigüedad sobre a qué documento pertenecen las fotos.
En cada caso, la alternativa sin campos de carga de archivos es un proceso de múltiples pasos: firmar el documento, luego recopilar adjuntos por separado a través de correo electrónico, un creador de formularios o un enlace para compartir archivos. Eso es más trabajo de integración para ti y más fricción para el firmante.
Referencia de la API
El tipo de campo file está disponible en todos los lugares donde se definen campos: creación de solicitudes de firma (POST /signing-requests), creación de plantillas (POST /templates), y actualizaciones de campos a través de operaciones PATCH.
El esquema del campo sigue la misma estructura que otros tipos de campo, con la adición de format_rules para la configuración del tipo de archivo:
Los valores de acceptedFileTypes son image_and_pdf (por defecto), image o pdf. Si omite format_rules por completo, el campo predetermina a aceptar tanto imágenes como PDF.
Los campos de carga de archivos funcionan junto con todos los demás tipos de campos en la misma solicitud de firma. Puede combinarlos con firmas, iniciales, entradas de texto, casillas de verificación, etiquetas de anclaje y cualquier otro tipo de campo sin restricciones.
Vea el cambio de registro de la API para el esquema completo de FileFormatRules.
Por qué esto es importante

La Fricción Oculta Después de la Firma
La mayoría de las plataformas de firma electrónica tratan la recopilación de documentos como el problema de otra persona. Firmas el contrato en una herramienta, luego persigues los archivos adjuntos a través de correo electrónico, Slack u otro portal de carga. Cada transferencia es una oportunidad para la pérdida de interés, retrasos y archivos perdidos.
Todo en una respuesta de API
Firma.dev colapsa eso en un solo flujo. El firmante abre el documento, completa sus campos, carga sus archivos de respaldo y firma. Todo llega junto en una respuesta de API. Para los desarrolladores, eso significa menos integración de plomería y menos casos extremos. Para los firmantes, significa una cosa que hacer en lugar de dos.


Sin coste adicional
A €0.029 por sobre, agregar la colección de archivos a tu flujo de firma no cuesta extra. El campo de carga de archivos es solo otro tipo de campo, incluido en el mismo sobre.


