Mankomail

Yousign ​

Fait signer électroniquement une pièce jointe reçue par mail : demande, document, signataires, activation, puis récupération du document signé et du dossier de preuve. ⚠ L’activation est facturée par Yousign.

Le nœud Yousign fait signer électroniquement un document et en récupère le résultat. Il couvre tout le parcours : créer une demande de signature, y téléverser une pièce jointe du mail, ajouter les signataires et leur champ de signature, activer la demande (ce qui envoie les invitations), puis, une fois signée, rapatrier le document signé et le dossier de preuve dans l’exécution.

Il travaille avec une clé d’API Yousign enregistrée une fois dans Connexions ; la connexion fixe aussi l’environnement (bac à sable ou production) : un workflow ne change jamais d’environnement de lui-même. Voir Yousign pour la créer. Pour réagir quand une demande est signée, refusée ou expirée, utilisez le déclencheur Yousign — événement.

Un workflow d’envoi typique enchaîne quatre nœuds Yousign : Demande de signature · Créer un brouillon, Document · Téléverser une pièce jointe du mail, Signataire · Ajouter un signataire, Demande de signature · Activer. Le workflow de réception démarre sur le déclencheur et enchaîne Document · Télécharger le document signé et Télécharger le dossier de preuve.

En bref ​

  • Type : yousign.api · version 1
  • Catégorie : Actions
  • Nature : Étape — s’exécute pendant une exécution
  • Effet : Écrit à l’extérieur (external_write) — écrit hors de Mankomail ; décrit au lieu d’être fait pendant un essai
  • Exige un mail porteur : Non
  • Connexion : Yousign
  • Entrées : main
  • Sorties : main

Connexion ​

Ce nœud exige une connexion Yousign.

Paramètres ​

connection ​

Connexion Yousign — La connexion Yousign à employer. Elle se crée une fois dans Connexions ; sa clé n’apparaît jamais dans le workflow.

  • Type : Connexion (credential)
  • Requis : Oui
  • Défaut : "" (vide)

resource ​

Ressource

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : signatureRequest
  • Options :
    • signatureRequest — Demande de signature : Le dossier : on le crée, on l’active (c’est l’envoi), on le suit, on l’annule.
    • document — Document : Téléverser une pièce jointe du mail, ou récupérer le document signé et le dossier de preuve.
    • signer — Signataire : Qui signe, à quel niveau, et où sa signature se pose sur la page.
    • approver — Approbateur : Valide la demande avant que les signataires soient sollicités, sans signer.
    • follower — Suiveur : Reçoit une copie du document signé, sans rien avoir à faire.
    • template — Modèle : Lister les modèles actifs préparés dans l’application Yousign.
    • contact — Contact : Lister le carnet d’adresses Yousign.
    • user — Utilisateur : Lister les membres de l’organisation Yousign.
    • workspace — Espace de travail : Lister les espaces de travail.
    • webhook — Abonnement webhook : Lister, créer ou supprimer un abonnement — ce qui alimente le déclencheur.

signatureRequestOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : create
  • Options :
    • create — Créer un brouillon : Rien n’est envoyé : la demande naît en brouillon, prête à recevoir documents et signataires.
    • createFromTemplate — Créer depuis un modèle : Documents et champs viennent du modèle ; il ne reste qu’à remplir les emplacements.
    • get — Obtenir une demande : Son statut, ses documents, ses signataires et leurs liens de signature.
    • list — Lister les demandes : Filtrables par statut, par origine et par identifiant externe.
    • activate — Activer — ⚠ envoie les e-mails et déclenche la facturation : Yousign compte un crédit par signataire invité, au moment de l’activation, qu’il signe ou non. Cette opération demande une confirmation explicite.
    • cancel — Annuler : Possible seulement sur une demande en approbation ou en cours. Définitif : une demande annulée ne se réactive jamais.
    • reactivate — Relancer une demande expirée : Redonne vie à une demande expirée, avec une nouvelle date d’expiration obligatoire.
    • delete — Supprimer : Impossible en approbation ou en cours. Par défaut, la demande va à la corbeille et reste restaurable.
  • Affiché quand : resource vaut signatureRequest

documentOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : upload
  • Options :
    • upload — Téléverser une pièce jointe du mail : Les octets partent en multipart/form-data — Yousign refuse le base64 — et ne traversent jamais le workflow.
    • list — Lister les documents : Leur nom, leur nature, leur nombre de pages et leur empreinte SHA-256.
    • downloadSigned — Télécharger le document signé : La version completed, disponible une fois la demande terminée. Un seul document signable ⇒ un PDF, plusieurs ⇒ un ZIP.
    • downloadAuditTrail — Télécharger le dossier de preuve : Les pistes d’audit de tous les signataires, fusionnées en un PDF — la pièce à conserver dix ans.
  • Affiché quand : resource vaut document

signerOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : create
  • Options :
    • create — Ajouter un signataire : Avec son niveau de signature et son champ de signature — sans champ, l’activation échoue.
    • get — Obtenir un signataire : Son statut et son lien de signature, à relayer soi-même en mode « aucun envoi ».
    • list — Lister les signataires
    • remind — Relancer un signataire : Renvoie l’invitation à ce signataire-là. Aucune facturation : le crédit a déjà été compté à l’activation.
  • Affiché quand : resource vaut signer

approverOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : create
  • Options :
    • create — Ajouter un approbateur : Uniquement tant que la demande est en brouillon. Dix approbateurs au plus.
    • list — Lister les approbateurs
  • Affiché quand : resource vaut approver

followerOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : create
  • Options :
    • create — Ajouter des suiveurs : Une ou plusieurs adresses, séparées par des virgules. Cent au plus.
    • list — Lister les suiveurs
  • Affiché quand : resource vaut follower

webhookOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : list
  • Options :
    • list — Lister les abonnements : Leur description et leur URL. La clé de signature n’est jamais rendue par le nœud.
    • create — Créer un abonnement : Les webhooks sont un domaine partagé chez Yousign : il faut une clé de production pour en créer un par API, même pour écouter le bac à sable.
    • delete — Supprimer un abonnement
  • Affiché quand : resource vaut webhook

signatureRequest ​

