
Note de 4,8 étoiles sur g2.com

La collecte de documents ne devrait pas être un flux de travail séparé
Champs de téléversement de fichiers : Tout en un seul endroit, un appel API
Les champs de téléchargement de fichiers de Firma.dev vous permettent de collecter des documents justificatifs directement dans le flux de signature. Les signataires peuvent télécharger des images ou des PDF directement à côté de leur signature, de leurs initiales et d'autres champs de formulaire. Une expérience, un appel d'API, tout en un seul endroit.
Les champs de téléchargement de fichiers ont été livrés en version v1.11.0 et sont disponibles sur tous les comptes.
Quels sont les champs de téléchargement de fichiers ?

Placer et configurer les champs d'importation de fichiers
Le type de champ file fonctionne comme n'importe quel autre champ dans Firma.dev. Vous le placez sur un document, vous l'assignez à un destinataire, et vous le marquez comme obligatoire ou facultatif.
Lorsque le signataire ouvre le document, il voit une zone de téléchargement où il peut joindre un fichier.
Types de fichiers acceptés
La différence réside dans ce qu'il collecte. Au lieu de capturer une signature ou une saisie de texte, un champ de fichier accepte les téléchargements d'images (JPG, PNG) et les fichiers PDF. Le signataire choisit un fichier depuis son appareil, Firma.dev le valide côté serveur, et la pièce jointe devient partie intégrante de la demande de signature complétée.


tout en une soumission
Cela signifie que vous pouvez créer des flux de travail où l'accord signé et sa documentation de support arrivent ensemble, et non pas comme des soumissions séparées à plusieurs jours d'intervalle.
Comment ça fonctionne
Chaque champ de téléchargement de fichier a un objet format_rules qui contrôle quels types de fichiers sont acceptés. Il existe trois modes :
image_et_pdf
Accepte à la fois les images (JPG, PNG) et les fichiers PDF. C'est la valeur par défaut.
image
Accepte uniquement les JPG et PNG.
pdf
N'accepte que les fichiers PDF.
La taille de fichier maximale est de 10MB par téléchargement. Les fichiers sont traités côté serveur via des fonctions de bord, non stockés côté client.
Voici comment ajouter un champ de téléchargement de fichier à une demande de signature :
Cela crée une demande de signature avec un champ de signature et un champ de téléchargement de fichier sur la même page. Le champ de fichier est configuré pour accepter uniquement les images, ce qui est logique pour quelque chose comme une photo d'identité.

Validation de l'octet magique
Firma.dev valide les fichiers téléchargés en inspectant leur contenu réel (octets magiques), et non pas seulement l'extension du fichier. Si quelqu'un renomme un .exe en .jpg et essaie de le télécharger, la validation le détecte.
Il s'agit d'une couche de sécurité significative que la plupart des plates-formes de signature électronique négligent, se fiant plutôt à des vérifications basées sur l'extension qui sont faciles à contourner.
La validation se fait côté serveur avant que le fichier ne soit accepté, donc les fichiers invalides n'entrent jamais dans les données de votre demande de signature.
Cas d'utilisation
Les champs de téléchargement de fichiers sont utiles partout où vous avez besoin de documentation supplémentaire à côté d'un accord signé.
Intégration des employés
Collectez une lettre d'offre signée et une photo de la pièce d'identité émise par le gouvernement du nouvel employé dans le même flux. Réglez acceptedFileTypes sur image pour le champ de téléchargement d'identité, et le signataire prend une photo ou en sélectionne une depuis son appareil.
Flux de travail d'assurance
Exiger une preuve d'assurance sous forme de PDF téléchargeable en même temps que l'accord de police signé. Une seule expérience de signature capture à la fois l'engagement et la preuve.
Approbations des dépenses
Joindre des images de reçus à un rapport de dépenses signé. Marquez le champ de fichier comme facultatif si les reçus ne sont pas toujours requis, ou obligatoire si votre politique l'exige.
Conformité et inspections
Collectez des preuves photographiques (inspections de sécurité, rapports d'état des propriétés) avec le formulaire de conformité signé. Le fichier et la signature sont liés à la même demande de signature, donc il n'y a aucune ambiguïté quant au document auquel les photos appartiennent.
Dans chaque cas, l'alternative sans champs de téléchargement de fichiers est un processus en plusieurs étapes : signez le document, puis collectez séparément les pièces jointes par email, un créateur de formulaires ou un lien de partage de fichiers. Cela représente plus de travail d'intégration pour vous et plus de friction pour le signataire.
Référence API
Le type de champ file est disponible partout où des champs sont définis : création de demande de signature (POST /signing-requests), création de modèle (POST /templates), et mises à jour de champ via les opérations PATCH.
Le schéma de champ suit la même structure que les autres types de champ, avec l'ajout de format_rules pour la configuration du type de fichier :
Les valeurs de acceptedFileTypes sont image_and_pdf (par défaut), image, ou pdf. Si vous omettez entièrement format_rules, le champ acceptera par défaut à la fois les images et les fichiers PDF.
Les champs de téléversement de fichiers fonctionnent avec tous les autres types de champs dans la même demande de signature. Vous pouvez les combiner avec des signatures, des initiales, des saisies de texte, des cases à cocher, des balises d'ancrage, et tout autre type de champ sans restrictions.
Voir le changelog de l'API pour le schéma complet de FileFormatRules.
Pourquoi cela importe

La friction cachée après la signature
La plupart des plateformes d'e-signature considèrent la collecte des documents comme le problème de quelqu'un d'autre. Vous signez le contrat dans un outil, puis vous cherchez à récupérer les pièces jointes par email, Slack, ou un portail de téléchargement séparé. Chaque transfert est une opportunité de perte, de retards et de fichiers perdus.
Tout dans une réponse API
Firma.dev consolide cela en un seul flux. Le signataire ouvre le document, remplit ses champs, télécharge ses fichiers de support et signe. Tout arrive ensemble dans une seule réponse API. Pour les développeurs, cela signifie moins de plomberie d'intégration et moins de cas marginaux. Pour les signataires, cela signifie une seule chose à faire au lieu de deux.


Sans coût supplémentaire
À €0,029 par enveloppe, ajouter la collecte de fichiers à votre flux de signature ne coûte pas plus cher. Le champ de téléchargement de fichier est juste un autre type de champ, inclus dans la même enveloppe.


