Question

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

经过一番挖掘，我发现Docusign的eWitness功能确实可以完成我们需要我们的应用程序执行的操作。但是，我在描述如何使用此功能的API文档中找不到任何内容。

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

非常感谢您的帮助！

Answer 1

是的！

EnvelopeRecipients对象具有witnesses Docs for both的新属性。 witnesses是witness个对象的数组。

通过API发送信封时：

创建签名者收件人对象。记住您使用的收件人ID。
创建具有两个属性的见证收件人对象：收件人Id（一个新值）和见证人，设置为签名者的收件人ID。
为签署人收件人和见证人收件人创建一个SignHere选项卡。
发送信封。
签名人签名后，将要求他们提供见证人的姓名和电子邮件作为签名。
签名人签名后，见证人会收到一封电子邮件，使他们能够将文档作为见证人签名。

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

创建信封时，您可以设置证人的姓名/电子邮件，但我尚未对此进行测试。您也许还可以设置见证人的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"
              }
            ]
          }
        }
      ]
    }

是否可以使用eWitness功能发送信封？

1 个答案:

使用带有见证人的收件人的模板

JSON示例