> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/les-workflows/creer-des-pages/signature-electronique.md).

# Signature électronique

L'action de **Signature électronique** permet de signer électroniquement des documents via [YouSign](https://yousign.com/fr-fr). Pour chaque action **Signature électronique**, un document est signé par N signataires.

{% hint style="info" %}
Pour utiliser cette action, vous devez disposer d'un compte [**YouSign**](https://yousign.com/fr-fr).
{% endhint %}

L'action signature électronique en vidéo : 

{% embed url="<https://www.youtube.com/watch?ab_channel=KSAAR&v=tQvNjFYp0V0>" %}

### ⚙️ Paramétrage de la signature

1️⃣ Choisissez le nom de votre action et sa description

2️⃣ Sélectionnez le document à signer parmi :&#x20;

* un fichier que vous avez préalablement créé grâce à l'action [**Créer un document**](/ksaar-documentation/les-workflows/creer-des-pages.md#remplir-un-document)
* un champ fichier du workflow
* un fichier que vous importez&#x20;

<figure><img src="/files/ccFcTuXhGjXWbcXBwYEX" alt=""><figcaption><p>Paramétrage de la première étape - Action signature électronique</p></figcaption></figure>

### **🧑🏽 Choix des signataires**&#x20;

Vous pouvez choisir vos signataires parmi :&#x20;

* l'utilisateur connecté -> ajoute 1 signataire
* les champs d'une matrice -> ajoute N signataires
* les champs d'une table -> ajoute 1 signataire

Dans les trois cas, vous devez spécifier les informations du signataire en choisissant des champs pour son prénom, son nom, son email et son numéro de téléphone.

{% hint style="warning" %}
Le prénom, le nom, l'email et le numéro de téléphone du signataire sont requis pour la signature électronique sur YouSign.

Dans le cas où votre signataire est l'utilisateur connecté, n'oubliez pas de passer le numéro de téléphone en champ requis dans le workflow d'inscription si la méthode d'authentification sélectionnée est SMS.
{% endhint %}

<figure><img src="/files/Sy5gTHie4e8y6mrOc0J5" alt=""><figcaption><p>Choix du signataire</p></figcaption></figure>

### 🔐 Méthode d'authentification

Au moment de valider la signature du document sur YouSign, le signataire peut être authentifié selon différentes méthodes. Cette étape permet de sécuriser le processus de signature électronique.

Trois options sont possibles :

* réception d’un **code par SMS**
* réception d’un **code par email**
* **aucune confirmation par code**

La méthode peut être définie directement dans l’action ou via un champ de la table. Si elle est définie depuis un champ, celui-ci doit contenir l’une des valeurs `otp_sms`, `otp_email` ou `no_otp`. En l’absence de valeur, la confirmation par SMS est appliquée par défaut.

Si la méthode choisie est le SMS, le numéro de téléphone du signataire doit impérativement être renseigné sinon la signature échouera.

{% hint style="warning" %}
L’option sans code de confirmation doit être utilisée avec précaution, car elle offre un niveau de sécurité plus faible.
{% endhint %}

### ✏️ Emplacement de la signature sur le document &#x20;

Vous devez choisir l'emplacement de la signature sur le document :&#x20;

* à partir d'un champ paragraphe&#x20;
* directement à cet endroit

Dans les deux cas, l'emplacement de la signature doit être défini par des coordonnées V2 ou V3 selon la version YouSign que vous utilisez.

