DocuSign模板可变签署人数量问题：CC类型被错误修改求助

问题原因 #

当你跳过路由顺序3的签署人时，仅通过路由顺序指定后续CC收件人，DocuSign的自动匹配逻辑会误将这些CC收件人识别为签署人角色。这是因为系统默认按路由顺序的位置匹配模板角色，跳过中间的签署人后，后续位置的收件人会被填充到缺失的签署人槽位，从而覆盖了原本的CC类型。

修复方法 #

• 明确指定模板收件人标识：创建信封时，不要仅依赖路由顺序，而是通过模板中CC收件人的templateRecipientId或roleName关联，确保系统识别其原始的carbonCopy类型。
• 正确标记跳过签署人：不要直接省略路由3的签署人，而是在API请求的templateRoles中，为该签署人设置status: "skipped"，明确告知系统跳过该角色，而非让系统自动补全槽位。
• 强制指定收件人类型：在添加CC收件人时，显式设置recipientType: "carbonCopy"，覆盖系统的默认类型推断，确保类型不被篡改。

更优实现方案 #

• 动态角色配置：在模板中定义清晰的角色名称（如Signer1、Signer2、Signer3、CC_1至CC_4），创建信封时仅传入需要的签署人角色，未传入的角色会被系统自动忽略，不会影响CC的类型和路由顺序。
• 条件收件人功能：利用DocuSign模板的条件收件人设置，通过自定义字段判断是否需要启用第3位签署人。当不需要时，系统会自动跳过该收件人，所有CC收件人保持原始类型不变。
• Composite Templates组合：使用API的compositeTemplates参数，将模板与动态收件人配置分离，更精准地控制每个收件人的角色、类型和状态，彻底避免路由顺序导致的匹配错误。

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