使用DocuSign创建信封API遇‘Object reference not set...’错误求助

你遇到的空引用错误是因为签名标签（Tabs）的位置放错了。DocuSign API要求签名标签必须关联到具体的签署人，而不是直接附加在文档对象上。

错误原因 #

你的请求体把tabs放在了documents数组的文档对象里，但正确的结构应该是将tabs嵌套在recipients.signers对应的签署人对象中——每个签名标签都需要明确指定属于哪个签署人，否则API无法识别标签的归属，进而触发空引用错误。

修正后的请求体 #

{
  "documents": [
    {
      "documentBase64": "<base64ForTheDocument>",
      "documentId": "1",
      "fileExtension": "pdf",
      "name": "document"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "<email>",
        "name": "Kapil",
        "recipientId": "1",
        "tabs": {
          "signHereTabs": [
            {
              "anchorString": "Signature:",
              "documentId": "1",
              "recipientId": "1",
              "anchorXOffset": "1",
              "anchorYOffset": "0",
              "anchorIgnoreIfNotPresent": "True",
              "anchorUnits": "inches"
            }
          ]
        }
      }
    ]
  },
  "status": "sent",
  "emailSubject": "Docusign developer account"
}

关键修改点 #

• 移除documents对象内的tabs节点
• 在目标签署人（signers数组内的对象）中添加tabs节点
• 给signHereTabs里的标签增加recipientId: "1"，确保与签署人的recipientId一一对应

调整后API就能正确识别签名标签的归属，解决空引用错误。

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