Téléversement des documents à signer
Téléversement des documents à signer
Comment préparer, téléverser et valider les contrats et pièces jointes d’une demande de signature
Gérez l’ajout de contrats et pièces jointes à une demande de signature : formats, contraintes, bonnes pratiques, et étapes claires pour l’upload via le SDK YouSign ou l’interface.
Couverture de cette page
Téléverser des documents
Ajouter un ou plusieurs documents à une demande de signature (document principal ou pièces jointes).
Gérer l’ordre et le type
Choisir la nature du fichier (document signable vs pièce jointe) et positionner l’ordre d’apparition.
Valider et remplacer
Vérifier la réussite des uploads, contrôler le parsing (ancres, pages) et remplacer un document si nécessaire (tant que la demande est en brouillon).
Téléversement via SDK
Procédure pas-à-pas pour envoyer les fichiers depuis votre environnement avec le SDK YouSign.
Pièces fournies par les signataires
Gérer les documents que les signataires peuvent uploader (ex. justificatifs demandés).
Contraintes & erreurs fréquentes
Liste des limitations usuelles et recommandations pour éviter les erreurs courantes.
Rappel important
Une demande de signature contient toujours des documents et des signataires. Il est obligatoire d’avoir au moins un document (signable) attaché à la demande avant de pouvoir l’activer. L’ajout de signataires et l’activation sont des étapes distinctes : vous pouvez préparer la demande (signataires, pièces, champs) puis activer une fois que tout est prêt.
Workflow 1 — Téléverser un document lors de la création d’une nouvelle demande (via SDK YouSign)
Étape 1 — Créer la demande en brouillon
Démarrer une nouvelle demande de signature en mode brouillon : donnez-lui un nom, configurez les options principales (mode de livraison, expiration, rappel). En brouillon, vous pouvez ajouter documents et signataires sans activer l’envoi.
Étape 2 — Préparer les fichiers
Rassembler les fichiers à téléverser. Bonnes pratiques : nom significatif, pages dans le bon ordre, retirer métadonnées sensibles, compresser si volumineux. Préférer les PDF pour les contrats (stabilité du rendu).
Étape 3 — Choisir la nature du document
Décider si chaque fichier est : 1) un document signable (contrat sur lequel on placera des champs de signature) ou 2) une pièce jointe (information complémentaire non signée). Cette distinction impacte le parcours de signature.
Étape 4 — Envoyer le fichier via le SDK
Depuis le SDK, téléversez le fichier en précisant :
- le fichier lui‑même (format, nom) ;
- la nature (signable_document ou attachment) ;
- options facultatives : mot de passe si le PDF est protégé, insertion après un document précis pour contrôler l’ordre, analyse d’ancres pour placement automatique des champs, paramètres d’initiales.
Attendre la réponse pour récupérer l’identifiant du document et les informations renvoyées (nombre de pages, checksum, indicateur de verrouillage).
Étape 5 — Vérifier l’état après upload
Contrôler que le fichier est bien reçu : vérifiez le nom, le type MIME, le nombre de pages, si le document est verrouillé (mot de passe) et le nombre d’ancres parsées. Ouvrir un aperçu PDF si possible.
Étape 6 — Associer le(s) document(s) à la demande
Associer les documents téléversés à la demande en brouillon. Confirmer qu’au moins un document signable est présent avant de passer à l’activation.
Étape 7 — Ajouter champs & signataires (préparation)
Placer les champs de signature/initiales/texte sur le document (manuellement ou via ancres). Ajouter signataires et leur attribuer les champs. Vous pouvez tout préparer avant activation.
Étape 8 — Activer (quand prêt)
Quand tout est validé (documents, champs, signataires), activer la demande pour envoyer les notifications. Rappel : activation impossible sans au moins un document signable attaché.
Astuce : commencer en brouillon
Préparez entièrement la demande en mode brouillon (ajout de documents, placement des champs, listes de signataires). Cela permet de vérifier et corriger sans déclencher d’envoi ou de notifications.
Workflow 2 — Ajouter un document à une demande existante (brouillon)
Étape 1 — Vérifier le statut de la demande
Assurez-vous que la demande est en statut « brouillon ». L’ajout et le remplacement de documents se font sans risque tant que la demande n’est pas activée.
Étape 2 — Préparer et sélectionner le fichier
Préparez le fichier (voir bonnes pratiques). Si l’ordre des documents importe, notez après quel document vous souhaitez l’insérer.
Étape 3 — Téléverser en indiquant l’ordre
Téléversez le document en choisissant la nature (signable/attachment) et éventuellement l’identifiant du document après lequel insérer pour contrôler l’ordre.
Étape 4 — Valider parsing & champs
Après upload, vérifiez si les ancres ont été détectées, si le nombre de pages est correct et adaptez ou repositionnez les champs si nécessaire.
Étape 5 — Sauvegarder et tester
Sauvegardez les modifications et générez une prévisualisation de la demande pour vérifier le rendu final avant activation.
Astuce : utilisation de l’option d’analyse d’ancres
Si vous utilisez des ancres dans vos documents (marques textuelles servant à positionner automatiquement des champs), activez l’analyse d’ancres lors de l’upload pour gagner du temps dans le placement des zones de signature.
Workflow 3 — Remplacer un document (corriger erreur avant activation)
Étape 1 — Confirmer que la demande est en brouillon
Le remplacement est recommandé uniquement en brouillon. Si la demande est déjà activée, le remplacement peut être restreint ou impossible ; préférez recréer une version ou annuler puis re-créer.
Étape 2 — Choisir le document à remplacer
Identifiez le document erroné (par son nom, nombre de pages ou id renvoyé après upload).
Étape 3 — Téléverser la nouvelle version en remplacement
Envoyez le nouveau fichier en indiquant que l’action est un remplacement. Conservez les mêmes paramètres (nature, options d’initiales) si besoin.
Étape 4 — Revalider champs & ancres
Certaines positions de champs peuvent se décaler après remplacement : vérifiez et repositionnez les champs si nécessaire, et contrôlez l’analyse d’ancres.
Étape 5 — Tester la prévisualisation
Téléchargez ou prévisualisez le document remplacé pour confirmer que le rendu et les champs sont corrects.
Attention — Remplacements et activation
Une fois la demande activée, le remplacement d’un document peut être impossible ou restreint. Si vous devez absolument modifier un document après activation, vérifiez le statut et la procédure adéquate (annulation, création d’une nouvelle demande ou contact du support si le service externe est indisponible).
Workflow 4 — Documents fournis par un signataire (demande de pièces jointes signées par le signataire)
Étape 1 — Créer une demande de documents pour signataire
Ajoutez une “demande de document” destinée à un signataire (ex. justificatif d’identité). Cette action est généralement possible en brouillon.
Étape 2 — Notifier ou associer le signataire
Associez la demande de document au signataire concerné ; il recevra l’invite de téléverser le fichier durant son parcours.
Étape 3 — Réception et vérification
Quand le signataire téléverse sa pièce, récupérez et vérifiez le document (format, lisibilité). Selon la configuration, le téléchargement du document uploadé par le signataire peut être possible uniquement après que le signataire ait signé.
Étape 4 — Conserver et archiver
Conservez la pièce jointe dans la demande et archivez conformément aux règles internes de conformité et confidentialité.
- Meilleure option pour automatiser et intégrer le téléversement dans vos processus.
- Permet de : uploader, indiquer la nature, insérer après un document, demander le parsing d’ancres, remplacer des documents en brouillon.
- Contrôles disponibles : réception d’un identifiant document, métadonnées (pages, checksum, verrouillage).
Avant : documents dispersés, manque de nomenclature, risque d’activer une demande incomplète.
Après : tous les documents sont centralisés dans la demande, nommés clairement, nature définie (signable/attachment), et vérifiés avant activation.
Risque lié au service externe
La disponibilité du service externe (YouSign) impacte les uploads et la validation. En cas d’indisponibilité, les opérations d’upload ou d’activation peuvent échouer — prévoyez des mécanismes de reprise (réessai, stockage temporaire, journalisation des erreurs).
Règle clé à retenir
Une demande de signature ne peut être activée sans au moins un document signable. Vérifiez la présence d’au moins un document de nature “signable” avant toute activation.
Bonnes pratiques pour les fichiers
- Préférez les PDF pour les contrats (garantit le rendu).
- Nommez les fichiers clairement (ex : Contrat_Offre_2026-03-23.pdf).
- Si le PDF est protégé par mot de passe, fournissez le mot de passe ou déverrouillez-le avant upload.
- Compressez les gros fichiers et fractionnez si nécessaire.
Checklist de validation après téléversement (contrôle qualité)
Vérifier le succès de l’upload
Confirmer la réception du document et récupérer l’identifiant renvoyé par le service.
Contrôler le rendu
Télécharger ou prévisualiser le document : pages correctement affichées, pas de corruption.
Vérifier les métadonnées
Vérifier type MIME, nombre de pages, indicateur de verrouillage et checksum si disponible.
Vérifier le parsing d’ancres (si utilisé)
S’assurer que les ancres présentes ont bien été détectées et que les champs se placent au bon endroit.
Tester le parcours signataire en prévisualisation
Simuler le parcours signataire (aperçu). Vérifier que chaque signataire voit ses champs et qu’il peut télécharger/visualiser les pièces attendues.
Sauvegarder et documenter
Consigner l’action (qui a uploadé quoi et quand) pour traçabilité et conformité.
Préparer la traçabilité
Conservez un log ou un enregistrement (nom utilisateur, horodatage, id document) à chaque téléversement pour faciliter les audits et la gestion des litiges.
Frequently Asked Questions
Besoin d’aide supplémentaire ?
Si vous rencontrez des erreurs d’upload récurrentes, des problèmes de parsing ou d’activation, contactez l’équipe support avec les identifiants de la demande et des documents concernés pour un diagnostic.