使用DocuSign eSignature REST API更新文档字段值遇未知错误求助

我帮你梳理下这个问题的根源和解决办法：

为什么会出现这个错误？ #

你收到的这个模糊错误，本质是你的PUT请求没有指定要更新的收件人。DocuSign里的每个字段（tab）都是和特定收件人绑定的，只给tabLabel和value的话，API根本不知道要更新哪个收件人身上的PO#字段，所以才抛出了这个关于source的空值错误。

从你提供的GET接口返回结果里，能看到这个PO#字段属于recipientId: 0287bf0a-2951-4902-b63d-2f438d70a64a的收件人，这个标识必须加到请求里。

修正后的请求示例 #

你需要把字段信息嵌套在收件人对象里，用recipientId来精准定位：

{
  "recipients": {
    "signers": [
      {
        "recipientId": "0287bf0a-2951-4902-b63d-2f438d70a64a",
        "tabs": {
          "numberTabs": [
            {
              "tabLabel": "PO #",
              "value": "1231231231" // 注意：原字段maxLength是10，这里要改成10位以内的值，避免后续验证失败
            }
          ]
        }
      }
    ]
  }
}

如果你不想用recipientId，也可以用收件人的邮箱和姓名来定位（前提是这个收件人在信封里是唯一的）：

{
  "recipients": {
    "signers": [
      {
        "email": "recipient@yourdomain.com",
        "name": "Recipient Full Name",
        "tabs": {
          "numberTabs": [
            {
              "tabLabel": "PO #",
              "value": "1231231231"
            }
          ]
        }
      }
    ]
  }
}

额外提醒 #

• 字段长度要合规：你之前尝试设置的123123123123是12位，但该字段的maxLength是10，就算API请求成功，后续也会触发字段验证错误，记得把value调整到10位以内。
• 注意tabLabel的大小写：DocuSign对tabLabel的大小写是敏感的，确保请求里的"PO #"和GET返回的完全一致，别写错了。

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