将 Word 文档添加到现有信封时出现 FORMAT_CONVERSION_ERROR

Question

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

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

但是，当我尝试向此信封中添加更多文档时，我添加的每个 Word 文档都会出现“FORMAT_CONVERSION_ERROR”错误。可以成功添加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 文档添加到预先存在的草稿信封？

干杯， 海登

Answer 1

使用文件扩展名指定name 属性有效。看起来fileExtension 属性不必在putDocuments api 中单独指定。

PUT /v2/accounts/{accountId}/envelopes/{envelopeId}/documents

{
   "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..."
   }
  ]
}