Docusign API中DocGen表单字段值失效，占位符未解析问题求助

问题概述 #

通过REST API创建并发送信封时，文档中的DocGen表单字段始终显示未解析的占位符（如{{Agreement Party}}、{{demo_field}}），而非API传入的实际值。API基础URL为：https://demo.docusign.net/restapi/v2.1/

模板字段信息 #

通过GET /templates/{templateId}确认模板包含以下两个DocGen表单字段：

1. 字段标签：Agreement Party
   • 内部名称：AgreementParty_displayName_Z2bXgzv
   • 完整路径：com.docusign.platform@1/AgreementParty/displayName
   • 类型：TextBox
2. 字段标签：demo_field
   • 内部名称：C_demo_field_value_1Xkjiv
   • 完整路径：account._771d9b65_90d3_4661_8916_9f42a88bc2eb.custom.fields@1/C_demo_field/value
   • 类型：TextBox

收件人信息 #

• 收件人角色：test_signer
• 收件人ID：55136564

已尝试的无效方法 #

• 在签署人标签下使用带locked: true的标准textTabs：字段仍显示未解析的{{placeholders}}
• 在签署人下使用prefillTabs：报错INVALID_TAB_OPERATION — 收件人不允许使用PrefillTab
• 在inlineTemplates内的recipients层级使用prefillTabs：字段仍显示为{{placeholders}}
• 在信封根层级使用prefillTabs：字段仍显示为{{placeholders}}
• 在根层级使用带documentId和docGenFormFieldList的docGenFormFields：字段仍显示为{{placeholders}}

方法5的示例Payload #

{
  "emailSubject": "Please sign this contract",
  "status": "sent",
  "compositeTemplates": [
    {
      "compositeTemplateId": "1",
      "serverTemplates": [
        { "sequence": "1", "templateId": "3cfaca9c-ffd5-4c16-a416-992ca05317b0" }
      ],
      "inlineTemplates": [
        {
          "sequence": "2",
          "recipients": {
            "signers": [
              {
                "name": "John Doe",
                "email": "startdeveloper3@gmail.com",
                "recipientId": "55136564",
                "roleName": "test_signer"
              }
            ]
          }
        }
      ]
    }
  ],
  "docGenFormFields": [
    {
      "documentId": "1",
      "docGenFormFieldList": [
        { "name": "AgreementParty_displayName_Z2bXgzv", "value": "John Doe" },
        { "name": "C_demo_field_value_1Xkjiv", "value": "Ritik Test" }
      ]
    }
  ]
}

当前状态与期望结果 #

• 当前状态：信封已成功创建并发送（HTTP 201），签署人收到邮件并可打开文档，但{{Agreement Party}}和{{demo_field}}字段仍为未解析的占位符文本。
• 期望结果：API请求中提供的DocGen表单字段值在文档交付给签署人前被解析并渲染为实际文本，签署人看到预填充的值（如"John Doe"和"Test"）且无法编辑。

疑问 #

1. 通过REST API程序化发送信封时，预填充DocGen表单字段（isAceGenDocument: true）的正确API方式是什么？
2. 是否需要调用单独的DocGen专用API端点？
3. compositeTemplates方式是否支持DocGen字段解析？
4. 模板或账户需额外配置吗？

内容的提问来源于stack exchange，提问作者Ritik Lakhotiya