Comment envoyer un document pour signature\u00a0?

Cet article vous explique comment envoyer un document pour signature à l'aide de l'API eSignature de Sign.Plus.

En suivant ces étapes, vous allez créer une enveloppe, ajouter un document, définir un destinataire, insérer une annotation de signature et, enfin, envoyer l'enveloppe pour signature.

Prérequis

• Un compte Sign.Plus avec un plan API
• Votre Personal Access Token

Étape 1\u00a0: créer une enveloppe

Une enveloppe est un conteneur pour les documents à faire signer par les destinataires.

1. Envoyez une requête au point de terminaison POST /v2/envelope pour créer une nouvelle enveloppe. {
"name": "My wonderful envelope",
"flow_type": "REQUEST_SIGNATURE",
"legality_level": "SES",
"expires_at": 1831280113,
"sandbox": true
}
2. Incluez votre clé API dans l'en-tête Authorization .

3. En cas de succès, vous recevrez un objet Envelope.

   { "id": "<string>" ... }

4. Enregistrez l'id comme envelope_id

Étape 2 : ajouter un document à votre enveloppe

1. Utilisez le point de terminaison POST /v2/envelope/{envelope_id}/document pour ajouter un document.

2. Remplacez {envelope_id} par l'ID reçu à l'étape 1.

3. Envoyez une requête POST avec le fichier du document dans le corps de la requête au format multipart/form-data.

4. En cas de succès, vous recevrez un objet Document en réponse.
   { "id": "<string>" ... }

5. Enregistrez l'id comme document_id pour plus tard.

Étape 3 : définir un destinataire pour votre enveloppe

1. Utilisez le point de terminaison POST /v2/envelope/{envelope_id}/signing_steps pour ajouter un destinataire.

2. Remplacez {envelope_id} par l'ID de votre enveloppe.

3. Envoyez une requête POST avec le corps JSON suivant :

   {
"signing_steps": [
{
"recipients": [
{
"name": "John Doe", "email": "john.doe@example.com", "role": "SIGNER"
} ] } ] }

4. En cas de succès, vous recevrez un tableau de SigninStep.

5. Parcourez le tableau et notez le nom id du destinataire pour lequel vous souhaitez ajouter le cadre de signature (annotation de signature). Enregistrez cet id comme recipient_id.

Étape 4 : insérer une annotation de signature dans votre document

Avant d'ajouter une annotation de signature, assurez-vous d'avoir défini votre signature sur la plateforme Sign.Plus.

1. Utilisez le point de terminaison POST /v2/envelope/{envelope_id}/annotation pour ajouter une annotation de signature.
2. Remplacez {envelope_id} par l'ID de votre enveloppe. 
3. Envoyez une requête POST avec le corps JSON suivant :
   {
"recipient_id": "<recipient_id>",
"document_id": "<document_id>",
"page": 1,
"x": 50,
"y": 20,
"width": 20,
"height": 60,
"required": true,
"type": "SIGNATURE",
}

   Remplacez <recipient_id> et <document_id> par les valeurs appropriées.

Étape 5 : envoyer votre enveloppe pour signature

1. Utilisez le point de terminaison POST /v2/envelope/{envelope_id}/send pour envoyer l'enveloppe.
2. Remplacez {envelope_id} par l'ID de votre enveloppe.
3. Envoyez une requête POST à ce point de terminaison.
4. En cas de succès, l'enveloppe sera envoyée au destinataire pour signature.
   
   

Conclusion

Vous avez maintenant envoyé avec succès un document pour signature à l'aide de l'API eSignature de Sign.Plus. Le destinataire recevra une notification par e-mail contenant un lien pour signer le document.

Pour obtenir des informations plus détaillées sur chaque point de terminaison de l'API utilisé dans ce processus, veuillez consulter notre documentation de l'API.