关于Docusign多文档场景下documentId与锚点标签的技术问询

关于documentId属性有效性的问题 #

你的理解不正确，在多文档签署场景中，给带锚点的标签指定documentId是有效的，这个属性会限制锚点仅在指定的文档内搜索匹配，不会遍历所有文档。

官方博客中提到的「仅当不使用锚点字符串放置标签时，才需要documentId和pageNumber属性」，核心意思是使用锚点时可以不填写这两个属性（此时锚点会在所有上传的文档中搜索匹配），但并不代表填写后会失效。如果明确指定了documentId，锚点的搜索范围就会被限定在该文档内，这是符合DocuSign API实际运行逻辑的。

对应你给出的请求示例：

• 第一个signHereTab指定了documentId: "1"和anchorString: "[POS_A]"，只会在documentId为1的文档中查找[POS_A]的位置
• 第二个signHereTab指定了documentId: "2"和anchorString: "[POS_B]"，只会在documentId为2的文档中查找[POS_B]的位置

两份文档均包含相同锚点的情况 #

分两种场景：

1. 未指定documentId的锚点标签：DocuSign会在所有上传的文档中找到所有匹配该锚点字符串的位置，每个匹配位置都会自动生成对应的签名标签，签署人需要在所有这些位置完成签名。
2. 指定了documentId的锚点标签：只有对应documentId的文档内的锚点会被匹配识别，其他文档中的相同锚点不会生成签名标签。比如你示例中的配置，即便文档2里有[POS_A]、文档1里有[POS_B]，也不会被处理。

你的请求参数示例（格式化后） #

{
    "emailSubject": "Please sign attached doc",
    "emailBlurb": "Info to be signed",
    "documents": [
        {
            "documentId": "1",
            "documentBase64": "Base64 string",
            "name": "Testfile1.pdf"
        },
        {
            "documentId": "2",
            "documentBase64": "Base64 string",
            "name": "Testfile2.pdf"
        }

    ],
    "recipients": {
        "signers": [
            {
                "email": "abc@test.net",
                "name": "John Doe",
                "recipientId": "1",
                "routingOrder": "1",
                "tabs": {
                    "signHereTabs": [
                        {
                            "anchorString": "[POS_A]",
                            "documentId": "1"
                        },
                        {
                            "anchorString": "[POS_B]",
                            "documentId": "2"
                        }
                    ]
                }
            }
        ]
    },
    "status": "sent"
}

内容的提问来源于stack exchange，提问作者Chazg76