Docusign API:成功提交了textTabs的JSON,但值不会出现在文档中

时间:2018-02-07 15:09:20

标签: python json docusignapi

我能够成功将包含textTabsfullName标签的JSON提交到Docusign API([baseURL] /envelopes处的POST),调用模板,我确实收到了要签署的文件:

{ "accountId": "xxx",
  "status": "sent",
  "emailSubject": "Please sign this document",
  "emailBlurb": "Here's a document for you to sign",
  "templateId": "xxxx",
  "templateRoles": [
        {
        "email": "test@email.com",
        "name": "Test Recipient",
        "tabs": 
              { "textTabs":
                [{"tabLabel": "\\*Doc_Name",
                  "name": "Doc_Name",
                  "value": "Doc Value Goes Here",
                  "DocumentId": "1",
                  "PageNumber": "1"},

                  {"tabLabel": "\\*Doc_Phone",
                  "name": "Doc_Phone",
                  "value": "8675309",
                  "DocumentId": "1",
                  "PageNumber": "1"},


                  {"tabLabel": "\\*Doc_Fax",
                  "name": "Doc_Fax",
                  "value": "5551212",
                  "DocumentId": "1",
                  "PageNumber": "1"} ],

                "fullNametabs":
                  [ {"tabLabel": "FULLName",
                  "name": "FullName",
                  "value": "The Full Name Goes Here",
                  "DocumentId": "1",
                  "PageNumber": "1"}]

                          } 
                  ,

        "roleName": "parent_signer" }  ] }

我的模板在该模板的文档中包含具有相同数据标签的自定义字段:

https://imgur.com/a/9c0dJ

https://imgur.com/Qj9NhSj

在模板的文档中,我将这些字段放在文档正文中:

https://imgur.com/a/HCTRe

但是,当文档到达签名时,这些字段不会像我预期的那样预先填充。出现该文档,但没有预先填充的字段:

https://imgur.com/kzHxxds

信封标签,模板标签和自定义字段之间是否存在差异?

1 个答案:

答案 0 :(得分:1)

收件人未在信封中看到标签的原因是roleName区分大小写,并且您在JSON请求中指定了roleName的大小写{{1} }})与模板(parent_signer)中指定的收件人角色名称的大小写不匹配。

此外,您还可以对JSON请求进行其他一些改进:

  • 您不需要指定Parent_signer - 它已在请求URI中指定,因此将其包含在请求正文中是多余且不必要的。

  • 您不需要为每个标签指定accountIdnamedocumentId - 因为模板已包含标签,DocuSign已经知道它们在哪里应出现在文件中。

  • 您不需要在请求正文中指定“全名”标签 - DocuSign将自动使用收件人的名称填充“全名”标签(您实际上无法指定值对于这种类型的选项卡,因为DocuSign始终使用签名者的名称自动设置选项卡值。

这里再次提出您的JSON请求,并应用了这些更改:

pageNumber