Changer de destinataire

Java SDK.NET SDKREST APIAPEX SDK

Java SDK

DocumentPackage superDuperPackage = PackageBuilder.newPackageNamed("Change Signer Example")
    .withSigner(
        SignerBuilder.newSignerWithEmail("mail32@example.com")
            .withFirstName("John")
            .withLastName("Smith")
            .canChangeSigner() // allow signer to be changed
    )
    .withDocument(
        DocumentBuilder.newDocumentWithName("First Document")
            .fromFile("C:/Users/hhaidary/Desktop/PDFs/doc1.pdf")
            .withSignature(
                SignatureBuilder.signatureFor("mail32@example.com")
                    .onPage(0)
                    .atPosition(500, 100)
            )
    )
    .build();

Kit de développement logiciel (SDK) .NET

DocumentPackage superDuperPackage = PackageBuilder.NewPackageNamed("Change Signer Example")
    .WithSigner(
        SignerBuilder.NewSignerWithEmail("mail32@example.com")
            .WithFirstName("John")
            .WithLastName("Smith")
            .CanChangeSigner() // allow signer to be changed
    )
    .WithDocument(
        DocumentBuilder.NewDocumentNamed("First Document")
            .FromFile("C:/Users/hhaidary/Desktop/PDFs/doc1.pdf")
            .WithSignature(
                SignatureBuilder.SignatureFor("mail32@example.com")
                    .OnPage(0)
                    .AtPosition(500, 100)
            )
    )
    .Build();

REST API

Pour télécharger l’exemple de code complet, consultez notre site Code Share .

La fonctionnalité Changer de destinataire permet à un destinataire de déléguer sa signature à un autre destinataire. Le destinataire délégataire doit fournir l’adresse e-mail et le nom complet du délégataire. Si vous le souhaitez, le destinataire délégataire peut également fournir un message électronique au délégué. Les deux destinataires sont informés du changement de destinataire et reçoivent une copie du message électronique. Si un destinataire a délégué sa signature, le créateur de la transaction en est également informé.

Pour ce faire, le code suivant :

Requête HTTP

  POST /api/packages/{packageId}/roles  

En-têtes HTTP

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

Charge utile de la demande

{
  "id": "Signer5",
  "reassign": true,
  "type": "SIGNER",
  "signers": [
    {
      "email": "mail32@example.com",
      "firstName": "John",
      "lastName": "Smith",
      "id": "Signer5"
    }
  ],
  "name": "Signer5"
}

Pour une description complète de chaque champ, consultez le tableau Charge utile de la demande ci-dessous.

Charge utile de réponse

{
  "id": "Signer5",
  "data": null,
  "specialTypes": [],
  "emailMessage": null,
  "attachmentRequirements": [],
  "locked": false,
  "reassign": true,
  "index": 0,
  "signers": [
    {
      "group": null,
      "language": "en",
      "signature": null,
      "id": "Signer5",
      "delivery": {
        "provider": false,
        "email": false,
        "download": false
      },
      "auth": {
        "scheme": "NONE",
        "challenges": []
      },
      "knowledgeBasedAuthentication": null,
      "data": null,
      "title": "",
      "company": "",
      "email": "mail32@example.com",
      "firstName": "John",
      "lastName": "Smith",
      "external": null,
      "updated": "2017-11-16T16:53:01Z",
      "phone": "",
      "professionalIdentityFields": [],
      "userCustomFields": [],
      "address": null,
      "created": "2017-11-16T16:53:01Z",
      "name": "",
      "specialTypes": []
    }
  ],
  "name": "Signer5",
  "type": "SIGNER"
}

Résultats

Après avoir exécuté votre code, les destinataires de la transaction auront la possibilité de réattribuer leurs responsabilités de signature à quelqu’un d’autre.

Tableau des données utiles de la demande

APEX SDK

ESignLiveAPIObjects.Role role = new ESignLiveAPIObjects.Role();
ESignLiveAPIObjects.Signer signer = new ESignLiveAPIObjects.Signer();

signer.firstName = 'firstName';
signer.lastName = 'lastName';
signer.email = 'signer@example.com';
signer.name = 'signer1';
signer.id = 'signer1';

role.signers = new List<ESignLiveAPIObjects.Signer> { signer };
role.id = 'signer1';
role.reassign = true; // allow change signer