Pour déterminer ces coordonnées, cliquez sur **calculer les coordonnées**. Vous allez être redirigé vers [YouSign](https://placeit.yousign.fr/), vous pouvez alors choisir un document et définir l'emplacement et la taille de la signature sur ce document. Cette étape vous génère automatiquement des coordonnées que vous pouvez copier dans l'encart prévu à cet effet sur Ksaar.&#x20;

<figure><img src="/files/lUtshkt7wrM1cbYnIvqn" alt=""><figcaption><p>Exemple de position de la signature</p></figcaption></figure>

Si vous choisissez l'emplacement de la signature à partir d'un champ paragraphe, c'est l'utilisateur qui choisi lui même l'emplacement de la signature et donc défini les coordonnées. C'est toujours le cas quand vos signataires proviennent des champs d'une matrice.&#x20;

### 📌 Ajout de champs sur le document à signer

En plus de définir l’emplacement de la signature, vous avez la possibilité d’ajouter différents champs sur le document à signer. Ces champs permettent d’enrichir l’expérience de signature et d’ajouter des informations supplémentaires à compléter par le signataire.

👉 **Pour ajouter un champ**, cliquez sur le **“+”** situé sous la section **“Ajouter des champs au document”**.

Par défaut, le champ paramétré est la **date de signature** (signature\_date).\
Si vous souhaitez ajouter d’autres champs ou les configurer différemment, vous devez alors définir leur configuration au format **JSON**, conformément à la [documentation API Yousign](https://developers.yousign.com/reference/post-signature_requests-signaturerequestid-documents-documentid-fields-1).

<figure><img src="/files/3NR90E6WsEQWPGB8d3Aw" alt=""><figcaption></figcaption></figure>

Chaque champ possède des **paramètres requis** et des **paramètres optionnels** propres, qu’il est important de renseigner selon l’usage souhaité.

Vous pouvez ajouter les champs suivants sur votre document :

* **Signature :** Permet d’ajouter un nouvel emplacement de signature. Ce champ peut être utile si vous souhaitez placer la même signature à plusieurs emplacements, notamment dans le cas d’un document comportant plusieurs pages.
* **SignatureDate :** Ajoute la date de signature du document.
* **Text :** Ajoute un emplacement de texte modifiable par le signataire.\
  Ce champ peut être utilisé pour collecter une information complémentaire (ex. : numéro de client, mention obligatoire, etc.).
* **Checkbox :** Ajoute une case à cocher. Le signataire peut la cocher ou non selon la configuration.\
  Ce champ est utile pour obtenir un consentement explicite ou valider une étape obligatoire.
* **RadioGroup** : Permet d’ajouter un groupe de boutons radio. Le signataire doit sélectionner une option parmi plusieurs choix définis. Recommandé lorsque vous souhaitez forcer un choix unique.

### 🙋🏽 Ajouter des signataires

Il est possible d'ajouter des signataires en cliquant sur **Ajouter un signataire.** Un nouveau bloc apparaît et vous pouvez alors définir un nouveau signataire.&#x20;

Pour chaque signataire, vous devez définir ses coordonnées et l'emplacement de sa signature.&#x20;

### 🔗 Connexion [YouSign](https://yousign.com/fr-fr)-Ksaar

1️⃣ Créez une clé API sur [YouSign](https://yousign.com/fr-fr)&#x20;

<figure><img src="/files/6n9jmCUczQKJd9S5I0Zo" alt=""><figcaption><p>Exemple de création de clé API sur YouSign</p></figcaption></figure>

2️⃣ Copiez la clé API créée

<figure><img src="/files/VCbCqbgWg47KGc2AghTE" alt=""><figcaption></figcaption></figure>

3️⃣ Collez votre clé API YouSign dans Ksaar&#x20;

<figure><img src="/files/PNVNX4bDlKBwHpaq4rPG" alt="" width="375"><figcaption></figcaption></figure>

4️⃣ En sauvegardant, Ksaar va vous générer un **Webhook endpoint** que vous allez copier (uniquement pour YouSign V3)

<figure><img src="/files/G8rt5cNSdW3tpCuOkadW" alt="" width="375"><figcaption></figcaption></figure>

5️⃣ Créez un Webhook sur YouSign en collant le Webhook endpoint généré par Ksaar (uniquement pour YouSign V3)

<figure><img src="/files/fsYVSgJsYsrNxZLYSUMJ" alt=""><figcaption><p>Paramétrage du webhook</p></figcaption></figure>

6️⃣ Une fois le Webhook créé sur YouSign, vous pouvez copier la clé secrète de ce Webhook (uniquement pour YouSign V3)

<figure><img src="/files/LeA0F2YIOQrTuj6x57A1" alt=""><figcaption></figcaption></figure>

7️⃣ Collez votre clé secrète dans Ksaar et cliquez sur Sauvegarder&#x20;

<figure><img src="/files/fkIs7UdhC8HLh2aQKnHg" alt="" width="375"><figcaption></figcaption></figure>

### 🚧 YouSign V2

Si vous utilisez **YouSign V2** et que vous rencontrez des difficultés, contactez l'équipe de Ksaar sur [Discord](https://discord.gg/VnTVbBTxdG).&#x20;

### ❌ Gestion des erreurs

Vous avez la possibilité de visualiser :&#x20;

* la date de création de la demande de signature électronique
* le statut de la procédure
* le(s) document(s) à signer
* le message d'erreur

Pour cela, créez un tableau ayant comme source le workflow contenant votre action **Signature électronique**. Vous pouvez alors sélectionner les variables liés à la signature en ajoutant des colonnes.

<figure><img src="/files/rAeczyy7ENKZgHNOZOal" alt="" width="375"><figcaption></figcaption></figure>

Le message d'erreur vous permet d'identifier la nature de l'erreur notamment en cas de non réception de mail.&#x20;

<figure><img src="/files/IudDHLJJev0oJYS0lKOl" alt=""><figcaption><p>Exemple de message d'erreur lorsque le champ email du signataire est vide</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ksaar.gitbook.io/ksaar-documentation/les-workflows/creer-des-pages/signature-electronique.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.