如何防止DocuSign收件人修改路由顺序（含新增收件人场景）？

针对你描述的场景——已经通过API锁定了原有收件人，在发件人视图中新增收件人后想阻止其路由顺序被修改，这里有两个可行的方案：

方案1：API层面配置默认锁定 #

如果你希望从根源上避免新增收件人的路由顺序被修改，可以通过两种API配置方式实现：

• 方式A：新增收件人后设置锁定参数
  当你通过UI添加收件人后，调用Envelopes::updateRecipients接口，给新增的收件人设置routingOrderLocked属性为true：

  {
    "signers": [
      {
        "recipientId": "新增收件人的ID",
        "routingOrderLocked": "true"
      }
    ]
  }
  

  设置后，该收件人的路由顺序就无法在UI中被调整了。

• 方式B：信封全局默认锁定（需权衡）
  在创建信封时，除了你已有的templateRequired和templateLocked配置，可以额外添加lockRecipients: true的信封级属性。这个设置会让所有收件人（包括后续新增的）的核心属性（含路由顺序）被锁定，但会同时限制其他收件人属性的编辑，需要根据你的业务需求判断是否适用。

方案2：UI手动锁定（即时生效） #

如果只是需要在UI操作时临时锁定新增收件人的路由顺序，可以按以下步骤操作：

1. 在发件人视图的「编辑收件人」页面，找到新增的收件人
2. 点击该收件人右侧的「更多操作」图标（三个点）
3. 勾选「锁定路由顺序」选项，保存后即可生效

额外提示 #

routingOrderLocked是收件人对象的专属属性，专门用于控制路由顺序的可编辑性，这个属性属于高级配置，确实容易在官方文档中被忽略。如果需要批量处理多个新增收件人，批量调用更新接口会更高效。

内容的提问来源于stack exchange，提问作者h.kozno