如何通过DocuSign API使用create_document_tabs填充模板预填充字段？

你的实现思路是正确的，预填充字段（非收件人关联字段）确实可以通过create_document_tabs方法结合PrefillTabs来填充，以下是细节验证和优化建议：

正确点 #

• 预填充字段不属于收件人角色字段，因此无需放入TemplateRole中，单独调用create_document_tabs是符合DocuSign API设计的
• 代码中构造PrefillTabs并嵌套Text标签的方式，与官方推荐的预填充字段设置方法一致

需要注意的细节 #

• 文档ID匹配：代码中硬编码document_id='1'，需确保模板中的预填充字段所在文档在信封中的ID确实为1。从模板创建信封时，模板内的首个文档ID默认是1，若模板包含多个文档，需确认目标字段对应的文档ID
• Tab Label精确匹配：efg['label']必须与模板中预填充字段的**数据标签（Tab Label）**完全一致（区分大小写），比如你的project_name标签不能写成Project_Name
• 信封状态：当前信封状态设为created（草稿状态），此时修改预填充字段是允许的；若后续需要发送信封，需调用envelope_api.update_envelope将状态改为sent
• 批量字段处理：如果args['template_fields']包含多个预填充字段，代码中的列表推导式可以正确批量生成Text标签，但要保证每个字段的document_id都对应正确的文档

官方文档核心内容（翻译） #

预填充字段用于在信封发送前填充文档中的固定信息，这类字段不与特定收件人绑定。开发者可以通过EnvelopesApi的create_document_tabs方法，构造PrefillTabs对象来设置这些字段的值，设置时需要指定正确的文档ID、字段标签（Tab Label）和对应的值。

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