Docusignapi 将Word文档添加到现有信封时发生格式转换错误

我正在构建一个创建DocuSign信封的应用程序，作为其中的一部分，我需要将一些MS Word（docx）文档添加到我之前创建的现有信封中

我已经成功地实现了许多DocuSign API调用，包括从PDF和Word文档创建多文档草稿信封的调用

但是，当我尝试向这个信封添加更多文档时，我添加的每个Word文档都会出现“格式转换错误”错误。可以成功添加PDF文档

我提出的API请求如下：

Method: PUT
URL: https://demo.docusign.net/restapi/v2/accounts/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/envelopes/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/documents

Request:

Custom Headers
Name
Value
Accept
application/json
Content-Transfer-Encoding
Base64
Content-Type
application/json
X-DocuSign-Authentication
{"SendOnBehalfOf" : "", "Username" : "username_goes_here",     "Password":"password_goes_here","IntegratorKey":"integrator_key_goes_here"}
Body:
"documents": [
    {
      "name": "2016 Audit Engagement Letter - Executive Superannuation     Fund",
      "documentId": "8",
      "fileExtension": "docx",
      "documentBase64": "UEsDBB..."
    },
    {
      "name": "2016 Audit Management Letter - Executive Superannuation Fund",
      "documentId": "9",
      "fileExtension": "docx",
      "documentBase64": "UEsDBBQAB..."
    },
    {
      "name": "2016 Audit Representation Letter - Executive Superannuation Fund",
      "documentId": "10",
      "fileExtension": "docx",
      "documentBase64": "UEsDBBQABgA..."
    },
    {
      "name": "2016 Independent Audit Report - Executive Superannuation Fund",
      "documentId": "11",
      "fileExtension": "docx",
      "documentBase64": "UEsDBBQABgAIA..."
    },
]

我得到一个200 OK的回复，但正文中有以下错误：

{
  "envelopeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "envelopeDocuments": [
    {
      "documentId": "8",
      "order": "8",
      "errorDetails": {
        "errorCode": "FORMAT_CONVERSION_ERROR",
        "message": "The data could not be converted."
      }
   },
    {
      "documentId": "9",
      "order": "9",
      "errorDetails": {
        "errorCode": "FORMAT_CONVERSION_ERROR",
        "message": "The data could not be converted."
      }
    },
    {
      "documentId": "10",
      "order": "10",
      "errorDetails": {
        "errorCode": "FORMAT_CONVERSION_ERROR",
        "message": "The data could not be converted."
      }
    },
    {
      "documentId": "11",
      "order": "11",
          "errorDetails": {
            "errorCode": "FORMAT_CONVERSION_ERROR",
            "message": "The data could not be converted."
          }
        }
    ]
    }

同样的文档可以在创建草稿信封的原始POST请求中成功上传，因此我认为文档和base64编码都不是问题所在

类似地，如果我将文档替换为PDF文档，则请求可以正常工作，并且PDF将添加到现有信封中

还有谁见过这个吗？DS是否支持将Word文档添加到预先存在的草稿信封中

干杯，

---

Hayden

使用文件扩展名指定

name

属性正在工作。看起来不必在api中单独指定

fileExtension

属性

放置/v2/accounts/{accountId}/envelopes/{envelopeId}/documents

---

谢谢你提出的详细问题。感谢您提供所有相关细节。这是一个bug。您应该能够指定

fileExtension

属性。它的工作原理应该与信封：create方法相同。我提交了DocuSIgn内部报告DCMT-693

{
   "documents": [
   {
      "name": "2016 Audit Engagement Letter - Executive Superannuation Fund.docx",
      "documentId": "8",
      "documentBase64": "UEsDBB..."
   },
   {
      "name": "2016 Audit Management Letter - Executive Superannuation Fund.docx",
     "documentId": "9",
     "documentBase64": "UEsDBBQAB..."
   }
  ]
}