Demande de signature — La demande visée. En mode identifiant, {{ data.creer_la_demande.signatureRequestId }} reprend celle créée plus haut par l’étape « Créer la demande » ; depuis le déclencheur Yousign, c’est {{ data.yousign.data.signature_request.id }}.

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant, coller une URL (yousign.signatureRequest)
  • Listé avec la connexion de : connection
  • Affiché quand : (resource vaut signatureRequest et signatureRequestOperation vaut l’une de get, activate, cancel, reactivate, delete) ou resource vaut document ou resource vaut signer ou resource vaut approver ou resource vaut follower

name ​

Nom de la demande — Ce que les destinataires voient en objet. 128 caractères au plus.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 128 caractères au plus
  • Exemple : {{ email.subject }}
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate
  • Expressions : {{ }} accepté

template ​

Modèle — Seuls les modèles actifs sont proposés : un modèle en brouillon fait échouer la création.

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (yousign.template)
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut createFromTemplate

templateSigners ​

Signataires du modèle — Un emplacement par ligne. L’étiquette est celle du modèle, et elle est sensible à la casse : « Client » ≠ « client ». Tous les emplacements doivent être remplis.

  • Type : Liste d’éléments (collection)
  • Requis : Non
  • Au plus 20 éléments
  • Chaque élément a :
    • label — Étiquette du modèle
      • Type : Texte (string)
      • Requis : Oui
      • Défaut : "" (vide)
      • 128 caractères au plus
    • firstName — Prénom
      • Type : Texte (string)
      • Requis : Non
      • Défaut : "" (vide)
      • 100 caractères au plus
    • lastName — Nom
      • Type : Texte (string)
      • Requis : Non
      • Défaut : "" (vide)
      • 100 caractères au plus
    • email — Adresse e-mail
      • Type : Texte (string)
      • Requis : Non
      • Défaut : "" (vide)
      • 100 caractères au plus
    • locale — Langue
      • Type : Un choix (options)
      • Requis : Non
      • Défaut : fr
      • Options :
        • en — en
        • fr — fr
        • de — de
        • it — it
        • nl — nl
        • es — es
        • pl — pl
        • pt — pt
        • ro — ro
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut createFromTemplate

templateTexts ​

Textes du modèle — Les champs « texte en lecture seule » du modèle : l’étiquette en clé, le texte en valeur.

  • Type : Paires clé / valeur (keyValue)
  • Requis : Non
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut createFromTemplate
  • Expressions : {{ }} accepté

deliveryMode ​

Envoi des invitations

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : email
  • Options :
    • email — Yousign envoie les e-mails : Le cas courant : chaque destinataire reçoit son invitation et ses relances.
    • none — Aucun envoi — je relaie le lien : L’activation rend alors signature_link pour chaque signataire. ⚠ Il expire en 48 heures.
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate

orderedSigners ​

Signature séquentielle — Chaque signataire n’est sollicité qu’après le précédent. Obligatoire pour la signature qualifiée.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : false
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate

signersAllowedToDecline ​

Autoriser le refus de signer — Le refus devient une réponse traçable plutôt qu’un silence : la demande passe en « refusée » et l’événement part au déclencheur.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : true
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate

expirationDate ​

Date d’expiration — Au format AAAA-MM-JJ. Vide à la création = six mois. Jamais plus d’un an, jamais dans le passé. Obligatoire pour relancer une demande expirée.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 10 caractères au plus
  • Exemple : 2026-10-31
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate, reactivate
  • Expressions : {{ }} accepté

externalId ​

Identifiant externe — 🔴 La clé d’idempotence. Laissé vide, le nœud en dérive une de l’étape : une nouvelle tentative retrouve alors la demande déjà créée au lieu d’en créer une seconde. Rempli, c’est votre référence de dossier — elle revient dans les webhooks.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 255 caractères au plus
  • Exemple : dossier-2026-0412
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate
  • Expressions : {{ }} accepté

timezone ​

Fuseau horaire — Nom IANA (Europe/Paris). Vide = le réglage de l’organisation Yousign.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 64 caractères au plus
  • Exemple : Europe/Paris
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate
  • Expressions : {{ }} accepté

auditTrailLocale ​

Langue du dossier de preuve

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : fr
  • Options :
    • de — de
    • en — en
    • es — es
    • fr — fr
    • it — it
    • pt — pt
    • ro — ro
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate

workspace ​

Espace de travail — Vide = l’espace par défaut. ⚠ À ne pas remplir quand le modèle est déjà rattaché à un espace : Yousign refuse la discordance.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant (yousign.workspace)
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate

reminderInterval ​

Relances automatiques

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : 0
  • Options :
    • 0 — Aucune
    • 1 — Tous les jours
    • 2 — Tous les deux jours
    • 7 — Toutes les semaines
    • 14 — Toutes les deux semaines
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate

reminderMaxOccurrences ​

Nombre de relances

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 3
  • Nombre entier, de 1 à 10
  • Affiché quand : (resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate) et reminderInterval ne vaut pas 0

emailSubject ​

Objet de l’invitation — Remplace l’objet par défaut de Yousign. Vide = celui de Yousign.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 255 caractères au plus
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate
  • Expressions : {{ }} accepté

emailBody ​

Message de l’invitation

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 2000 caractères au plus
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut l’une de create, createFromTemplate
  • Expressions : {{ }} accepté

confirmBilling ​

Je confirme que cette activation est facturée — Yousign compte un crédit par signataire invité, au moment de l’activation, qu’il signe ou non. Sans cette case, le nœud refuse d’activer.

  • Type : Oui / non (boolean)
  • Requis : Oui
  • Défaut : false
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut activate

sender ​

Expéditeur — L’utilisateur Yousign au nom de qui l’invitation part. Vide = le propriétaire de la clé d’API.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant (yousign.user)
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut activate

cancelReason ​

Motif d’annulation

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : errors_in_document
  • Options :
    • errors_in_document — Erreur dans le document
    • contractualization_aborted — Contractualisation abandonnée
    • other — Autre
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut cancel

cancelNote ​

Précision — Communiquée aux destinataires. 500 caractères au plus.

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 500 caractères au plus
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut cancel
  • Expressions : {{ }} accepté

permanentDelete ​

Suppression définitive — Décoché, la demande va à la corbeille et reste restaurable. Coché, elle disparaît — c’est irréversible.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : false
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut delete

statuses ​

