DocuSign信封中如何跳过可选TemplateRole并删除关联SignHere标签

完全可以条件删除可选的TemplateRole及其绑定的所有SignHere标签，不需要修改原模板配置，仅调整创建信封的请求逻辑即可。

错误原因排查 #

你收到INVALID_EMAIL_ADDRESS_FOR_RECIPIENT报错，是因为请求的templateRoles数组中仍然保留了该可选签署人的角色条目，但没有填入有效邮箱信息，而非「不填写该角色就会触发错误」。

正确实现步骤 #

• 首先确认模板中该可选签署人的角色属性没有勾选「必填」，否则DocuSign会强制要求传递该角色的信息
• 构造templateRoles数组时，仅在本次流程需要该可选签署人时，才将其角色对象加入数组：

  # 示例基于DocuSign Python SDK，其他语言SDK逻辑一致
  from docusign_esign import TemplateRole
  
  template_roles = []
  # 固定添加必填签署人
  template_roles.append(TemplateRole(
      email="signer1@example.com",
      name="必填签署人姓名",
      role_name="Signer1" # 和模板里配置的角色名完全一致
  ))
  
  # 可选签署人仅在需要时添加
  if need_optional_signer:
      template_roles.append(TemplateRole(
          email="signer2@example.com",
          name="可选签署人姓名",
          role_name="Signer2" # 和模板里配置的角色名完全一致
      ))
  

• 不需要手动删除该角色关联的SignHere标签：只要创建信封的请求中没有匹配对应roleName的TemplateRole，DocuSign会自动隐藏该角色绑定的所有签核标签，不会出现在最终信封中。

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