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
}