使用TemplateID创建信封时标准与自定义字段预填充失败

云上老周

2026-7-2

DocuSign API预填充字段不生效问题解决

问题分析

你通过模板创建信封的API请求返回成功，但预填充的日期和全名字段未生效，核心原因分为两类：

1. 系统字段无法手动预填充

dateSignedTabs是DocuSign的系统内置字段，用于记录收件人完成签名的时间，该字段的值由DocuSign自动生成，无法通过API手动设置预填充值。如果需要预填充一个自定义日期，需在模板中使用普通的dateTabs（日期文本字段）替代。

2. 标签匹配或配置错误

针对fullNameTabs预填充失效，需检查以下几点：

确认模板中对应QA角色的全名标签的tabLabel与API请求中的name完全一致（包括大小写、空格，DocuSign对tabLabel区分大小写）。
检查模板中该标签的“分配给”角色是否为QA：在模板编辑器中，选中标签后查看分配对象，确保和API中指定的roleName匹配。
确认模板中的标签类型确实是fullNameTabs：若模板中使用的是普通文本字段（textTabs），API中用fullNameTabs设置值不会生效，需对应调整API中的标签类型。

修正后的API请求示例

将dateSignedTabs替换为dateTabs，并确保标签配置匹配：

{
  "emailSubject": "This request is sent from a Template",
  "status": "sent",
  "templateId": "{templateID}",
  "templateRoles": [
    {
      "email": "test@test.com",
      "name": "Test User",
      "roleName": "QA",
      "tabs": {
        "dateTabs": [
          {
            "tabLabel": "date",
            "value": "01-01-2024"
          }
        ],
        "fullNameTabs": [
          {
            "tabLabel": "name",
            "value": "Nilesh sawant"
          }
        ]
      }
    }
  ]
}