DocuSign API中signerAttachmentTabs重复问题咨询与解决

问题原因 #

• DocuSign对不同类型标签的合并逻辑存在差异：signHereTabs属于签名核心标签，当同一收件人（匹配recipientId、邮箱、姓名）在多个复合模板中对应PDF签名字段时，系统会自动合并为单个标签；但signerAttachmentTabs属于附加类标签，默认不触发自动合并，每个复合模板中手动添加的该标签都会被视为独立必填项，即使位置重叠也会保留多个实例。
• 你在3个文档对应的复合模板中都手动添加了signerAttachmentTab，没有限定仅在单个模板中配置，导致最终信封生成了3个独立的附件上传要求。

解决方法 #

• 仅在单个复合模板中添加signerAttachmentTab：无需在所有文档模板中重复添加，选择任意一个复合模板配置该标签即可。收件人完成一次文件上传后，整个信封的附件要求就会满足，不会出现多次上传的情况。
• 统一标签标识并启用合并配置：如果需要在多个模板中配置，确保所有signerAttachmentTab的tabLabel完全一致，同时在收件人配置中设置mergeTabs: true。不过这种方式对附件标签的合并支持不如签名标签稳定，优先推荐第一种方法。
• 确认收件人匹配一致性：再次检查所有复合模板中的收件人信息，保证recipientId、email、name完全相同，避免系统误判为不同收件人（你的场景中signHereTabs已合并，说明这部分大概率没问题，但可以做二次验证）。

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