Création d'un flux de travail de signataire

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

Lors de la création d'une transaction, il se peut que plusieurs signataires doivent signer plusieurs documents. Par conséquent, vous pouvez souhaiter contrôler le débit de l'Signer Experience. Avec OneSpan Sign, vous pouvez définir l'ordre dans lequel plusieurs signataires participent, ou l'ordre dans lequel plusieurs documents sont signés par un signataire. Le flux de travail des signataires détermine l'ordre dans lequel plusieurs signataires peuvent participer à l'Signer Experience. Par exemple, un signataire avec un ordre de signature 1 signifie qu'il signera en premier.

Création d'un flux de travail de signataire

Dans cet exemple, il y a quatre signataires, et chaque signataire est tenu de signer dans l'ordre. Par exemple, le deuxième signataire ne recevra une notification pour signer le document qu'une fois que le premier signataire aura terminé sa signature. Le code suivant permet d'effectuer ce qui suit :

.withSigner(newSignerWithEmail("signer1@xyz.com")
    .withFirstName("FirstNameSigner1")
    .withLastName("LastNameSigner1")
    .signingOrder(1)
)
.withSigner(newSignerWithEmail("signer2@xyz.com")
    .withFirstName("FirstNameSigner2")
    .withLastName("LastNameSigner2")
    .signingOrder(2)
)
.withSigner(newSignerWithEmail("signer3@xyz.com")
    .withFirstName("FirstNameSigner3")
    .withLastName("LastNameSigner3")
    .signingOrder(3)
)
.withSigner(newSignerWithEmail("signer4@xyz.com")
    .withFirstName("FirstNameSigner4")
    .withLastName("LastNameSigner4")
    .signingOrder(4)
)

Modifier votre flux de travail du signataire

Après avoir créé votre transaction, vous pouvez changer l'ordre de signature. Dans cet exemple, l'ordre de signature des deux premiers signataires est modifié.

Le code suivant permet d'effectuer ce qui suit :

DocumentPackage afterReorder = eslClient.getPackage(packageId);
afterReorder.getSigner("John.Smith@email.com").setSigningOrder(2);
afterReorder.getSigner("Patty.Galant@email.com").setSigningOrder(1);
eslClient.getPackageService().orderSigners(afterReorder);

Si vous avez déjà envoyé votre transaction, vous devrez changer son statut pour ÉBAUCHE avant de pouvoir mettre à jour le flux de travail des signataires.

Résultats

Après avoir exécuté votre code, si vous vous connectez à OneSpan Sign et accédez à votre transaction, vous verrez votre ordre de signature.

.NET SDK

Pour télécharger l'exemple complet de code, consultez notre site Partage de code. Si vous ne pouvez pas utiliser FastTrack, communiquez avec notre équipe de soutien pour qu'il soit activé pour votre compte.

Lors de la création d'une transaction, il se peut que plusieurs signataires doivent signer plusieurs documents. Par conséquent, vous pouvez souhaiter contrôler le débit de l'Signer Experience. Avec OneSpan Sign, vous pouvez définir l'ordre dans lequel plusieurs signataires participent, ou l'ordre dans lequel plusieurs documents sont signés par un signataire. Le flux de travail des signataires détermine l'ordre dans lequel plusieurs signataires peuvent participer à l'Signer Experience. Par exemple, un signataire avec un ordre de signature 1 signifie qu'il signera en premier.

Dans cet exemple, il y a quatre signataires, et chaque signataire est tenu de signer dans l'ordre. Par exemple, le deuxième signataire ne recevra une notification pour signer le document qu'une fois que le premier signataire aura terminé sa signature. Le code suivant permet d'effectuer ce qui suit :

Création d'un flux de travail de signataire

Dans cet exemple, il y a quatre signataires, et chaque signataire est tenu de signer dans l'ordre. Par exemple, le deuxième signataire ne recevra une notification pour signer le document qu'une fois que le premier signataire aura terminé sa signature. Le code suivant permet d'effectuer ce qui suit :

.WithSigner(SignerBuilder.NewSignerWithEmail("signer1@xyz.com")
    .WithFirstName("FirstNameSigner1")
    .WithLastName("LastNameSigner1")
    .SigningOrder(1)
)
.WithSigner(SignerBuilder.NewSignerWithEmail("signer2@xyz.com")
    .WithFirstName("FirstNameSigner2")
    .WithLastName("LastNameSigner2")
    .SigningOrder(2)
)
.WithSigner(SignerBuilder.NewSignerWithEmail("signer3@xyz.com")
    .WithFirstName("FirstNameSigner3")
    .WithLastName("LastNameSigner3")
    .SigningOrder(3)
)
.WithSigner(SignerBuilder.NewSignerWithEmail("signer4@xyz.com")
    .WithFirstName("FirstNameSigner4")
    .WithLastName("LastNameSigner4")
    .SigningOrder(4)
)

Modifier votre flux de travail du signataire

Après avoir créé votre transaction, vous pouvez changer l'ordre de signature. Dans cet exemple, l'ordre de signature des deux premiers signataires est modifié.

afterReorder = eslClient.GetPackage(packageId);
afterReorder.GetSigner(email2).SigningOrder = 1;
afterReorder.GetSigner(email1).SigningOrder = 2;
eslClient.PackageService.OrderSigners(afterReorder);

Si vous avez déjà envoyé votre transaction, vous devrez changer son statut pour ÉBAUCHE avant de pouvoir mettre à jour le flux de travail des signataires.

Résultats

Après avoir exécuté votre code, si vous vous connectez à OneSpan Sign et accédez à votre transaction, vous verrez votre ordre de signature.