Statuts — Rien de coché = tous les statuts.

  • Type : Plusieurs choix (multiOptions)
  • Requis : Non
  • Défaut : []
  • Options :
    • draft — draft
    • approval — approval
    • ongoing — ongoing
    • done — done
    • paused — paused
    • declined — declined
    • rejected — rejected
    • expired — expired
    • canceled — canceled
    • deleted — deleted
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut list

sources ​

Origine des demandes — 🔴 Yousign ne rend que les demandes créées par API quand on ne dit rien. Les deux cases cochées, on voit aussi celles préparées dans l’application.

  • Type : Plusieurs choix (multiOptions)
  • Requis : Non
  • Défaut : ["public_api","app"]
  • Options :
    • public_api — Créées par API
    • app — Créées dans l’application
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut list

query ​

Recherche — Recherche plein texte sur le nom de la demande, faite par Yousign.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut list
  • Expressions : {{ }} accepté

externalIdFilter ​

Identifiant externe exact — Retrouve la demande d’un dossier précis — c’est la lecture inverse de la clé d’idempotence.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 255 caractères au plus
  • Affiché quand : resource vaut signatureRequest et signatureRequestOperation vaut list
  • Expressions : {{ }} accepté

limit ​

Nombre maximum

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 50
  • Nombre entier, de 1 à 200
  • Affiché quand : (resource vaut signatureRequest et signatureRequestOperation vaut list) ou (resource vaut document et documentOperation vaut list) ou (resource vaut signer et signerOperation vaut list) ou (resource vaut approver et approverOperation vaut list) ou (resource vaut follower et followerOperation vaut list) ou resource vaut template ou resource vaut contact ou resource vaut user ou resource vaut workspace ou (resource vaut webhook et webhookOperation vaut list)

documentNature ​

Nature du document

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : signable_document
  • Options :
    • signable_document — Document à signer : PDF ou DOCX. Une image ne peut pas être signable.
    • attachment — Pièce jointe informative : Jointe au dossier sans être signée. PDF, DOCX, JPEG ou PNG.
  • Affiché quand : resource vaut document et documentOperation vaut upload

selection ​

