Frederic
Frederic

Reputation: 2065

Signature/Initials/SignatureDate Tabs location issue

I have been having an issue with the location of signatures /initials for a long time now. Because a picture is worth a 1000 words, Im going to provide a screenshot as well as a json request. In this test, I am trying to place a signature date and initials at different locations but with same Y axis coordinates. As you can see in the json request, they both have "yPosition": "315"

However, as you can see in the image below, they have a total different Yaxis on the document. Do you have any idea of what I am missing/doing wrong ? enter image description here

{
  "status":"sent",
  "emailBlurb":"Test Email Body",
  "emailSubject": "Test Email Subject - EnvelopeDefFull",
  "documents": [{
      "name": "test1.pdf",
      "documentId":"1",
        "documentId": "1",
        "name": "Tab Coordinates Test Page.pdf",
        "documentBase64": ".....document Bytes....}],
  "recipients": {
    "signers": [
      {
        "tabs": {
          "initialHereTabs": [
            {
              "scaleValue": "0.6",
              "documentId": "1",
              "recipientId": "2",
              "pageNumber": "1",
              "xPosition": "393",
              "yPosition": "315",
              "anchorUnits": "pixels"
            }
          ],
          "dateSignedTabs": [
            {
              "bold": "True",
              "documentId": "1",
              "recipientId": "2",
              "pageNumber": "1",
              "xPosition": "460",
              "yPosition": "315"
            }
          ]
        },
        "name": "Jane Smith",
        "email": "[email protected]",
        "recipientId": "2",
        "customFields": [
          "ROLE-14"
        ]
      }
    ],
   },
  "status": "sent",
  "emailSubject": "Please sign this document",
  "notification": {
    "expirations": {
      "expireEnabled": "True",
      "expireAfter": "5"
    }
  }
}

Upvotes: 0

Views: 321

Answers (1)

Praveen Reddy
Praveen Reddy

Reputation: 7383

In most cases, the yPosition aligns with the top edge of the tab. The top edge of the text tabs(For ex: DateSigned, FullName, Company, Title etc) seem to correctly align with the yPosition.

The signature tabs seems to have additional offset and it can differ based on the scaleValue used. See this answer for the offset values.

Tip:You can use the Docusign Console to tag documents and get the accurate X&Y positions using the getRecipients call. You can then specify those coordinates in your API request to create new envelopes. See this answer

GET /v2/accounts/{accountId}/envelopes/{envelopeId}/recipients?include_tabs=true

Upvotes: 1

Related Questions