儘管沒有使用任何頁碼，但獲取TAB_PAGENUMBER_IS_NOT_IN_DOCUMENT

Question

我正在向/v2/accounts/<account_id>/envelopes發出POST請求。這裏是我得到的錯誤：

{ 
    "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": [ 

      ] 
     } 
    }] 
} 

我已經prettyprinted和節錄某些字段但除此之外，這是我們發送完全相同的JSON。

即使我們沒有指定任何頁面，即使我們沒有指定任何選項卡，爲什麼我們會收到有關頁碼的錯誤？

Answer 1

在DocuSign平臺中，有兩種方式通過使用x和y座標的絕對定位或通過所謂的Anchor Tagging來指定標籤位置，該標籤基於文檔內容放置標籤。如果你是一個POST請求的URI

/v2/accounts/<account_id>/envelopes 

，並要設置的狀態發送而非通過設置狀態創建，那麼這意味着你要發送簽名請求創建草案並且您需要爲所有選項卡填寫選項卡信息。這就是爲什麼即使在您的請求中未設置任何選項卡時也會出現錯誤的原因。

根據你爲什麼得到缺少頁碼錯誤，因爲你通過設置x和y座標來使用絕對定位，你還需要指定你在哪個頁面上放置它們。如果您正在使用錨定標記，則不需要設置頁碼。所以基本上方式，您可以設置標籤了是這樣的：

- 絕對定位 -

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

- 錨基定位 -

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