Docusign REST API 附件

Question

我正在尝试将带有附件占位符的文档发送给收件人，以便在他们打开 DocuSign 邮件时，他们可以附加其他文档。

我所做的是，创建一个信封并在响应中获取envelopId

{
  "status": "sent",
  "emailSubject": "Example of one recipient, type signer",
  "documents": [{
    "documentId": "1",
    "name": "contract.pdf",
    "documentBase64": "base64 document bytes...",
  }],
  "recipients": {
    "signers": [{
      "name": "Lisa Simpson",
      "email": "lisa@email.com",
      "recipientId": "1",
      "routingOrder": "1",
      "tabs": {
        "signHereTabs": [{
          "xPosition": "150",
          "yPosition": "200",
          "documentId": "1",
          "pageNumber": "1"
        }],
      }
    }]
  }
}

附加附件，来自我得到的文档

PUT /v2/accounts/{accountId}/envelopes/{envelopeId}/attachments

但是，我无法理解的是，我用一个文档创建一个信封并将其发送给收件人，然后我得到一个envelopeId

在那之后，我为什么要放置附件占位符？信封（DocuSign 邮件）已发送给收件人。

如何通过 DocuSign REST API 发送附件占位符？

Answer 1

信封附件是元数据。我想你想让收件人上传并在信封上附加一个文件？为此，您添加一个“signerAttachment”选项卡。该选项卡需要放置在文档的某个位置。将上传的文件附加到包含 signerAttachment 选项卡的文档或将文件添加为信封中的另一个文档的帐户配置选项将影响您获取上传的文档的方式。

"tabs": {
    "signHereTabs": [{
      "xPosition": "150",
      "yPosition": "200",
      "documentId": "1",
      "pageNumber": "1"
    }],
    "signerAttachmentTabs":[{
      "xPosition": "150",
      "yPosition": "500",
      "documentId": "1",
      "pageNumber": "1"
    }]
  }