在信封到信封的基礎上重新定義模板上的收件人角色？

Question

我想將DocuSign模板重用於同一信封中的多個收件人。 模板非常簡單。 它有幾個簽名和日期簽名的塊。

收件人將具有不同的路由順序。 從我所看到的，我的API請求需要使路由順序和角色名稱與DocuSign模板匹配。 如果角色名稱和路由順序不匹配，我將在信封上得到一個空角色（具有所有簽名塊）。 我也嘗試過“在草稿中合並角色”。 空角色將合並到第二個收件人中，但是我丟失了該收件人的所有模板簽名塊。

有沒有一種方法可以使用模板，但可以修改模板接收者角色的定義？ 理想情況下，我想使用完全相同的模板，但為第二個收件人更改該角色的路由順序。 我想避免在DocuSign中創建新模板，因為我可能會遇到很多組合。

---

我想完成（更新）：

我想在一個信封中使用兩次相同的模板。 每個收件人將被分配到模板的單個副本。 最終信封應該有兩個收件人，兩個文檔，每個收件人只能訪問和查看其文檔。

問題在於模板的角色定義了路由順序。 路由順序“ 1”適用於使用該模板的第一個收件人，但是第二個收件人需要路由順序“ 2”。 （模板的角色在所有情況下都希望路由順序為“ 1”，但對於第二個接收者，我希望該值為“ 2”。）

---

示例模板信息：

• 模板名稱（出於示例目的）：測試模板1
• 角色名稱：申請人1
• 路由順序：1（如果我未定義路由順序，DocuSign仍將其視為“ 1”）

---

請求示例：

EnvelopeDefinition envDef = new EnvelopeDefinition();

var signer1 = new Signer()
{
    RecipientId = "1",
    Name = "First User 1",
    RoleName = "Applicant 1",
    Email = "fakeemail1@email.com",
    RoutingOrder = "1"
};

var signer2 = new Signer()
{
    RecipientId = "2",
    Name = "First User 2",
    RoleName = "Applicant 1",
    Email = "fakeemail2@email.com",
    RoutingOrder = "2"
};

envDef.CompositeTemplates = new List<CompositeTemplate>();

var composite1 = new CompositeTemplate()
{
    ServerTemplates = new List<ServerTemplate>()
    {
        new ServerTemplate("1", "Test Template #1 TEMPLATE_ID_GUID_HERE")
    },
    InlineTemplates = new List<InlineTemplate>()
    {
        new InlineTemplate()
        {
            Sequence = "1",
            Recipients = new Recipients()
            {
                Signers = new List<Signer>()
                {
                    signer1
                }
            }
        }
    }

};

var composite2 = new CompositeTemplate()
{
    ServerTemplates = new List<ServerTemplate>()
    {
        new ServerTemplate("2", "Test Template #1 TEMPLATE_ID_GUID_HERE")
    },
    InlineTemplates = new List<InlineTemplate>()
    {
        new InlineTemplate()
        {
            Sequence = "2",
            Recipients = new Recipients()
            {
                Signers = new List<Signer>()
                {
                    signer2
                }
            }
        }
    }

};

envDef.CompositeTemplates.Add(composite1);
envDef.CompositeTemplates.Add(composite2);
envDef.EnforceSignerVisibility = "true";

// Code to send envelope

注意 ：另外，由於信封中可能包含模板和上載文檔的各種組合，因此我使用的是復合模板。

謝謝！

Answer 1

這可以通過在創建信封時傳遞查詢參數change_routing_order=true來實現。 因此，用於創建信封的端點將是

https://{{EnvironmentVal}}/restapi/v2/accounts/{{AccountIdVal}}/envelopes?change_routing_order=true

和請求的主體將是

要求身體：

其中相同的templateId-076d9062-cfc7-408b-a47f-88c4b74af62b與相同的RoleName使用，但差異路由順序和差異簽名者詳細信息

{
   "compositeTemplates": [
      {
         "inlineTemplates": [
            {
              "recipients": {
                  "signers": [
                     {
                        "email": "email+internal@gmail.com",
                        "name": "John Doe",
                        "recipientId": "1",
                        "roleName": "Signer1",
                        "routingOrder": "1"
                     }
                  ]
               },
               "sequence": "2"
            }
         ],
         "serverTemplates": [
            {
               "sequence": "1",
               "templateId": "076d9062-cfc7-408b-a47f-88c4b74af62b"
            }
         ]
      },
      {
         "inlineTemplates": [
            {
               "recipients": {
                  "signers": [
                     {
                        "email": "email+internal2@gmail.com",
                        "name": "John Doe2",
                        "recipientId": "2",
                        "roleName": "Signer1",
                        "routingOrder": "2"
                     }
                  ]
               },
               "sequence": "2"
            }
         ],
         "serverTemplates": [
            {
               "sequence": "1",
               "templateId": "076d9062-cfc7-408b-a47f-88c4b74af62b"
            }
         ]
      }
   ],
   "status": "sent"
}