DocuSign REST API：添加具有文档可见性的抄送收件人

Question

我可以使用 REST API 成功地将收件人添加到现有的 DocuSign 信封。当我将签名者添加到信封时，我还可以使用 excludeDocuments 元素指定文档可见性。但是，我无法使用此参数为抄送收件人设置文档可见性。我的业务要求是一个抄送收件人不应收到信封中的某些文件。

以下是我的 JSON 请求：

{
  "carbonCopies": [
    {
      "email": "123@hotmail.com",
      "excludedDocuments": [
        "1"
      ],
      "name": "testCC1",
      "recipientId": "5"
    }
  ],
  "signers": [
    {
      "email": "123@gmail.com",
      "excludedDocuments": [
        "1"
      ],
      "name": "ssgmail signer",
      "recipientId": "7"
    }
  ]
}

以上两个收件人都添加成功。第一个收件人（签名者）设置正确，不可见文档 1。第二个收件人（抄送）设置为完全可见。

有趣的是，我可以转到 DocuSign 界面并更正信封以删除抄送收件人的可见性。所以我认为 DocuSign 确实支持这个功能。

知道如何使用 rest/soap API 为现有信封的抄送收件人添加/更改单个文档的可见性吗？

注意：-

1. 坦率地说，我不知道如何使用 API 查询信封/收件人中的文档可见性。为此，我转到正确信封屏幕中的“查看/修改文档可见性”链接以检查当前可见性设置。

2. 我已将文档可见性设置为“必须签名才能查看，除非发件人帐户”以启用文档可见性功能。

Answer 1

您在 JSON 请求中缺少一个属性，"enforceSignerVisibility":true，我有以下请求，它与 DocumentVisibility 一起工作正常：

{
  "documents": [
    {
      "documentBase64": "<Base64>",
      "documentId": "1",
      "fileExtension": "docx",
      "name": "Challenge3"
    },
    {
      "documentBase64": "<Base64>",
      "documentId": "2",
      "fileExtension": "docx",
      "name": "Challenge4"
    }
  ],
  "emailSubject": "Test Subject",
  "recipients": {
    "signers": [
      {
        "email": "Signer@gmail.com",
        "name": "Signer",
        "recipientId": "2",
        "routingOrder":1,
        "excludedDocuments":[2],
        "tabs": {
          "signHereTabs": [
            {
              "documentId": "1",
              "recipientId": "1",
              "xPosition": "300",
              "yPosition": "300",
              "pageNumber":1
            }
          ]
        }
      }
    ],
    "carbonCopies": [
      {
        "email": "CC@gmail.com",
        "name": "CC",
        "recipientId": "1",
        "routingOrder":1,
        "excludedDocuments":[1]
      }
    ]
  },
  "status": "sent",
  "enforceSignerVisibility":true
}