如何使用docuSign Rest API在信封中记录多个文档?

时间:2013-11-20 18:17:41

标签: docusignapi

我正在创建能够正常工作的复合模板,而且我遇到了这个问题。

我正在添加2个模板以通过docusign进行签名。我为它们设置了路由顺序,如下所示:

 Form 1  
    Order 1   RoleName signer       test1@gmail.com
    Order 2   RoleName signer2      test2@gmail.com
 Form 2
    Order 1   RoleName dataEntry    test1@gmail.com
    Order 2   RoleName dataEntry2   test2@gmail.com

这将发送一封电子邮件至test@gmail.com。该用户在一个请求中完成表单1和表单2的所有字段。这就是我想要和期待的。但是,当test1@gmail.com完成他们的过程时,test2 @ gmail.com将收到2封不同的电子邮件。一个签署表单1,另一个签署表单2.我试图理解为什么test2@gmail.com与test1@gmail.com的工作方式不同。 有人可以帮助解释接收test2@gmail.com的2封单独电子邮件的原因是什么,如果有办法解决它?

注意:当我通过docuSign网站执行此操作时,它不允许同一个收件人在同一个routingOrder中。它会带来错误:

  The role 'signer' conflicts with 'dataEntry'
  The role 'signer2' conflicts with 'dataEntry2'

这种行为对我来说似乎很奇怪,因为我可以使用docusign rest API发送信封。 如果有人可以给我一些澄清,我也很感激

谢谢!

1 个答案:

答案 0 :(得分:3)

我无法重复您描述的问题。这就是我所做的,结果:

  • 我在DocuSign中创建了两个单独的模板,每个模板都有一个文档和两个收件人/签名者(您在上面的问题中指定了角色名称和路由订单)。

  • 我使用REST API(下面包含的JSON请求)从这两个模板创建/发送信封,为收件人1和收件人2指定相同的收件人信息(姓名/电子邮件/收件人ID /路由顺序) 内嵌模板结构。

  • 结果:收件人1首先收到一封电子邮件,打开信封,然后立即签署两份文件。然后收件人2收到一封电子邮件,打开信封,并立即签署两份文件。此时信封状态为“已完成”。

我在下面提供了我的API请求供您参考 - 或许可以与您正在进行的操作进行比较/对比?此外 - 确保收件人信息(姓名/电子邮件/收件人ID /路由顺序) 相同 (包括 案例 内联模板和第二个内联模板之间的每个收件人的强>) - 名称/电子邮件/收件人ID /路由顺序中的任何小差异,而DocuSign会将他们视为不同/不同的人(收件人)。

POST https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes

{
  "emailSubject": "Please sign",
  "emailBlurb": "Please sign...thanks!",
  "status": "sent",
  "compositeTemplates": [
  {
    "serverTemplates": [
    {
        "sequence" : 1,
        "templateId": "TEMPLATE_ID_1"
    }],
    "inlineTemplates": [
    {
        "sequence" : 2,
        "recipients": {
            "signers" : [{
                "email": "adamsemail@outlook.com",
                "name": "Adam Adamson",
                "recipientId": "1",
                "roleName": "signer",
                "routingOrder": "1"
              },
              {
                "email": "bobsemail@outlook.com",
                "name": "Bob Burns",
                "recipientId": "2",
                "roleName": "signer2",
                "routingOrder": "2"
              }
            ]
        }
    }]
  },
  {
    "serverTemplates": [
    {
        "sequence" : 1,
        "templateId": "TEMPLATE_ID_2"
    }],
    "inlineTemplates": [
    {
        "sequence" : 2,
        "recipients": {
            "signers" : [{
                "email": "adamsemail@outlook.com",
                "name": "Adam Adamson",
                "recipientId": "1",
                "roleName": "dataEntry",
                "routingOrder": "1"
              },
              {
                "email": "bobsemail@outlook.com",
                "name": "Bob Burns",
                "recipientId": "2",
                "roleName": "dataEntry2",
                "routingOrder": "2"
              }
            ]
        }
    }]
  }]  
}