API REST

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

Lors de la création d'une transaction, il se peut que plusieurs signataires doivent signer plusieurs documents. Par conséquent, vous pouvez souhaiter contrôler le débit de l'Signer Experience. Avec OneSpan Sign, vous pouvez définir l'ordre dans lequel plusieurs signataires participent, ou l'ordre dans lequel plusieurs documents sont signés par un signataire. Le flux de travail des signataires détermine l'ordre dans lequel plusieurs signataires peuvent participer à l'Signer Experience. Par exemple, un signataire avec un ordre de signature 1 signifie qu'il signera en premier.

Création d'un flux de travail de signataire

Dans cet exemple, il y a quatre signataires, et chaque signataire est tenu de signer dans l'ordre. Par exemple, le deuxième signataire ne recevra une notification pour signer le document qu'une fois que le premier signataire aura terminé sa signature. Le code suivant permet d'effectuer ce qui suit :

Requête HTTP

 POST /api/packages 

En-têtes HTTP

Accept: application/jsonContent-Type: 
application/json
Authorization: Basic api_key 

Données utiles de la demande

{
  "roles": [
    {
      "id": "role1",
      "index": 1,
      "type": "SIGNER",
      "signers": [
        {
          "email": "signer1@xyz.com",
          "firstName": "FirstNameSigner1

Pour une description complète de chaque champ, voir le tableau des données utiles de la demande ci-dessous.

Données utiles de la réponse

  { "id": "9sKhW-h-qS9m6Ho3zRv3n2a-rkI=" }  

Modification du flux de travail des rôles

Pour mettre à jour le flux de travail des rôles, vous devrez faire une demande PUT à :

Requête HTTP

 PUT /api/packages/{packageId}/roles 

En-têtes HTTP

Accept: application/json
Content-Type: application/json
Authorization: Basic api_key 

Données utiles de la demande

  [{ "id":"OGCBUbLGa7gR", "index":0 }, { "id":"CnvwToUWLPgW", "index":1 }]  

Modifier votre flux de travail du signataire

Après avoir créé votre transaction, vous pouvez changer l'ordre de signature. Dans cet exemple, l'ordre de signature des deux premiers signataires est modifié.

Si vous avez déjà envoyé votre transaction, vous devrez changer son statut pour ÉBAUCHE avant de pouvoir mettre à jour le flux de travail des signataires.

Résultats

Après avoir exécuté votre code, si vous vous connectez à OneSpan Sign et accédez à votre transaction, vous verrez votre ordre de signature.

Tableau des données utiles de la demande

APEX SDK

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.  

Lors de la création d'une transaction, il se peut que plusieurs signataires doivent signer plusieurs documents. Par conséquent, vous pouvez souhaiter contrôler le débit de l'Signer Experience. Avec OneSpan Sign, vous pouvez définir l'ordre dans lequel plusieurs signataires participent, ou l'ordre dans lequel plusieurs documents sont signés par un signataire. Le flux de travail des signataires détermine l'ordre dans lequel plusieurs signataires peuvent participer à l'Signer Experience. Par exemple, un signataire avec un ordre de signature 1 signifie qu'il signera en premier.

Création d'un flux de travail de signataire

Dans cet exemple, il y a quatre signataires, et chaque signataire est tenu de signer dans l'ordre. Par exemple, le deuxième signataire ne recevra une notification pour signer le document qu'une fois que le premier signataire aura terminé sa signature. Le code suivant permet d'effectuer ce qui suit :

// Method1: add signing order when creating role

ESignLiveAPIObjects.Role role1 = new ESignLiveAPIObjects.Role();
role1.id = 'signer1';
role1.index = 1;
role1.signers = sdk.createRolesSigner('FirstNameSigner1', 'LastNameSigner1', 'signer1@xyz.com', 'Applicant', 'xxx Company');
sdk.helper.createRole(packageId, role1);

ESignLiveAPIObjects.Role role2 = new ESignLiveAPIObjects.Role();
role2.id = 'signer2';
role2.index = 2;
role2.signers = sdk.createRolesSigner('FirstNameSigner2', 'LastNameSigner2', 'signer2@xyz.com', 'Director', 'ABC Bank');
sdk.helper.createRole(packageId, role2);

ESignLiveAPIObjects.Role role3 = new ESignLiveAPIObjects.Role();
role3.id = 'signer3';
role3.index = 3;
role3.signers = sdk.createRolesSigner('FirstNameSigner3', 'LastNameSigner3', 'signer3@xyz.com', 'Applicant', 'xxx Company');
sdk.helper.createRole(packageId, role3);

ESignLiveAPIObjects.Role role4 = new ESignLiveAPIObjects.Role();
role4.id = 'signer4';
role4.index = 4;
role4.signers = sdk.createRolesSigner('FirstNameSigner4', 'LastNameSigner4', 'signer4@xyz.com', 'Director', 'ABC Bank');
sdk.helper.createRole(packageId, role4);

Modifier votre flux de travail du signataire

Après avoir créé votre transaction, vous pouvez changer l'ordre de signature. Dans cet exemple, l'ordre de signature des deux premiers signataires est modifié.

  sdk.setSigningOrder('packageId', 'signer1',2); sdk.setSigningOrder('packageId', 'signer2',1);  

Si vous avez déjà envoyé votre transaction, vous devrez changer son statut pour ÉBAUCHE avant de pouvoir mettre à jour le flux de travail des signataires.

Résultats

Après avoir exécuté votre code, si vous vous connectez à OneSpan Sign et accédez à votre transaction, vous verrez votre ordre de signature.