CANNOT_EXCLUDE_DOCUMENT：不能为此收件人排除此文档

Question

我看到这个测试 eSign 交易有一个奇怪的行为：

{
    "compositeTemplates": [
        {
            "inlineTemplates": [
                {
                    "documents": [
                        {
                            "documentBase64": "BASE64STRING",
                            "documentId": "7",
                            "fileExtension": "PDF",
                            "name": "DOCUMENT7"
                        }, {
                            "documentBase64": "BASE64STRING",
                            "documentId": "10",
                            "fileExtension": "PDF",
                            "name": "DOCUMENT10"
                        }, {
                            "documentBase64": "BASE64STRING",
                            "documentId": "12",
                            "fileExtension": "PDF",
                            "name": "DOCUMENT12"
                        }, {
                            "documentBase64": "BASE64STRING",
                            "documentId": "17",
                            "fileExtension": "PDF",
                            "name": "DOCUMENT17"
                        }, {
                            "documentBase64": "BASE64STRING",
                            "documentId": "18",
                            "fileExtension": "PDF",
                            "name": "DOCUMENT18"
                        }, {
                            "documentBase64": "BASE64STRING",
                            "documentId": "19",
                            "fileExtension": "PDF",
                            "name": "DOCUMENT19"
                        }, {
                            "documentBase64": "BASE64STRING",
                            "documentId": "20",
                            "fileExtension": "PDF",
                            "name": "DOCUMENT20"
                        }
                    ],
                    "recipients": {
                        "signers": [
                            {
                                "email": "SIGNER1@mailinator.com",
                                "excludedDocuments": [
                                    "20"
                                ],
                                "name": "SIGNER1",
                                "recipientId": "2",
                                "tabs": {
                                    "signHereTabs": [
                                        {
                                            "documentId": "7",
                                            "pageNumber": "1",
                                            "recipientId": "2",
                                            "xPosition": "45",
                                            "yPosition": "628"
                                        }
                                    ]
                                }
                            }, {
                                "email": "SIGNER2@mailinator.com",
                                "excludedDocuments": [
                                "7"
                            ],
                                "name": "SIGNER2",
                                "recipientId": "3",
                                "tabs": {
                                    "signHereTabs": [
                                        {
                                            "documentId": "20",
                                            "pageNumber": "1",
                                            "recipientId": "3",
                                            "xPosition": "45",
                                            "yPosition": "628"
                                        }
                                    ]
                                }
                            }
                        ]
                    },
                    "sequence": "1"
                }
            ]
        }, {
            "serverTemplates": [
                {
                    "sequence": "1",
                    "templateId": "f7e03095-8fd0-4c0a-9ec4-50d8fcee9b17"
                }
            ]
        }
    ],
    "emailSubject": "Test eSign",
    "enforceSignerVisibility": "True",
    "status": "sent"
}

当我将它发送到 DocuSign v2.1 api {{baseUrl}}/v2.1/accounts/{{accountId}}/envelopes我收到以下错误：

{
    "errorCode": "CANNOT_EXCLUDE_DOCUMENT",
    "message": "This document cannot be excluded for this recipient. Recipient: SIGNER2 cannot be excluded from Document:DOCUMENT20"
}

但是，正如您在收件人“SIGNER2”中看到的那样，排除文档列表不包含文档 20，而是包含以下文档：

"excludedDocuments": [
    "7"

],

如果我从excludedDocuments 列表中删除文档“7”，那么事务将通过go。 我已经用任何模板进行了测试，但同样失败了。 如果我不使用CompositeTemplate结构，它会成功。

有什么我错过或没有看到的吗？

提前致谢

Answer 1

在我创建 DocuSign 案例 4 个多月后，它终于被审查并认为是 DocuSign API 上的错误。 此错误已被宣布为将来会修复的问题。

此问题目前处于开放状态，并由我们的工程团队处理，他们提供了解决方法。 这个问题是由于compositeTemplate调用重新生成了文档ID，所以不是尊重为文档ID提供的值，而是重新编号文档，在创建的信封DOCUMENT20中确实有一个ID 7，所以这就是错误的来源。 要删除 DOCUMENT20，您必须在调用正文中发送排除文档 7。

Answer 2

Go 到设置 > 发送设置 > 文档可见性并将文档可见性更改为“必须签名才能查看，除非发件人”如果这不起作用，请打开一个案例并确保包含 API 请求日志。