如何通过DocuSign API实现多收件人按顺序签署信封

要实现第一个收件人完成签署后，第二个收件人才收到通知的效果，核心是给收件人设置路由顺序（routingOrder），DocuSign会严格按照这个顺序触发收件人的签署流程。具体步骤如下：

1. 给收件人指定路由顺序 #

在构建收件人信息时，为每个收件人添加routingOrder字段，数值越小优先级越高。比如：

• 第一个需要签署的收件人，routingOrder设为1
• 第二个收件人，routingOrder设为2

只有当前一个路由顺序的所有收件人都完成签署（或完成指定操作），下一个路由顺序的收件人才会收到签署邮件。

2. 构建信封创建请求 #

以下是典型的JSON请求体示例，包含两个顺序签署的收件人：

{
  "emailSubject": "请签署这份文档",
  "status": "sent",
  "documents": [
    {
      "documentId": "1",
      "name": "需要签署的文档.pdf",
      "documentBase64": "<base64编码的文档内容>"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "first_signer@example.com",
        "name": "第一个签署人",
        "recipientId": "1",
        "routingOrder": "1",
        "tabs": {
          "signHereTabs": [
            {
              "documentId": "1",
              "pageNumber": "1",
              "xPosition": "100",
              "yPosition": "100"
            }
          ]
        }
      },
      {
        "email": "second_signer@example.com",
        "name": "第二个签署人",
        "recipientId": "2",
        "routingOrder": "2",
        "tabs": {
          "signHereTabs": [
            {
              "documentId": "1",
              "pageNumber": "1",
              "xPosition": "200",
              "yPosition": "100"
            }
          ]
        }
      }
    ]
  }
}

3. 调用API发送信封 #

将上述JSON作为请求体，调用DocuSign的Envelopes::create API（POST请求，端点为/v2.1/accounts/{accountId}/envelopes）。

当第一个签署人完成签署后，DocuSign会自动向第二个签署人发送签署通知邮件，无需额外调用API触发。

注意事项 #

• 每个收件人的recipientId必须唯一，建议从1开始递增
• 如果需要同一顺序多个收件人同时签署，可给他们设置相同的routingOrder值
• 若需更复杂的路由规则（如条件分支），可结合routingRules字段配置，但基础的顺序签署仅需routingOrder即可实现

内容的提问来源于stack exchange，提问作者Manish Kumar Pathak