如何创建并实现能在创建信封时通过DocuSign API自动填写信息的模板

后端开发 2026-07-10

问题

我在使用DocuSign eSignature API的 复合模板,在创建信封时无法让 预填(由发送方填写)的文本标签 正确填充。


我在做的事情

  • 我构建了一个模板生成器,将PDF注释放置(通过Nutrient)
  • 这些会被转换为DocuSign模板中的 基于锚点的文本标签
  • 预填字段的创建方式如下:

  • Anchor: PreFillLegalCompanyName_GUID

  • TabLabel: LegalCompanyName

发送时:

  • 我检索标签
  • TabLabel → value 映射为(如 "LegalCompanyName" → "Test Customer LLC"
  • 使用内联模板发送数值

示例:

signer.Tabs = new Tabs
{
    TextTabs = new List<Text>
    {
        new Text
        {
            TabLabel = "LegalCompanyName",
            Value = "Test Customer LLC"
        }
    }
};

问题点

该标签确实存在于文档中,但在创建信封时没有填充数值。


我已经尝试过的方法

  • TabLabel 完全匹配(从模板中已验证)
  • 将标签应用到与服务器模板相同的收件人
  • 使用用于预填的单独内联模板
  • 验证锚字符串和标签元数据

以上尝试都未能使数值被填充。


问题/疑问

在使用 复合模板 时,正确填充 预填文本标签 的方式是什么?

  • 预填标签是否需要在模板中以不同的方式进行分配?
  • 是否应在特定的内联模板或收件人上下文中应用数值?
  • 通过 TabLabel 设置数值时,基于锚点的标签是否会有不同的行为?

期望结果

文档在收件人查看之前应已完成预填(例如 LegalCompanyName = "Test Customer LLC")。


非常感谢您的任何指点。

解决方案

使用带有复合模板的预填标签有一些规则。请查看文档以获取详细信息。 https://developers.docusign.com/docs/esign-rest-api/esign101/concepts/tabs/prefilled-tabs/

站内所有文章版权归属LeftHeroAI导航站,无授权禁止任何主体转载、抄袭、复制内容,亦不得私自架设镜像站点。一经侵权,本站将通过法律途径追责。

相关文章