创建信封时传递模板选项卡值

Question

我知道存在一个与我要问的问题类似的问题，但这个问题是 4 年前提出的，但没有给出具体答案。问题链接是这里

我正在使用现有模板创建一个信封，一切都像黄油一样顺利。但是，当我尝试在模板中预填充选项卡值时，选项卡值不会添加到信封中。我尝试了两种不同的 JSON 请求，一种使用 tabId，另一种使用 tabLabel。他们都没有工作。

尝试1：

{
    "status":"sent",
    "emailSubject":"Testing with DocuSign",
    "templateId":"124faf68-3b42-43b9-9b6d-814d465e161d",
    "templateRoles":
        [{
            "roleName":"Climber",
            "name":"xyz",
            "email":"[email protected]",
            "clientUserId":"126789",
            "tabs":{
                "fullNameTabs":[{
                    "tabId":"bb56d91a-1665-4817-99a6-643c67defbc1",
                    "value":"abc"
                }],
                "companyTabs":[{
                    "tabId":"ba5p67cb-bcf5-42b0-aa04-a0cfec448ddc",
                    "value":"Temporary companyname"
                }]
            }
         }]
}

尝试2：

{
    "status":"sent",
    "emailSubject":"Testing with DocuSign",
    "templateId":"124faf68-3b42-43b9-9b6d-814d465e161d",
    "templateRoles":
        [{
            "roleName":"Climber",
            "name":"xyz",
            "email":"[email protected]",
            "clientUserId":"126789",
            "tabs":{
                "fullNameTabs":[{
                    "tabLabel":"CustomField1",
                    "value":"abc"
                }],
                "companyTabs":[{
                    "tabLabel":"Company 2fdbb190-2f3e-4d39-8202-e15b9a1c332a,
                    "value":"Temporary companyname"
                }]
            }
         }]
}

有人可以告诉我我是否做错了。

Answer 1

您无法使用 API 调用预填充

FullNameTab, EmailTab, CompanyTab, TitleTab

。当您的收件人开始签名过程时，

FullName

和

Email

选项卡会自动填充，DocuSign 知道签名者姓名和电子邮件，因为您已将这些值设置如下：

"name":"xyz",
"email":"[email protected]"

如果收件人有任何 DocuSign 帐户并且其用户配置文件中存在值，则 DocuSign 会自动添加

CompanyTab

和

TitleTab

。如果没有，那么这些选项卡将是文本字段，签名者可以输入他们的公司名称和头衔。

因此，如果您想预填充任何内容，则需要使用

TextTabs

，然后您可以使用 tablabel 使用 JSON 请求将值填充到这些文本选项卡中。

Answer 2

要通过 Create Envelope 请求填充选项卡值，您需要在请求正文中使用

compositeTemplates

结构。 下面是该请求结构的示例，它使用您在帖子中提供的数据，但填充单个

textTab

，而不是

companyTab

和

fullnameTab

。正如 Amit 在他的文章中提到的，

companyTab

和

fullnameTab

无法通过 API 设置。

POST https://demo.docusign.net/restapi/v2/accounts/ACCOUNT_NUMBER/envelopes

{
    "status" : "sent",
    "emailSubject": "Testing with DocuSign",
    "compositeTemplates": [
    {
        "serverTemplates": [
        {
            "sequence" : 1,
            "templateId": "124faf68-3b42-43b9-9b6d-814d465e161d"
        }],
        "inlineTemplates": [
        {
            "sequence" : 2,
            "recipients": {
                "signers" : [{
                    "roleName": "Climber",
                    "name": "xyz",
                    "email": "[email protected]",
                    "clientUserId": "126789",
                    "recipientId": "1",
                    "tabs": {
                      "textTabs": [
                          {
                              "tabLabel": "field1",
                              "value": "field-1-value"
                          }
                      ]
                    }
                }]
            }
        }]
    }]
}

Answer 3

{
  "templateId": "xxx-xxx-xxx",
  "templateRoles": [
    {
      "email": "[email protected]",
      "name": "xx",
      "roleName": "signer",
      "tabs": {
        "textTabs": [
                    
                    {
                      "tabLabel": "FONAME",
                      "value": "Custom_Field_Value 2"
                    }
        ]
      }
    },    
    {
      "email": "[email protected] ",
      "name": "xxx",
      "roleName": "cc" 
     
    }
  ],
  "status": "sent"
}