Docusign API: PageSize заблокирован при обновлении enveloppeDocuments

Question

В веб-приложении DocuSign я создал шаблон с:

• 2 документов:
  • 1 документ для подписи
  • 1 дополнительный документ
• 2 роли:
  • подписывающее лицо
  • cc

Я создаю конверт с API DocuSign, из этого шаблона, с таким определением:

{
  "status" : "created",
  "templateId" : "660fc6af-21f4-4738-b414-a5da17bc7755",
  "templateRoles" : [ {
    "email" : "my_user11@example.com",
    "name" : "ABC",
    "roleName" : "signer",
    "routingOrder" : "1"
  }, {
    "email" : "my_user2@example.com",
    "name" : "EFG",
    "roleName" : "cc",
    "routingOrder" : "2"
  } ]
}

Затем я получаю ответ от API:

{
  "envelopeId" : "3cb2c471-a288-47c7-82f3-2ba2f418607a",
  "status" : "created",
  "statusDateTime" : "2020-04-09T06:43:44.9430000Z",
  "uri" : "/envelopes/3cb2c471-a288-47c7-82f3-2ba2f418607a"
}

Теперь я пытаюсь обновить первый документ (тот, который нужно подписать) ):

{
  "documents" : [ {
    "documentBase64" : "xxxx",
    "documentId" : "1",
    "fileExtension" : "pdf",
    "name" : "Replaced document to sign"
  } ]
}

Затем я получаю сообщение об ошибке:

{
  "envelopeDocuments" : [ {
    "authoritativeCopy" : "false",
    "documentId" : "1",
    "documentIdGuid" : "9aaba15f-f71e-492a-93cd-5be98687c92d",
    "errorDetails" : {
      "errorCode" : "DOCUMENT_UPDATE_NOT_ALLOWED",
      "message" : "The following properties are locked and cannot be updated: pageSizes"
    },
    "name" : "reportTest.pdf",
    "order" : "2",
    "templateRequired" : "false"
  } ],
  "envelopeId" : "3cb2c471-a288-47c7-82f3-2ba2f418607a"
}

Документ, использованный для определения шаблона, совпадает с документом, который я пытался заменить в конверте. Но я не могу заменить документ в конверте. Почему?

Answer 1

Похоже, вам нужно обновить тело вашего запроса. Попробуй это.

PUT: /v2.1/accounts/{accountID}/envelopes/{envelopeID}/documents/1

Request Body:
{
"name": "yourFile.pdf",
"order": 1,
"display": "inline",
"documentId": "1",
"fileExtension": "pdf",
"documentBase64": "base64EncodedString"
}