This topic contains 16 replies, has 3 voices, and was last updated by  Haris 7 months, 3 weeks ago.

  • Author
    Posts
  • Participant
    tehpaoliu
    Newbie
    Member since: 24.03.2018
    Number of posts: 3

    Hi All,

    I followed instructions provided in https://developer.esignlive.com/guides/feature-guides/text-tags-extraction/ “REST API” tab

    Also “Code Share” hyperlink does not have any code sample to download.

    Using postman REST API client I am able to create package in esignlive but for some reason, it does not recognize Signature Text Tag for signing so I cannot send the package for signing

    Here is what I used for in Demo.docx {{esl:Signer1:capture:size(400,50)}}

    Here is payload that I used from the above link. Also I have attached Demo.docx that I am using
    {
    “documents”: [
    {
    “id”: “Demo”,
    “name”: “Test Document”,
    “extract”: true,
    “data”: {
    “esl_doc_extract_type”: 1
    }
    }
    ],
    “status”: “DRAFT”,
    “type”: “PACKAGE”,
    “roles”: [
    {
    “id”: “signer1”,
    “type”: “SIGNER”,
    “signers”: [
    {
    “email”: “mail32@mailinator.com”,
    “firstName”: “John”,
    “lastName”: “Smith”,
    “id”: “signer1”
    }
    ],
    “name”: “signer1”
    }
    ],
    “name”: “Text Tags Example Package”
    }

    Is the correct way to create package with Placeholder using REST API

    Any help will be appreciated.

    Thank you

    -Teh

    • This topic was modified 8 months, 1 week ago by  tehpaoliu.
    Attachments:
    You must be logged in to view attached files.
    Keymaster
    Haris
    Jedi Master
    Member since: 05.11.2015
    Number of posts: 1450

    Score

    0

    Hi there,

    Ids care case sensitive in eSignLive. In your payload, you defined “signer1” as the id of your signer but in your document you have “Signer1”. Simply make the correction in either your payload or document and it should be working.


    Haris Haidary
    OneSpan Technical Consultant
    Participant
    tehpaoliu
    Newbie
    Member since: 24.03.2018
    Number of posts: 3

    Score

    0

    Thanks Haris for quick response it is working! now.

    Also I noticed that in the package my name teh.p.liu get added as “Myself” is there any way to remove it using API or not create it at all. I just need Recipient Name

    I have attached screen shot

    Attachments:
    You must be logged in to view attached files.
    Keymaster
    Haris
    Jedi Master
    Member since: 05.11.2015
    Number of posts: 1450

    Score

    0

    Yes, you will need to add the “senderVisible” field in your payload.

    {
      "documents": [
        {
          "id": "Demo",
          "name": "Test Document",
          "extract": true,
          "data": {
            "esl_doc_extract_type": 1
          }
        }
      ],
      "status": "DRAFT",
      "type": "PACKAGE",
      "roles": [
        {
          "id": "signer1",
          "type": "SIGNER",
          "signers": [
            {
              "email": "mail32@mailinator.com",
              "firstName": "John",
              "lastName": "Smith",
              "id": "signer1"
            }
          ],
          "name": "signer1"
        }
      ],
      "name": "Text Tags Example Package",
      "data": {
        "senderVisible": false
      }
    }

    Haris Haidary
    OneSpan Technical Consultant
    • This reply was modified 8 months, 1 week ago by  Haris.
    • This reply was modified 8 months, 1 week ago by  Haris.
    Participant
    tehpaoliu
    Newbie
    Member since: 24.03.2018
    Number of posts: 3

    Score

    0

    THANK YOU HARIS you have been a great help. Your solution resolved my issue.

    Keymaster
    Haris
    Jedi Master
    Member since: 05.11.2015
    Number of posts: 1450

    Score

    0

    My pleasure 🙂


    Haris Haidary
    OneSpan Technical Consultant
    Participant
    khartness
    Newbie
    Member since: 09.04.2018
    Number of posts: 5

    Score

    0

    I’m attempting to do something similar with the REST API, but the service reports that I must define approvals. Do I need to specify a particular version?

    Keymaster
    Haris
    Jedi Master
    Member since: 05.11.2015
    Number of posts: 1450

    Score

    0

    It looks like you’re attempting to send a package without any signatures defined. Can you share your json payload (copy-paste it using the <pre> tags) along with your documents so I can have a look?


    Haris Haidary
    OneSpan Technical Consultant
    • This reply was modified 8 months ago by  Haris.
    • This reply was modified 8 months ago by  Haris.
    Participant
    khartness
    Newbie
    Member since: 09.04.2018
    Number of posts: 5

    Score

    0

    {“status”:”SENT”,
    “documents”:[{
    “id”:”Application”,
    “description”:”Application.pdf”,
    “name”:”Application.pdf”,
    “extract”:true,
    “data”:{
    “esl_doc_extract_type”:1
    }
    }],
    “roles”:[{
    “signers”:[{
    “name”:”OWNER1″,
    “auth”:{
    “scheme”:”NONE”,
    “challenges”: []
    },
    “id”:”OWNER1″,
    “language”:”en”,
    “title”:”OWNER”,
    “firstName”:”Ken”,
    “lastName”:”Hartness”,
    “email”:”ken.hartness@paysafe.com”,
    “company”:”Hartness Inc.”,
    “phone”:”2815834432″
    }],
    “name”:”OWNER1″,
    “index”:1,
    “id”:”OWNER1″,
    “type”:”SIGNER”
    }],
    “visibility”:”ACCOUNT”,
    “notaryRoleId”:null,
    “settings”:{
    “ceremony”:{
    “optOutReasons”:[“Signing application with agent”, “Mailing application”],
    “maxAuthFailsAllowed”:3,
    “handOver”:{
    “title”:”Signed Merchant Application”,
    “text”:”Welcome!”,
    “href”:”https://www.merchantfoundry.com”
    },
    “documentToolbarOptions”:{
    “downloadButton”:true
    },
    “hideLanguageDropdown”:true,
    “hideCaptureText”:true,
    “declineButton”:true,
    “optOutButton”:true,
    “hideWatermark”:false
    }
    },
    “type”:”PACKAGE”,
    “autocomplete”:true,
    “trashed”:false,
    “description”:”MCPS Application”,
    “name”:”MCPS Application Package”,
    “due”:”2018-04-30T00:00:00Z”,
    “language”:”en”,
    “completed”:null,
    “data”: {
    “senderVisible”: false
    }
    }

    Attachments:
    You must be logged in to view attached files.
    Keymaster
    Haris
    Jedi Master
    Member since: 05.11.2015
    Number of posts: 1450

    Score

    0

    Looking at your pdf, you need to make sure that the text tags are not broken apart on different lines. See attachment.


    Haris Haidary
    OneSpan Technical Consultant
    Attachments:
    You must be logged in to view attached files.
    Participant
    khartness
    Newbie
    Member since: 09.04.2018
    Number of posts: 5

    Score

    0

    I reduced the date to 1-point font so it is entirely on one line.
    Still receiving this response:
    {“messageKey”:”error.validation.sendPackage.noApprovals”,”entity”:null,”technical”:null,”packageId”:null,”message”:”Cannot send package without approvals.”,”code”:400,”name”:”Validation Error”}

    Keymaster
    Haris
    Jedi Master
    Member since: 05.11.2015
    Number of posts: 1450

    Score

    0

    I’ve updated your document to make it work using text tags. Please make sure that there aren’t any typos in the text tags. Otherwise, it will not work.


    Haris Haidary
    OneSpan Technical Consultant
    Keymaster
    Haris
    Jedi Master
    Member since: 05.11.2015
    Number of posts: 1450

    Score

    0

    document


    Haris Haidary
    OneSpan Technical Consultant
    Attachments:
    You must be logged in to view attached files.
    Participant
    khartness
    Newbie
    Member since: 09.04.2018
    Number of posts: 5

    Score

    0

    curl -H “Authorization: Basic $1” -H “Accept: application/json; esl-api-version=11.12” -X POST $2 -k -F payload=@$3 -F file=@$4 > $5
    Your PDF (or mine) with the JSON I included, earlier, produces the following response:
    {
    “messageKey”:”error.validation.sendPackage.noApprovals”,
    “entity”:null,
    “technical”:null,
    “packageId”:null,
    “message”:”Cannot send package without approvals.”,
    “code”:400,
    “name”:”Validation Error”
    }

    • This reply was modified 7 months, 3 weeks ago by  khartness.
    Keymaster
    Haris
    Jedi Master
    Member since: 05.11.2015
    Number of posts: 1450

    Score

    0

    Can you share a package id so I can have a look at your account with our support team?


    Haris Haidary
    OneSpan Technical Consultant

You must be logged in to reply to this topic.