DocuSign技术咨询：如何创建无收件人关联的自定义字段？

你可以通过以下两种核心方式创建不依赖收件人ID的自定义字段，完全避开prefill工具的限制：

1. 信封级自定义字段（Envelope Custom Fields） #

这类字段直接绑定到整个信封，不属于任何特定收件人，所有能访问该信封的用户都能查看或修改（依权限而定），不需要指定recipientId。

在创建信封的API请求中，直接在请求体里添加customFields节点即可，示例如下：

{
  "emailSubject": "测试信封",
  "status": "sent",
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "测试签署人",
        "recipientId": "1"
      }
    ]
  },
  "customFields": {
    "textCustomFields": [
      {
        "name": "订单编号",
        "value": "ORD-2024-001",
        "show": "true" // 设置为true则在信封详情中显示
      }
    ],
    "dateCustomFields": [
      {
        "name": "创建日期",
        "value": "2024-05-20",
        "show": "true"
      }
    ]
  }
}

如果是已创建的信封，也可以通过PUT /envelopes/{envelopeId}/custom_fields接口添加或修改这些字段，同样不需要收件人ID。

2. 模板级自定义字段（Template Custom Fields） #

如果你是基于模板创建信封，可以先在模板中添加全局自定义字段，这些字段会被后续生成的所有信封继承，同样不关联任何收件人。

创建模板时的API请求示例：

{
  "name": "订单模板",
  "description": "用于订单签署的模板",
  "customFields": {
    "textCustomFields": [
      {
        "name": "模板归属部门",
        "value": "销售部",
        "show": "true"
      }
    ]
  },
  "recipients": {
    "signers": [
      {
        "email": "placeholder@example.com",
        "name": "客户",
        "recipientId": "1",
        "roleName": "客户签署人"
      }
    ]
  }
}

后续用该模板创建信封时，可选择保留模板字段值或覆盖新值，全程无需指定具体收件人的ID。

关键说明 #

• 信封/模板级自定义字段和prefill工具的核心区别：前者属于信封/模板本身，后者是绑定到特定收件人的预填签署字段；
• 确保你的API调用拥有envelope_write（信封操作）或template_write（模板操作）的权限；
• 字段的show参数控制是否在DocuSign控制台的信封详情中显示，若仅用于后台数据存储可设置为false。

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