Note de 4,8 étoiles sur g2.com
PDF mis à jour ? Vous n'avez pas besoin de reconstruire votre modèle.
Si vous avez déjà géré des modèles de signature en production, vous avez rencontré ce problème. Un avocat met à jour une clause. Le service juridique envoie un PDF révisé. Votre modèle de NDA de 14 champs doit maintenant être reconstruit à partir de zéro : téléchargez à nouveau le document, remplacez chaque champ, réaffectez chaque signataire.
Pour un modèle, c'est une heure de travail. Pour dix modèles sur cinquante espaces de travail client, cela devient un vrai problème.
Le remplacement de document modèle le résout. Échangez le PDF sous-jacent sur n'importe quel modèle et chaque champ, affectation de signataire et paramètre reste exactement à sa place.
Le problème qu'il résout
Les modèles sont l'endroit où se trouve le véritable travail
Ils constatent souvent que l'accès à l'API est logique car ils paient déjà pour la plateforme. L'accès des développeurs à un contrat Enterprise existant est généralement négociable, et le travail juridique/approvisionnement est déjà fait.
Même structure. Même champs. Aucun moyen de les conserver... Jusqu'à présent.
Les déclencheurs sont courants : une correction de typo, une révision de clause, une en-tête rebrandée, une mise à jour de l'équipe juridique, un changement réglementaire. La structure du document reste la même, les pages restent les mêmes, les champs devraient rester les mêmes. Auparavant, il n'y avait aucun moyen de conserver ce travail. Maintenant, il y en a un.
Comment ça marche
Échangez le PDF. Gardez tout le reste.
Téléchargez un nouveau PDF. Firma.dev valide que le nombre de pages correspond à l'original et que les dimensions des pages sont dans une tolérance de 1pt. Si les deux vérifications sont réussies, le document est échangé instantanément. Chaque position de champ, chaque affectation de signataire, chaque paramètre de modèle reste inchangé.
Pourquoi les règles de validation existent
Les règles de validation ne sont pas des contraintes arbitraires, ce sont des garde-fous. Si le nombre de pages change ou si les dimensions changent de manière significative, les positions des champs dériveraient de la page ou atterriraient au mauvais endroit. La tolérance de 1pt couvre les petites différences de rendu entre les exports PDF à partir du même fichier source, tout en bloquant les remplacements qui désaligneraient vos champs.
Trois surfaces soutiennent le remplacement de document
Éditeur de modèle principal
Un bouton Remplacer le document dans l'en-tête du modèle. Téléchargez directement depuis l'interface utilisateur.
Éditeur intégré
Validation côté serveur via la fonction de bord avec authentification JWT. Fonctionne dans toute intégration intégrée.
API REST
POST /templates/{id}/replace-document
avec un PDF encodé en base64.
Utiliser l'API
Le point de terminaison est simple. Encodez votre PDF de remplacement en base64 et POSTez-le au modèle (Référence de l'API : https://docs.firma.dev/api-reference/v01.09.00/templates/replace-template-document)
La réponse est l'objet modèle mis à jour. Si la validation échoue, vous recevez un 400 avec une erreur claire indiquant si le problème est une différence de nombre de pages, une différence de dimension ou un PDF invalide.
Règles de validation
Les fichiers DOC et DOCX téléchargés via l'interface utilisateur sont automatiquement convertis en PDF avant validation. L'API accepte directement les PDF.
Vérifier
Exigence
Nombre de pages
Doit correspondre exactement à l'original
Dimensions de la page
Doit correspondre à une tolérance de 1 pt par page
Format de fichier
PDF encodé en Base64 via API ; PDF, DOC ou DOCX (jusqu'à 60 Mo) via UI
Pour qui c'est
Les équipes juridiques et de conformité itérant sur la langue des contrats
Lors de la mise à jour de vos accords standard, un appel API remplace désormais le document sur n'importe quel modèle sans perturber la configuration des champs.
Des plateformes SaaS gérant des modèles à travers les espaces de travail des clients
Refondre ou mettre à jour un document déployé sur des dizaines d'espaces de travail ne signifie plus des reconstructions manuelles pour chacun. Mettez à jour le modèle source et vous avez terminé.
Mises à jour de documents axées sur la conformité
Les industries réglementées ont parfois besoin de mises à jour de documents selon un calendrier. Remplacer le PDF sans perdre les emplacements des champs signifie que la mise à jour peut être automatisée, testée et déployée sans reprise humaine.
Le remplacement de documents modèles est disponible dans l'API v1.9.0 sans changements importants par rapport à v1.8.0.
