通过API填充的DocuSign表单管理员副本空白问题咨询

问题背景 #

我通过DocuSign API配置信封，将自建门户的输入内容填充到模板预先创建的文本框字段中，同时设置将填充后的模板副本发送给管理员。目前遇到的问题是：收件人收到的副本能正常显示填充内容，但管理员收到的副本始终为空白。我不确定是否需要付费账户解锁相关功能，已尝试修改模板设置但无效，希望找到解决方案，让管理员和收件人均能收到填充完整的协议副本。

编辑记录 #

编辑2

我已将除签署日期和签名外的字段改为预填充标签（pre-fill tabs），标签与原发送方标签一致，是否需要修改信封定义？

编辑3

使用预填充标签时，信封定义应如何修改？

附原始信封定义代码（存在语法错误）：

envelope_definition = {
                    "status": "sent",
                    "templateId": template_id, # 模板ID（GUID）
                     "templateRoles": [
                        {
                            "email": recipientEmail,
                            "name": companyName,
                            "roleName": "signer",
                            "tabs": {
                               
                                "textTabs": [
                                    {
                                        "tabLabel": "company_name",
                                        "value": companyName  # 替换为目标值
                                    },
                                    {
                                        "tabLabel": "recipient_email",
                                        "value": recipientEmail  # 替换为目标值
                                    },
                                    {
                                        "tabLabel": "recipient_by",
                                        "value": recipientby  # 替换为目标值
                                    },
                                    {
                                        "tabLabel": "recipient_title",
                                        "value": recipientTitle  # 替换为目标值
                                    },
                                    {
                                        "tabLabel": "date_c, # 语法错误：引号未闭合
                                        "value": currDate  # 替换为目标值
                                    },
                                    {
                                        "tabLabel": "recipient_name",
                                        "value": recipientName  # 替换为目标值
                                    }
                                ]
                            
                                  
                            }
                        }
                        
                    ]
                }

解决方案 #

问题根源 #

你当前将填充字段放在签署者（signer）的tabs节点下，这类字段属于签署者专属的个性化字段，仅会在该签署者的副本中显示；而管理员作为抄送/副本收件人，无法读取其他签署者的专属字段。预填充标签（Prefill Tabs）是信封级别的全局字段，所有收件人（包括管理员）都能看到，这才是满足你需求的正确配置。

具体修改步骤 #

1. 确认模板预填充标签配置
   确保模板中的目标字段已设置为「预填充标签」（而非签署者专属文本框），且标签名称与代码中的tabLabel完全一致（大小写敏感）。

2. 修正信封定义结构
   预填充标签不属于特定签署者的tabs，需直接放在信封定义的prefillTabs全局节点下，同时移除签署者tabs中的相关字段：

envelope_definition = {
    "status": "sent",
    "templateId": template_id, # 模板ID（GUID）
    "templateRoles": [
        {
            "email": recipientEmail,
            "name": companyName,
            "roleName": "signer"
            # 移除签署者下的textTabs，预填充字段不属于签署者专属
        }
    ],
    # 全局预填充标签节点，所有收件人可见
    "prefillTabs": {
        "textTabs": [
            {
                "tabLabel": "company_name",
                "value": companyName
            },
            {
                "tabLabel": "recipient_email",
                "value": recipientEmail
            },
            {
                "tabLabel": "recipient_by",
                "value": recipientby
            },
            {
                "tabLabel": "recipient_title",
                "value": recipientTitle
            },
            {
                "tabLabel": "date_c", # 修正语法错误，闭合引号
                "value": currDate
            },
            {
                "tabLabel": "recipient_name",
                "value": recipientName
            }
        ]
    },
    # 可选：如果模板未配置管理员，添加管理员作为抄送收件人
    "recipients": {
        "carbonCopies": [
            {
                "email": "admin@example.com", # 管理员邮箱
                "name": "管理员姓名",
                "recipientId": "2" # 确保ID与签署者的recipientId（默认是1）不重复
            }
        ]
    }
}

3. 验证管理员收件人配置
   确保管理员已被正确添加为信封的「抄送收件人（carbonCopy）」或「认证副本收件人（certifiedDelivery）」，可以通过模板预设，也可以如上代码在信封定义中直接添加。

关于付费账户的说明 #

预填充标签功能在DocuSign基础账户中即可使用，无需升级付费账户，你的问题核心是字段归属配置错误，而非权限限制。

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