Получение TAB_PAGENUMBER_IS_NOT_IN_DOCUMENT, несмотря на отсутствие номеров страниц

Question

Я делаю запрос POST на номер /v2/accounts/<account_id>/envelopes. Здесь ошибка я получаю:

{ 
    "errorCode": "TAB_PAGENUMBER_IS_NOT_IN_DOCUMENT", 
    "message": "The pagenumber specified in the tab element is not in the document that the tab refers to. Tab on Page 2 of Document 3 for Recipient 1" 
} 

Обычно этот запрос содержит некоторые текстовые вкладки и вкладку флажка, ни один из этих вкладок не относятся к любой странице. Укажем только name, tabLabel & value для текстовых вкладок и name, tabLabel & selected для флажков. Но я получаю ту же ошибку, даже когда я не посылаю никаких данных вкладки.

Вот запрос JSON:

{ 
    "allowMarkup": false, 
    "allowReassign": false, 
    "allowRecipientRecursion": false, 
    "asynchronous": false, 
    "authoritativeCopy": false, 
    "autoNavigation": false, 
    "brandId": "", 
    "compositeTemplates": [{ 
     "inlineTemplates": [{ 
      "sequence": "2", 
      "recipients": { 
       "signers": [{ 
        "accessCode": null, 
        "clientUserId": "123456", 
        "email": "EMAIL_1", 
        "emailNotification": null, 
        "name": "Atamert Olcgen", 
        "recipientId": "1", 
        "roleName": "Signer", 
        "tabs": { 
         "checkboxTabs": [ 

         ], 
         "radioGroupTabs": [ 

         ], 
         "textTabs": [ 

         ] 
        } 
       }] 
      } 
     }, { 
      "sequence": "3", 
      "recipients": { 
       "signers": [{ 
        "accessCode": null, 
        "clientUserId": "123456", 
        "email": "EMAIL_1", 
        "emailNotification": null, 
        "name": "Atamert Olcgen", 
        "recipientId": "1", 
        "roleName": "Signer", 
        "tabs": { 
         "checkboxTabs": [ 

         ], 
         "radioGroupTabs": [ 

         ], 
         "textTabs": [ 

         ] 
        } 
       }] 
      } 
     }], 
     "serverTemplates": [{ 
      "sequence": "2", 
      "templateId": "SECOND_TEMPLATE_ID" 
     }, { 
      "sequence": "3", 
      "templateId": "THIRD_TEMPLATE_ID" 
     }] 
    }], 
    "customFields": null, 
    "emailBlurb": "", 
    "emailSubject": "Email Subject", 
    "enableWetSign": false, 
    "enforceSignerVisibility": false, 
    "envelopeIdStamping": false, 
    "eventNotification": null, 
    "signingLocation": "Online", 
    "status": "sent", 
    "templateId": "FIRST_TEMPLATE_ID", 
    "templateRoles": [{ 
     "accessCode": null, 
     "clientUserId": "123456", 
     "email": "EMAIL_1", 
     "emailNotification": null, 
     "name": "Atamert Olcgen", 
     "recipientId": "1", 
     "roleName": "Signer", 
     "tabs": { 
      "checkboxTabs": [ 

      ], 
      "radioGroupTabs": [ 

      ], 
      "textTabs": [ 

      ] 
     } 
    }, { 
     "accessCode": null, 
     "clientUserId": null, 
     "email": "EMAIL_2", 
     "emailNotification": null, 
     "name": "COMPANY_NAME", 
     "recipientId": "2", 
     "roleName": "COMPANY_NAME", 
     "tabs": { 
      "checkboxTabs": [ 

      ], 
      "radioGroupTabs": [ 

      ], 
      "textTabs": [ 

      ] 
     } 
    }] 
} 

Я и отредактированный набран аккуратно несколько полей, но в остальном это тот же самый JSON мы посылаем.

Почему мы получаем ошибку о номере страницы, даже если мы не указываем какие-либо страницы, даже если мы не указываем какие-либо вкладки вообще?

Answer 1

На платформе DocuSign существует два способа указания местоположений табуляции путем абсолютного позиционирования с использованием координат x и y или с помощью так называемого Anchor Tagging, в котором размещаются закладки на основе содержимого документа. Если вы делаете запрос POST к Ури

/v2/accounts/<account_id>/envelopes 

и вы устанавливаете статус Отправленные вместо создания проекта, установив статус Created, то это означает, что вы отправляете запрос на подпись и вам нужно иметь заполненную вкладку для всех ваших вкладок. Вот почему вы получаете ошибку, даже если вы не устанавливаете какие-либо вкладки в своем запросе.

С точки зрения того, почему вы получаете ошибку с номером страницы, поскольку вы используете абсолютное позиционирование, задав координаты x и y, вам также нужно указать, на какой странице вы их размещаете. Если вы используете Anchor Tagging, вам не нужно будет устанавливать номера страниц. Таким образом, в основном пути вы можете установить вкладки вверх, как это:

- Абсолютное позиционирование -

"signHereTabs": [ 
    { 
     "xPosition": "100", 
     "yPosition": "100", 
     "documentId": "1", 
     "pageNumber": "1" 
    } 
] 

- Якорь Based Positioning -

"signHereTabs": [ 
    { 
     "anchorString": "Please Sign Here:", 
     "anchorXOffset": "1", 
     "anchorYOffset": "0.5", 
     "anchorIgnoreIfNotPresent": "false", 
     "anchorUnits": "inches" 
    } 
]