Passer au contenu

Flux de travail du destinataire automatique

Un destinataire automatique permet à NSE d'appliquer une signature ou un cachet à un document sans aucune interaction humaine. Au lieu d'envoyer un lien de signature à une personne, l'étape de signature est exécutée automatiquement côté serveur à l'aide d'un certificat de scellage préconfiguré.


Prérequis

  • Un certificat de scellage est configuré dans Paramètres de l'organisation → Certificats de scellage
  • La valeur signatureProfile doit correspondre exactement au nom convivial du certificat d'eScellage configuré
  • Le feature flag "AutomaticRemoteSignature" est activé sur l'organisation
  • Un jeton Bearer JWT valide ou un jeton d'accès personnel
  • Votre ID d'organisation (organizationId)
  • Un document prêt à être téléversé

Procédure API

Étape 1 — Créer l'enveloppe

POST /api/v1/organizations/{organizationId}/envelopes
Content-Type: application/json
{
  "name": "Automatic Signing Envelope",
  "expiration": {
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "mode": "absolute"
  }
}

Sauvegarder le champ id de la réponse en tant que envelopeId.

Étape 2 — Téléverser le document

POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files
Content-Type: multipart/form-data
file=@document.pdf

Sauvegarder le champ id de la réponse en tant que fileId.

Étape 3 — Créer l'étape

POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages
Content-Type: application/json
{
  "name": "Automatic Seal",
  "requiredRecipientCompletions": 1,
  "type": "automatic"
}

Sauvegarder le champ id de la réponse en tant que stageId.

Étape 4 — Ajouter le destinataire automatique

POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients
Content-Type: application/json
{
    "languageCode": "en",
    "signatureProfile": "<profile-name>",
    "type": "Automatic"
}

Sauvegarder le champ id de la réponse en tant que recipientId.

Étape 5 — Ajouter la tâche de signature

POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks
Content-Type: application/json
{
  "tasks": [
    {
      "field": {
        "fieldType": "AutomaticSignature",
        "id": "1234",
        "page": 1,
        "positionX": 50,
        "positionY": 200,
        "width": 200,
        "height": 60
      },
      "recipientId":"7117de33-1234-1234-1234-51809e7a3e20",
      "sortOrder":1
    }
  ]  
}

Étape 6 — Envoyer l'enveloppe

POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/send

L'étape s'exécute immédiatement après l'envoi. Le cachet est appliqué automatiquement et l'enveloppe se finalise sans aucune interaction humaine.


Téléchargement des documents signés

Une fois l'enveloppe finalisée, récupérer les artefacts via :

GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifacts

Puis télécharger un artefact spécifique (document signé ou piste d'audit) en utilisant son artifactId :

GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifacts/{artifactId}