如何在DocuSign复合模板中设置文档显示顺序？已试Sequence选项无效

首先要明确：复合模板中的sequence是控制模板的应用优先级/合并顺序，并非直接控制最终信封内的文档显示顺序，这是很多人踩坑的核心原因。以下是针对性的解决步骤：

• 区分sequence与order的作用

  • sequence：用于定义多个复合模板之间的合并顺序，值为连续正整数（从1开始），重复值会导致DocuSign按模板ID自动排序，忽略自定义设置。
  • order：才是控制最终信封内文档显示顺序的关键字段，需要在每个文档的配置中明确设置。

• 正确配置示例（JSON片段）

{
  "compositeTemplates": [
    {
      "sequence": "1",
      "inlineTemplates": [
        {
          "sequence": "1",
          "documents": [
            {
              "documentId": "1",
              "name": "用户协议.pdf",
              "order": "1"
            }
          ]
        }
      ]
    },
    {
      "sequence": "2",
      "inlineTemplates": [
        {
          "sequence": "1",
          "documents": [
            {
              "documentId": "2",
              "name": "补充条款.pdf",
              "order": "2"
            }
          ]
        }
      ]
    }
  ]
}

• 常见问题排查
  • 若引用平台已有模板（serverTemplates），必须在inlineTemplates的documents数组中重写order字段，覆盖模板默认的文档顺序。
  • 确保order字段为字符串类型（DocuSign API要求数字转字符串），避免拼写错误（如大写Order）。
  • 检查所有复合模板的sequence值是否连续且无重复，否则会触发自动排序逻辑。

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