时间戳

首页 > 解决方案 > 有没有办法使用 eWitness 功能发送信封？

docusignapi - 有没有办法使用 eWitness 功能发送信封？

问题描述

我目前正在开发一个文档签名和管理应用程序，它使用 Docusign API 来处理文档的签名。文件需要允许见证人签名，但我们不一定知道在发送信封时谁将担任见证人。该应用程序需要询问将在签名时见证的签名者。

经过一番挖掘，我发现了 Docusign 的 eWitness 功能，它正是我们需要我们的应用程序做的事情。但是，我在 API 文档中找不到任何描述如何使用此功能的内容。

理想情况下，我想使用 API 使用 eWitness 功能从模板创建和发送信封。

任何帮助是极大的赞赏！

标签： docusignapi

解决方案

是的！

该EnvelopeRecipients对象witnesses 对两者都有一个新的 Docs属性。witnesses是一个witness对象数组。

通过 API 发送信封时：

  1. 创建签名者收件人对象。记住您正在使用的收件人 ID。
  2. 创建一个具有两个属性的见证收件人对象：recipientId（一个新值）和 witnessFor，设置为签名者的收件人 ID。
  3. 为签名者收件人和见证收件人创建一个 SignHere 选项卡。
  4. 发送信封。
  5. 当签名者签名时，他们将被要求提供见证人的姓名和电子邮件以进行签名。
  6. 签名者签名后，见证人会收到一封电子邮件，使他们能够以见证人的身份签署文档。

签名者收件人可以是嵌入式签名者或“远程”签名者，并通过电子邮件接收他们的签名邀请。

您可以在创建信封时设置见证人的姓名/电子邮件，但我尚未对此进行测试。您也可以设置见证人的 clientUserId，以便为他们提供嵌入式签名体验，但我也没有测试过。（如果您测试这些流程中的任何一个，请告诉我们。）

与有见证人的收件人一起使用模板

要将模板与具有见证的收件人一起使用，只需创建role启用了见证的模板即可。然后在发送信封时使用模板并包含签名者收件人的角色定义（他们的姓名/电子邮件）。

JSON 示例

这是带有见证人的嵌入式签名收件人的工作 JSON。签名者将见证人的姓名/电子邮件输入嵌入式签名仪式。

  "envelopeDefinition": {
    "emailSubject": "Please sign the attached document",
    "status": "sent",
    "documents": [
      {
        "name": "Example document",
        "fileExtension": "pdf",
        "documentId": "1"
      }
    ],
    "recipients": {
      "signers": [
        {
          "email": "signer_email@example.com",
          "name": "Signer's name",
          "recipientId": "1",
          "clientUserId": "1000",
          "tabs": {
            "signHereTabs": [
              {
                "anchorString": "/sig1/",
                "anchorXOffset": "20",
                "anchorUnits": "pixels"
              }
            ]
          }
        }
      ],
      "witnesses": [
        {
          "recipientId": "2",
          "witnessFor": "1",
          "tabs": {
            "signHereTabs": [
              {
                "anchorString": "/sig1/",
                "anchorXOffset": "200",
                "anchorUnits": "pixels"
              }
            ]
          }
        }
      ]
    }

推荐阅读