如何通过Envelope API在PDF文档中显示电子印章图片

你提到的companyTab无法实现这个需求——它只是用于展示收件人公司名称的文本标签，和印章图片没有关联。要让印章对应的公司图片像signHereTabs一样在PDF文档内显示，需要将签名位置标签与自定义印章图像绑定，具体操作如下：

核心思路 #

seals配置仅关联收件人签名提供者的印章信息，仅会在Acrobat签名面板展示；要在PDF页面上显示印章图片，必须在收件人配置中添加signHereTab签名位置标签，并将印章图像与该标签绑定。

具体实现步骤 #

1. 添加signHereTab指定签名位置
   在收件人（recipients）的tabs字段下添加signHereTabs，明确签名在PDF中的坐标位置。

2. 绑定印章图像到签名标签
   有两种方式实现：

   • 方式一：通过seals关联已上传的印章
     确保seals中的recipientId与收件人ID匹配，同时在signHereTab中指定signatureProviderName与sealName对应，让签名时自动调用该印章图像。
   • 方式二：直接在signHereTab中嵌入图像
     使用signatureImageData字段传入base64编码的公司印章图片，签名时直接显示该图像。

修改后的JSON示例 #

以下是整合了signHereTab与seals的createEnvelope请求片段：

"recipients": {
  "signers": [
    {
      "recipientId": "XXXXXXXXXXX",
      "routingOrder": "2",
      "tabs": {
        "signHereTabs": [
          {
            "documentId": "1",
            "pageNumber": "1",
            "xPosition": "100",
            "yPosition": "100",
            // 方式一：关联已配置的seal
            "signatureProviderName": "XXXXXXXXXXX",
            // 方式二：直接嵌入base64图像（二选一即可）
            "signatureImageData": "base64编码的公司印章图片内容"
          }
        ]
      }
    }
  ]
},
"seals": [
  {
    "recipientId": "XXXXXXXXXXX",
    "recipientSignatureProviders": [
      {
        "sealName": "XXXXXXXXXXX"
      }
    ],
    "routingOrder": "2"
  }
]

注意事项 #

• 若使用方式一，需确保该sealName对应的印章已在DocuSign后台完成上传配置。
• signatureImageData支持PNG、JPG等格式的base64编码内容，需注意文件大小限制。

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