Pièces jointes retenues

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : all
  • Options :
    • all — Toutes les pièces jointes : Celles du mail déclencheur, puis les fichiers ajoutés par les étapes précédentes (un acte rapatrié, un PDF signé), dans cet ordre.
    • first — La première seulement : La première PJ, quand on sait qu’il n’y en a qu’une qui compte.
    • byMime — Par type de fichier : Par type MIME : application/pdf, ou toute une famille avec image/*.
    • byName — Par nom de fichier : Par motif sur le nom : *.pdf, facture-*.
  • Affiché quand : resource vaut document et documentOperation vaut upload

mime ​

Type de fichier — Type MIME exact (application/pdf) ou famille entière (image/*). Laissé vide, aucune PJ n’est retenue.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : application/pdf
  • Affiché quand : (resource vaut document et documentOperation vaut upload) et selection vaut byMime
  • Expressions : {{ }} accepté

namePattern ​

Nom du fichier — Motif simple : * remplace n’importe quoi, ? un caractère (*.pdf, facture-*). La casse est ignorée.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : *.pdf
  • Affiché quand : (resource vaut document et documentOperation vaut upload) et selection vaut byName
  • Expressions : {{ }} accepté

documentName ​

Renommer le document — Vide = le nom de la pièce jointe. Ni / ni \, pas d’espace en début ou en fin.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 128 caractères au plus
  • Affiché quand : resource vaut document et documentOperation vaut upload
  • Expressions : {{ }} accepté

parseAnchors ​

Détecter les Smart Anchors — Cherche les balises {{s1|signature|85|37}} écrites en blanc dans le PDF. ⚠ Échec silencieux : aucune erreur si les critères ne sont pas remplis — le nœud rend anchors pour que vous puissiez le vérifier.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : false
  • Affiché quand : resource vaut document et documentOperation vaut upload

downloadVersion ​

Version à télécharger

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : completed
  • Options :
    • completed — Signée (demande terminée) : Disponible seulement quand la demande est au statut « terminée ».
    • current — En l’état : Le document tel qu’il est aujourd’hui, signatures en cours comprises.
  • Affiché quand : resource vaut document et documentOperation vaut downloadSigned

mergeAuditTrails ​

Fusionner les pistes d’audit — Coché : un seul PDF. Décoché : une archive ZIP, un fichier par signataire.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : true
  • Affiché quand : resource vaut document et documentOperation vaut downloadAuditTrail

maxDownloadMb ​

Taille maximale (Mo)

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 10
  • Nombre entier, de 1 à 10
  • Affiché quand : resource vaut document et documentOperation vaut l’une de downloadSigned, downloadAuditTrail

includeContent ​

Inclure le contenu encodé — Décoché (recommandé) : le fichier est déposé dans les pièces jointes de l’exécution et un « Composer un mail » peut le joindre par sa position. Coché : il est en plus rendu en base64 dans les données de l’étape, ce qui les alourdit d’autant à chaque relecture.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : false
  • Affiché quand : resource vaut document et documentOperation vaut l’une de downloadSigned, downloadAuditTrail

signer ​

Signataire

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (yousign.signer)
  • Listé à l’intérieur de : signatureRequest
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut signer et signerOperation vaut l’une de get, remind

signerSource ​

Qui signe ?

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : info
  • Options :
    • info — Une personne saisie ici : Le cas courant : les coordonnées viennent du mail ou d’une extraction.
    • contact — Un contact du carnet Yousign
    • user — Un membre de l’organisation
  • Affiché quand : resource vaut signer et signerOperation vaut create

signerFirstName ​

Prénom

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 100 caractères au plus
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et signerSource vaut info
  • Expressions : {{ }} accepté

signerLastName ​

Nom

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 100 caractères au plus
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et signerSource vaut info
  • Expressions : {{ }} accepté

signerEmail ​

Adresse e-mail — 100 caractères au plus — c’est la limite de Yousign, pas la nôtre.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 100 caractères au plus
  • Exemple : {{ email.from.email }}
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et signerSource vaut info
  • Expressions : {{ }} accepté

signerPhone ​

Téléphone — Au format international (+33612345678). Obligatoire dès que l’authentification passe par SMS, et donc pour toute signature avancée.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 20 caractères au plus
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et signerSource vaut info
  • Expressions : {{ }} accepté

signerLocale ​

Langue du signataire

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : fr
  • Options :
    • en — en
    • fr — fr
    • de — de
    • it — it
    • nl — nl
    • es — es
    • pl — pl
    • pt — pt
    • ro — ro
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et signerSource vaut info

signerContact ​

Contact — ⚠ Un contact restreint à un espace de travail ne peut pas signer une demande d’un autre espace.

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (yousign.contact)
  • Listé avec la connexion de : connection
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et signerSource vaut contact

signerUser ​

Membre de l’organisation

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (yousign.user)
  • Listé avec la connexion de : connection
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et signerSource vaut user

signatureLevel ​

Niveau de signature

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : electronic_signature
  • Options :
    • electronic_signature — Simple (SES) : Le niveau courant, disponible d’emblée. Authentification sans code, par e-mail ou par SMS.
    • advanced_electronic_signature — Avancée (AES) : Vérification d’une pièce d’identité. ⚠ Code par SMS obligatoire, et niveau à activer par le support Yousign.
    • qualified_electronic_signature — Qualifiée (QES) : Pièce d’identité et vidéo vérifiée par un humain. ⚠ Exige la signature séquentielle, le même niveau pour tous les signataires, et une activation par le support.
  • Affiché quand : resource vaut signer et signerOperation vaut create

authenticationMode ​

Authentification

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : otp_email
  • Options :
    • otp_email — Code par e-mail
    • otp_sms — Code par SMS
    • no_otp — Aucun code
    • none — Sans objet (signature qualifiée) : La signature qualifiée n’accepte aucun code : l’identité est déjà vérifiée par vidéo.
  • Affiché quand : resource vaut signer et signerOperation vaut create

fieldMode ​

Champ de signature — 🔴 Chaque signataire doit avoir au moins un champ, sinon l’activation échoue.

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : coordinates
  • Options :
    • coordinates — À des coordonnées : Origine en haut à gauche de la page, en points. Une page A4 fait environ 596 × 842.
    • smartAnchors — Par Smart Anchors : Les balises du PDF placent les champs à l’activation. Le document doit avoir été téléversé avec la détection activée.
    • none — Aucun (le modèle les porte) : À réserver aux demandes créées depuis un modèle, où les champs existent déjà.
  • Affiché quand : resource vaut signer et signerOperation vaut create

fieldDocument ​

Document à signer — En mode identifiant, {{ data.api_1.documentId }} reprend celui téléversé juste avant par l’étape « Téléverser ».

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (yousign.document)
  • Listé à l’intérieur de : signatureRequest
  • Listé avec la connexion de : connection
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et fieldMode vaut coordinates

fieldPage ​

Page

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 1
  • Nombre entier, de 1 à 2000
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et fieldMode vaut coordinates

fieldX ​

X (points depuis la gauche)

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 100
  • Nombre entier, de 0 à 32767
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et fieldMode vaut coordinates

fieldY ​

Y (points depuis le haut)

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 650
  • Nombre entier, de 0 à 32767
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et fieldMode vaut coordinates

fieldWidth ​

Largeur

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 85
  • Nombre entier, de 85 à 2000
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et fieldMode vaut coordinates

fieldHeight ​

Hauteur

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 37
  • Nombre entier, de 37 à 1000
  • Affiché quand : (resource vaut signer et signerOperation vaut create) et fieldMode vaut coordinates

approverUser ​

Approbateur interne — Un membre de l’organisation Yousign. Laissé vide, ce sont les coordonnées saisies ci-dessous qui sont employées.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant (yousign.user)
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut approver et approverOperation vaut create

approverFirstName ​

Prénom

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 100 caractères au plus
  • Affiché quand : resource vaut approver et approverOperation vaut create
  • Expressions : {{ }} accepté

approverLastName ​

Nom

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 100 caractères au plus
  • Affiché quand : resource vaut approver et approverOperation vaut create
  • Expressions : {{ }} accepté

approverEmail ​

Adresse e-mail

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 100 caractères au plus
  • Affiché quand : resource vaut approver et approverOperation vaut create
  • Expressions : {{ }} accepté

approverLocale ​

Langue

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : fr
  • Options :
    • en — en
    • fr — fr
    • de — de
    • it — it
    • nl — nl
    • es — es
    • pl — pl
    • pt — pt
    • ro — ro
  • Affiché quand : resource vaut approver et approverOperation vaut create

followerEmails ​

Adresses des suiveurs — Séparées par des virgules. Elles reçoivent une copie du document signé, sans rien avoir à faire.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 2000 caractères au plus
  • Exemple : secretariat@cabinet.fr, compta@cabinet.fr
  • Affiché quand : resource vaut follower et followerOperation vaut create
  • Expressions : {{ }} accepté

followerLocale ​

Langue

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : fr
  • Options :
    • en — en
    • fr — fr
    • de — de
    • it — it
    • nl — nl
    • es — es
    • pl — pl
    • pt — pt
    • ro — ro
  • Affiché quand : resource vaut follower et followerOperation vaut create

webhook ​

Abonnement

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (yousign.webhook)
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut webhook et webhookOperation vaut delete

webhookEndpoint ​

URL de destination — Obligatoirement en HTTPS, publique, et hors réseau privé. C’est l’URL absolue du déclencheur, à copier depuis la fiche du nœud « Yousign — événement » (affichée après publication).

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 1024 caractères au plus
  • Affiché quand : resource vaut webhook et webhookOperation vaut create
  • Expressions : {{ }} accepté

webhookDescription ​

Description

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 128 caractères au plus
  • Affiché quand : resource vaut webhook et webhookOperation vaut create
  • Expressions : {{ }} accepté

webhookSandbox ​

Écouter le bac à sable — Les webhooks sont partagés entre les deux environnements : c’est cette case, et non la connexion, qui décide de ce qu’on écoute.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : true
  • Affiché quand : resource vaut webhook et webhookOperation vaut create

webhookEvents ​

Événements souscrits — Rien de coché = tous les événements existants au moment de la création.

  • Type : Plusieurs choix (multiOptions)
  • Requis : Non
  • Défaut : ["signature_request.done"]
  • Options :
    • signature_request.activated — signature_request.activated
    • signature_request.done — signature_request.done
    • signature_request.declined — signature_request.declined
    • signature_request.rejected — signature_request.rejected
    • signature_request.expired — signature_request.expired
    • signature_request.canceled — signature_request.canceled
    • signature_request.approved — signature_request.approved
    • signature_request.reminder_executed — signature_request.reminder_executed
    • signer.notified — signer.notified
    • signer.link_opened — signer.link_opened
    • signer.done — signer.done
    • signer.declined — signer.declined
    • signer.error — signer.error
    • signer.notification_delivery_failed — signer.notification_delivery_failed
    • approver.approved — approver.approved
    • approver.rejected — approver.rejected
    • contact.created — contact.created
  • Affiché quand : resource vaut webhook et webhookOperation vaut create

webhookScopes ​

Origines écoutées

  • Type : Plusieurs choix (multiOptions)
  • Requis : Non
  • Défaut : ["public_api","app"]
  • Options :
    • public_api — Créées par API
    • app — Créées dans l’application
  • Affiché quand : resource vaut webhook et webhookOperation vaut create

webhookAutoRetry ​

Renvoi automatique — Yousign renvoie les livraisons échouées pendant environ quatre jours. À laisser coché : c’est ce qui absorbe un redémarrage.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : true
  • Affiché quand : resource vaut webhook et webhookOperation vaut create

Sorties ​

  • main — Empruntée une fois l’opération Yousign réussie. Une réponse d’erreur de Yousign fait échouer l’étape à la place.

Données produites ​

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

  • {{ data.<step>.signatureRequestId }} — string. L’identifiant de la demande de signature concernée (pour Lister les demandes, la première rendue). Vide en essai après une création.
  • {{ data.<step>.signatureRequest }} — { id, name, status, source, externalId, deliveryMode, createdAt, expirationDate, workspaceId }. Créer un brouillon, Créer depuis un modèle, Obtenir une demande, Activer, Relancer une demande expirée : la demande de signature.
  • {{ data.<step>.status }} — string. Mêmes opérations : le statut de la demande (draft, approval, ongoing, done, declined, expired…).
  • {{ data.<step>.externalId }} — string. Mêmes opérations : l’identifiant externe de la demande, la clé d’idempotence décrite plus bas.
  • {{ data.<step>.reused }} — boolean. Créer un brouillon et Créer depuis un modèle : true quand une demande portant le même identifiant externe existait déjà et a été rendue au lieu d’en créer une seconde.
  • {{ data.<step>.documents }} — array of { id, filename, nature, contentType, sha256, totalPages, anchors, signed }. Obtenir une demande, Téléverser une pièce jointe du mail, Lister les documents : les documents de la demande. nature vaut signable_document ou attachment, anchors est le nombre de Smart Anchors détectées.
  • {{ data.<step>.signers }} — array of { id, status, firstName, lastName, email, signatureLevel, signatureLink, signatureLinkExpiresAt }. Obtenir une demande, Activer, Lister les signataires : les signataires. signatureLink n’est rempli qu’en mode « aucun envoi », après l’activation.
  • {{ data.<step>.signatureLink }} — string. Obtenir une demande, Activer, Obtenir un signataire : le lien de signature du premier signataire (ou du signataire lu). Rempli seulement en mode « aucun envoi » ; il expire en 48 heures.
  • {{ data.<step>.signatureRequests }} — array of { id, name, status, source, externalId, deliveryMode, createdAt, expirationDate, workspaceId }. Lister les demandes seulement : les demandes trouvées.
  • {{ data.<step>.count }} — number. Le nombre d’éléments rendus ou écrits : demandes, documents, signataires, approbateurs, suiveurs, modèles, contacts, utilisateurs, espaces de travail, abonnements.
  • {{ data.<step>.truncated }} — boolean. Listes (sauf Lister les abonnements) : true quand il existait plus d’éléments que le Nombre maximum ne le permettait.
  • {{ data.<step>.activated }} — boolean. Activer seulement : true quand la demande a été activée par cette étape. False quand elle était déjà active, et en essai.
  • {{ data.<step>.alreadyActive }} — boolean. Activer seulement : true quand la demande avait déjà quitté l’état de brouillon : rien n’a été renvoyé ni refacturé.
  • {{ data.<step>.billedSigners }} — number. Activer seulement : le nombre de signataires invités que Yousign compte pour la facturation. 0 quand la demande était déjà active ; en essai, le nombre qui aurait été facturé.
  • {{ data.<step>.cancelled }} — boolean. Annuler seulement : true quand l’annulation a été envoyée, false en essai.
  • {{ data.<step>.reactivated }} — boolean. Relancer une demande expirée seulement : true quand la demande a été relancée, false en essai.
  • {{ data.<step>.expirationDate }} — string. Relancer une demande expirée seulement : la nouvelle date d’expiration envoyée.
  • {{ data.<step>.deleted }} — boolean. Supprimer (demande) et Supprimer un abonnement : true quand la suppression a été envoyée, false en essai.
  • {{ data.<step>.permanent }} — boolean. Supprimer (demande) seulement : true quand la suppression était définitive plutôt qu’à la corbeille.
  • {{ data.<step>.documentId }} — string. Téléverser une pièce jointe du mail et Lister les documents : l’identifiant du premier document, prêt pour le champ de signature d’Ajouter un signataire.
  • {{ data.<step>.anchors }} — number. Téléverser une pièce jointe du mail seulement : le nombre total de Smart Anchors détectées dans les documents téléversés.
  • {{ data.<step>.reusedNames }} — array of string. Téléverser une pièce jointe du mail seulement : les noms de fichiers déjà présents sur la demande, qui n’ont pas été renvoyés.
  • {{ data.<step>.document }} — { filename, mime, size, sha256, attachmentPosition?, deduplicated? }. Télécharger le document signé seulement : le fichier récupéré. sha256 est son empreinte SHA-256 ; attachmentPosition sa position dans les pièces jointes de l’exécution.
  • {{ data.<step>.auditTrail }} — { filename, mime, size, sha256, attachmentPosition?, deduplicated? }. Télécharger le dossier de preuve seulement : le fichier récupéré, même forme que document.
  • {{ data.<step>.filename }} — string. Les deux téléchargements : le nom du fichier, tel que Yousign le donne, ou signed-document.pdf, audit-trail.pdf (.zip pour une archive) par défaut.
  • {{ data.<step>.mime }} — string. Les deux téléchargements : le type MIME du fichier (application/pdf ou application/zip).
  • {{ data.<step>.size }} — number. Les deux téléchargements : la taille du fichier, en octets.
  • {{ data.<step>.attachmentPosition }} — number. Les deux téléchargements : la position du fichier dans les pièces jointes de l’exécution, prête pour une étape Rédiger ou un nœud de dépôt.
  • {{ data.<step>.deduplicated }} — boolean. Les deux téléchargements : true quand un fichier identique figurait déjà dans les pièces jointes de l’exécution ; sa position est reprise.
  • {{ data.<step>.contentBase64 }} — string. Les deux téléchargements, seulement avec Inclure le contenu encodé : le contenu du fichier en base64.
  • {{ data.<step>.signer }} — { id, status, firstName, lastName, email, signatureLevel, signatureLink, signatureLinkExpiresAt }. Ajouter un signataire et Obtenir un signataire : le signataire.
  • {{ data.<step>.signerId }} — string. Ajouter un signataire, Obtenir un signataire, Relancer un signataire, Lister les signataires (le premier) : l’identifiant du signataire. Vide en essai après Ajouter un signataire.
  • {{ data.<step>.fieldsPlacedAtActivation }} — boolean. Ajouter un signataire seulement : true avec les Smart Anchors, dont les champs n’existent qu’une fois la demande activée.
  • {{ data.<step>.reminded }} — boolean. Relancer un signataire seulement : true quand la relance a été envoyée, false en essai.
  • {{ data.<step>.approver }} — { id, status, firstName, lastName, email }. Ajouter un approbateur seulement : l’approbateur créé.
  • {{ data.<step>.approverId }} — string. Ajouter un approbateur seulement : l’identifiant de l’approbateur, vide en essai.
  • {{ data.<step>.approvers }} — array of { id, status, firstName, lastName, email }. Lister les approbateurs seulement : les approbateurs de la demande.
  • {{ data.<step>.followers }} — array. Ajouter des suiveurs : les adresses envoyées, en chaînes. Lister les suiveurs : les suiveurs, sous la forme { id, email, locale }.
  • {{ data.<step>.templates }} — array of { id, name, email, description, status }. Ressource Modèle seulement : les modèles actifs. templateId donne le premier.
  • {{ data.<step>.contacts }} — array of { id, name, email, description, status }. Ressource Contact seulement : les contacts du carnet d’adresses. contactId donne le premier.
  • {{ data.<step>.users }} — array of { id, name, email, description, status }. Ressource Utilisateur seulement : les membres de l’organisation Yousign. userId donne le premier.
  • {{ data.<step>.workspaces }} — array of { id, name, email, description, status }. Ressource Espace de travail seulement : les espaces de travail. workspaceId donne le premier.
  • {{ data.<step>.webhooks }} — array of { id, description, endpoint, enabled, sandbox }. Lister les abonnements seulement : les abonnements webhook. Leur clé de signature n’est jamais rendue.
  • {{ data.<step>.webhookId }} — string. Opérations sur les abonnements : l’abonnement concerné (pour Lister les abonnements, le premier ; vide en essai après une création).
  • {{ data.<step>.endpoint }} — string. Créer un abonnement seulement : l’URL de destination enregistrée.
  • {{ data.<step>.description }} — string. Créer un abonnement seulement : la description de l’abonnement.
  • {{ data.<step>.events }} — array of string. Créer un abonnement seulement : les événements souscrits, * pour tous.
  • {{ data.<step>.secretReturned }} — boolean. Créer un abonnement seulement : toujours false. La clé de signature rendue par Yousign n’est pas versée dans les données d’étape.
  • {{ data.<step>.created }} — boolean. Créer un abonnement seulement : true quand l’abonnement a été créé, false en essai.
  • {{ data.<step>.simulated }} — boolean. true quand une écriture a été décrite au lieu d’être faite (essai). Les lectures et les téléchargements ne sont jamais simulés.
  • {{ data.<step>.summary }} — string. Le résumé d’une ligne dans la langue du membre, par exemple « Demande de signature « Lettre de mission » créée (brouillon). » (avec summaryKey et summaryParams).

Opérations ​

Le nœud demande d’abord une Ressource (resource), puis l’opération propre à cette ressource, dans un paramètre nommé <ressource>Operation. La plupart des opérations portent sur une Demande de signature (signatureRequest), choisie dans une liste, par identifiant ({{ data.<step>.signatureRequestId }}) ou par URL.

Demande de signature (signatureRequestOperation) ​

  • Créer un brouillon (create, le défaut). Crée une demande en brouillon nommée Nom de la demande (name, 128 caractères au plus). Options : Envoi des invitations (deliveryMode : Yousign envoie les e-mails, ou Aucun envoi — je relaie le lien), Signature séquentielle (orderedSigners), Autoriser le refus de signer (signersAllowedToDecline), Date d’expiration (expirationDate, AAAA-MM-JJ ; six mois si vide), Identifiant externe (externalId), Fuseau horaire (timezone), Langue du dossier de preuve (auditTrailLocale), Espace de travail (workspace), Relances automatiques (reminderInterval) et Nombre de relances (reminderMaxOccurrences), Objet de l’invitation (emailSubject) et Message de l’invitation (emailBody). Rien n’est envoyé. Le nœud cherche d’abord une demande portant le même identifiant externe (GET /signature_requests) et la rend s’il en existe une ; sinon il appelle POST /signature_requests. Publie signatureRequest, signatureRequestId, status, externalId, reused.
  • Créer depuis un modèle (createFromTemplate). Comme Créer un brouillon, à partir d’un Modèle (template) actif : Signataires du modèle (templateSigners, une ligne par emplacement du modèle : étiquette, prénom, nom, adresse, langue) et Textes du modèle (templateTexts, les champs de texte en lecture seule). Même sortie.
  • Obtenir une demande (get). Lit la demande avec ses documents et ses signataires. Publie signatureRequest, signatureRequestId, status, externalId, documents, signers, signatureLink.
  • Lister les demandes (list). Liste les demandes filtrées par Statuts (statuses), Origine des demandes (sources, API et application par défaut), Recherche (query) et Identifiant externe exact (externalIdFilter), jusqu’au Nombre maximum (limit, de 1 à 200, 50 par défaut). Publie signatureRequests, signatureRequestId, count, truncated.
  • Activer (activate). Envoie les invitations et déclenche la facturation (POST /signature_requests/{id}/activate), au nom de Expéditeur (sender, le propriétaire de la clé si vide). Exige que Je confirme que cette activation est facturée (confirmBilling) soit coché. Le nœud relit d’abord la demande : si elle a déjà quitté l’état de brouillon, rien n’est envoyé. Publie signatureRequest, signatureRequestId, status, externalId, signers, signatureLink, activated, alreadyActive, billedSigners.
  • Annuler (cancel). Annule une demande en approbation ou en cours, avec Motif d’annulation (cancelReason) et Précision (cancelNote, communiquée aux destinataires). Définitif : une demande annulée ne se réactive pas. Publie signatureRequestId, cancelled.
  • Relancer une demande expirée (reactivate). Donne à une demande expirée une nouvelle Date d’expiration, alors obligatoire. Publie signatureRequest, signatureRequestId, status, externalId, reactivated, expirationDate.
  • Supprimer (delete). Supprime une demande qui n’est ni en approbation ni en cours. Elle part à la corbeille, ou disparaît définitivement avec Suppression définitive (permanentDelete). Publie signatureRequestId, deleted, permanent.

Document (documentOperation) ​

  • Téléverser une pièce jointe du mail (upload, le défaut). Retient des pièces jointes de l’exécution avec Pièces jointes retenues (selection : toutes, la première, par type de fichier mime, par nom de fichier namePattern) et envoie chacune comme un document distinct (POST /signature_requests/{id}/documents, en multipart), avec Nature du document (documentNature : Document à signer, PDF ou DOCX, ou Pièce jointe informative), Renommer le document (documentName, appliqué seulement quand un seul fichier est retenu) et Détecter les Smart Anchors (parseAnchors). Un fichier dont le nom figure déjà sur la demande n’est pas renvoyé. Publie signatureRequestId, documents, documentId, anchors, reusedNames, count.
  • Lister les documents (list). Publie signatureRequestId, documents, documentId, count, truncated.
  • Télécharger le document signé (downloadSigned). Télécharge la Version à télécharger (downloadVersion) : Signée (demande terminée) (completed, le défaut, disponible seulement une fois la demande terminée) ou En l’état (current). Un seul document à signer donne un PDF, plusieurs donnent un ZIP. Le fichier est ajouté aux pièces jointes de l’exécution. Publie signatureRequestId, document, filename, mime, size, attachmentPosition, deduplicated, et contentBase64 avec Inclure le contenu encodé (includeContent).
  • Télécharger le dossier de preuve (downloadAuditTrail). Télécharge les pistes d’audit des signataires, fusionnées en un PDF avec Fusionner les pistes d’audit (mergeAuditTrails, coché par défaut) ou en ZIP avec un fichier par signataire. Même sortie, avec auditTrail au lieu de document.

Les deux téléchargements sont bornés par Taille maximale (Mo) (maxDownloadMb).

Signataire (signerOperation) ​

  • Ajouter un signataire (create, le défaut). Qui signe ? (signerSource) : Une personne saisie ici (Prénom signerFirstName, Nom signerLastName, Adresse e-mail signerEmail, Téléphone signerPhone, Langue du signataire signerLocale), Un contact du carnet Yousign (signerContact) ou Un membre de l’organisation (signerUser). Niveau de signature (signatureLevel : simple, avancée ou qualifiée) et Authentification (authenticationMode). Champ de signature (fieldMode) : À des coordonnées sur Document à signer (fieldDocument), Page (fieldPage), X (fieldX), Y (fieldY, depuis le haut), Largeur (fieldWidth, 85 au minimum), Hauteur (fieldHeight, 37 au minimum) ; Par Smart Anchors ; ou Aucun pour une demande créée depuis un modèle. Publie signatureRequestId, signer, signerId, fieldsPlacedAtActivation.
  • Obtenir un signataire (get). Lit Signataire (signer). Publie signatureRequestId, signer, signerId, signatureLink.
  • Lister les signataires (list). Publie signatureRequestId, signers, signerId, count, truncated.
  • Relancer un signataire (remind). Renvoie l’invitation à Signataire. Aucune facturation supplémentaire. Publie signatureRequestId, signerId, reminded.

Approbateur (approverOperation) ​

  • Ajouter un approbateur (create, le défaut). Un Approbateur interne (approverUser), ou la personne saisie dans Prénom, Nom, Adresse e-mail et Langue (approverFirstName, approverLastName, approverEmail, approverLocale). Seulement tant que la demande est en brouillon. Publie signatureRequestId, approver, approverId.
  • Lister les approbateurs (list). Publie signatureRequestId, approvers, count, truncated.

Suiveur (followerOperation) ​

  • Ajouter des suiveurs (create, le défaut). Les Adresses des suiveurs (followerEmails, séparées par des virgules, des points-virgules ou des retours à la ligne, cent au plus) reçoivent une copie du document signé, dans la Langue (followerLocale). Publie signatureRequestId, followers, count.
  • Lister les suiveurs (list). Publie signatureRequestId, followers, count, truncated.

Modèle, Contact, Utilisateur, Espace de travail ​

Chacune de ces ressources a une seule opération, qui liste les éléments (GET /templates, /contacts, /users, /workspaces), jusqu’au Nombre maximum. Les modèles sont limités aux modèles actifs. Publie templates et templateId, contacts et contactId, users et userId, ou workspaces et workspaceId, avec count et truncated.

Abonnement webhook (webhookOperation) ​

  • Lister les abonnements (list, le défaut). Publie webhooks, webhookId, count.
  • Créer un abonnement (create). Enregistre URL de destination (webhookEndpoint, en HTTPS public : l’URL affichée sur le déclencheur Yousign — événement) avec Description (webhookDescription), Écouter le bac à sable (webhookSandbox), Événements souscrits (webhookEvents, tous si aucun n’est coché), Origines écoutées (webhookScopes) et Rejeu automatique (webhookAutoRetry). Publie webhookId, endpoint, description, events, secretReturned, created.
  • Supprimer un abonnement (delete). Supprime Abonnement (webhook). Publie webhookId, deleted.

Chaque opération publie aussi simulated et summary.

Exemple ​

Quand une lettre de mission est entièrement signée, le PDF signé et son dossier de preuve doivent être rangés dans Google Drive. Le workflow démarre sur le déclencheur Yousign — événement, réglé sur signature_request.done ; l’événement vit sous data.yousign. Un premier nœud Yousign, nommé « Document signé », rapatrie le fichier signé :

text
resource            document
documentOperation   downloadSigned
signatureRequest    (mode identifiant) {{ data.yousign.data.signature_request.id }}
downloadVersion     completed
maxDownloadMb       10
includeContent      décoché

Ses données :

json
{
  "signatureRequestId": "6f1d2c3b-…",
  "document": {
    "filename": "Lettre de mission.pdf",
    "mime": "application/pdf",
    "size": 184320,
    "sha256": "9b1c…",
    "attachmentPosition": 1,
    "deduplicated": false
  },
  "filename": "Lettre de mission.pdf",
  "mime": "application/pdf",
  "size": 184320,
  "attachmentPosition": 1,
  "deduplicated": false,
  "simulated": false
}

Un second nœud Yousign, nommé « Dossier de preuve », fait de même avec documentOperation: downloadAuditTrail et mergeAuditTrails coché. Puis un nœud Drive — déposer un fichier nommé « Archive » les dépose :

text
source      attachment
selection   all
folder      (mode liste) Lettres de mission signées
onConflict  rename

Un workflow démarré par Yousign n’a pas de mail déclencheur : Toutes les pièces jointes ne couvre donc que les deux fichiers rapatriés par les étapes précédentes. Les liens Drive sont ensuite disponibles dans {{ data.archive.files.0.webViewLink }} et {{ data.archive.files.1.webViewLink }}. Pour retrouver le dossier client, utilisez {{ data.yousign.data.signature_request.external_id }} : c’est l’identifiant externe donné à la création de la demande.

Conseils ​

  • L’activation est facturée. Yousign compte un crédit par signataire invité au moment de l’activation, qu’il signe ou non. Le nœud refuse d’activer tant que Je confirme que cette activation est facturée n’est pas coché (node_invalid_param sinon) ; cette case ne peut pas être remplie par une expression. Avant d’activer, le nœud relit la demande : une demande déjà en approbation, en cours, terminée, refusée ou rejetée n’est pas réactivée (alreadyActive: true, billedSigners: 0) : une nouvelle tentative ne facture jamais deux fois.
  • Pas de demande en double. Identifiant externe est la clé d’idempotence. Laissé vide, le nœud en dérive une de la clé d’étape, qui reste la même d’une nouvelle tentative à l’autre ; rempli, c’est votre propre référence de dossier, qui revient dans les webhooks (lettres, chiffres et _ - @ . % +, les autres caractères deviennent -, 255 caractères au plus). Avant de créer, le nœud cherche une demande portant cet identifiant externe et la rend avec reused: true.
  • Téléversements. Yousign n’accepte que le multipart, jamais le base64 : le nœud envoie la pièce elle-même, relue dans l’exécution. Un fichier dont le nom figure déjà sur la demande n’est pas renvoyé (reusedNames), ce qui rend une nouvelle tentative sûr. Si aucune pièce ne passe la sélection, l’étape échoue avec node_nothing_to_do. Chaque pièce est limitée à 10 Mio, vérifiés pour toutes avant le premier envoi (attachment.too_large) : une demande n’est jamais laissée à moitié remplie.
  • Chaque signataire a besoin d’un champ. Sans au moins un champ de signature par signataire, l’activation échoue. En coordonnées, l’origine est le coin supérieur gauche de la page, en points (une page A4 fait environ 596 × 842). Avec les Smart Anchors, le document doit avoir été téléversé avec Détecter les Smart Anchors, et les champs ne sont créés qu’à l’activation. La détection échoue en silence : vérifiez que anchors ne vaut pas 0.
  • Niveaux de signature. La signature avancée utilise toujours un code par SMS et la qualifiée aucun, quel que soit le réglage d’Authentification. Un code par SMS exige un Téléphone au format international (+33612345678), sinon l’étape échoue avec node_invalid_param. Les niveaux avancé et qualifié doivent être activés par le support Yousign ; le qualifié exige aussi la signature séquentielle.
  • Liens de signature. En mode « aucun envoi », Yousign n’envoie aucun e-mail et signatureLink porte le lien de chaque signataire après l’activation ; il expire en 48 heures.
  • Téléchargements. La version signée n’est disponible qu’une fois la demande terminée. La Taille maximale (Mo) va de 1 à 10, la limite réelle du serveur par fichier téléchargé ; un fichier plus gros fait échouer l’étape. Laissez Inclure le contenu encodé décoché sauf si une Requête HTTP a besoin du base64 : le fichier est déjà dans les pièces jointes de l’exécution, et la copie encodée alourdit chaque étape suivante.
  • Lister les demandes. Yousign ne rend que les demandes créées par API si on ne lui dit rien : gardez les deux origines dans Origine des demandes pour voir aussi celles préparées dans l’application.
  • Abonnements webhook. Chez Yousign, les webhooks sont partagés entre bac à sable et production : en créer un par API exige une clé de production, même pour écouter le bac à sable, et c’est Écouter le bac à sable qui décide de ce qu’on écoute. La clé de signature rendue par Yousign n’est jamais versée dans les données d’étape : recopiez-la à la main dans la connexion.
  • Essais. En essai, lectures et téléchargements partent pour de bon, y compris la recherche par identifiant externe avant une création. Créations, téléversements, activation, annulation, relance, suppression, rappels et changements d’abonnements sont seulement décrits : rien n’est envoyé, rien n’est facturé, simulated vaut true et aucun nouvel identifiant n’est rendu. Pour Activer, billedSigners indique combien de signataires auraient été facturés.
  • Données du déclencheur. Dans un workflow démarré par le déclencheur Yousign, l’événement vit sous data.yousign. N’y nommez pas ce nœud « Yousign » : ses données ne seraient plus joignables que par l’identifiant du nœud.
  • Erreurs. integration.unauthorized : la clé a été refusée ou révoquée. integration.not_found : la demande, le document ou le signataire n’existe pas dans cet environnement. integration.rejected : Yousign a refusé la requête comme invalide ; le détail de l’erreur porte le message de Yousign. integration.rate_limited et integration.unavailable sont retentées automatiquement : les requêtes sont cadencées à 30 par minute et par connexion (la limite du bac à sable), et une réponse 409, 429 ou 5xx a droit à trois tentatives avant que le moteur ne reprenne l’étape plus tard. Voir Gestion des erreurs.