关于DocuSign Connect：无模板时为文档设置可识别字段的问询

针对你遇到的问题，有两种可行的解决方案，无需依赖预定义模板即可让DocuSign Connect的XML回调识别字段值：

1. 使用Auto Place自动字段匹配功能 #

这是最适合普通用户操作的方案，核心是在文档中添加特定格式的纯文本占位符：

• 命名规则：用双大括号包裹字段名，比如{{客户姓名}}、{{合同编号}}
• 操作方式：直接在Word或PDF中输入上述格式的纯文本（不要用表单文本框，这类控件不会被DocuSign自动识别）
• 生效条件：上传文档创建信封时，确保开启「自动字段匹配」（DocuSign默认开启该功能，若未生效可在信封设置中确认）
• 效果：这些占位符会被DocuSign转换为可填充字段，用户填写后，对应字段名和值会出现在Connect返回的XML数据中

2. 通过DocuSign API动态添加字段 #

如果是自动化或批量处理场景，可通过API在上传文档时直接定义字段，无需模板：

• 核心逻辑：调用envelopes.create接口时，在documents节点下的fields数组中指定字段的位置、名称和值
• 示例代码片段（JSON格式）：

  {
    "emailSubject": "签署大尺寸文档",
    "documents": [
      {
        "documentId": "1",
        "name": "LargeContract.pdf",
        "fields": [
          {
            "documentId": "1",
            "pageNumber": "3",
            "xPosition": "150",
            "yPosition": "300",
            "name": "项目金额",
            "value": "¥50000",
            "type": "text"
          }
        ]
      }
    ],
    "recipients": {
      "signers": [
        {
          "email": "signer@example.com",
          "name": "张三",
          "recipientId": "1"
        }
      ]
    }
  }
  

• 效果：通过API添加的字段会被纳入信封的字段集合，无论用户是否修改字段值，最终都会在Connect的XML回调中返回

关键注意事项 #

• 之前尝试的Word/PDF表单文本框无法被识别，因为DocuSign默认不会抓取文档自带的表单控件，仅识别通过Auto Place或API定义的字段
• 大尺寸文档需确保格式合规：避免使用加密PDF、特殊字体，推荐用PDF/A格式上传，防止占位符或字段信息丢失

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