eSignature API > Tutorial: Hello World > eSignAnyWhere API with SoapUI Sample

eSignAnyWhere API with SoapUI

This eSignAnyWhere API with SoapUI will show you how to send your first envelope via SoapUI, a free SOAP tool for testing web services. It will show you how to configure SoapUI, test the eSignAnyWhere API, upload a document, prepare an evelope and download the signed file.

Download and install SoapUI

First you should install SoapUI on your computer. Visit www.soapui.org to download the current version of SoapUI OpenSource. You don’t need to download or buy the commercial version of it, because the Open Source version is for this sample enough. After downloading SoapUI install it on your computer.

Resources for the Sample

Tutorial PDF Download PDF
WSDL https://www.significant.com/api.asmx?WSDL
Download XML Call Samples SoapUI Sample XMLs

Configure SoapUI Endpoint

Create new SOAP Project, enter a project name and the eSignAnyWhere WSDL (https://www.significant.com/api.asmx?WSDL) and press OK.

SoapUI Configuration

Then the WSDL is read and the SOAP functions are listed on the left.

SoapUI Project View

First SOAP Call

Navigate to GetVersion_v1 and double click on “Request 1”. This will open a new windows with the call for this function. Just click on the green submit request button and you will receive the response from the eSignAnyWhere API.

The response is an XML which contains information about the request status (baseResult), the response (okInfo) or the error (errorInfo). More details on the basic concepts of our calls you can find in the API documentation.

Upload the PDF

First you have to upload the PDF file via UploadTemporarySspFile_v1. Therefore you have base64 encode the PDF. The upload request requires, like all other except the GetVersion_v1, the authentication. This is also descripted in the API documentation. The following screenshot shows a reduced request, because the base64 encoded file is huge. In the Response you see the sspFileId, which is required for creating the envelope.

SoapUI Upload File

Create AdHoc Workstep

Now we are requesting an adhoc workstep configuration from the server for the uploaded file. Therefore we are calling the GetAdHocWorkstepConfiguration_v1 with the sspFileId and a default adhoc configuration (you find this adhoc configuration in the Tutorial or also in the XML Samples).

SoapUI AdHoc Config

Send Envelope

Now you can modify your adhoc workstep configuration and generate the envelope configuration, with the recipient definitions and settings. If you are call the SendEnvelope_v1 function, the result will be the envelopeId and the workflow will be started automatically.

SoapUI Send

Download the Document(s)

You check the status of the envelope by calling the GetEnvelopeById_v1 function. If the envelope is finished you get a list of available files for download (the documents and the audit log). For downloading one of the files you have to use the function DownloadCompletedDocument_v1.

SoapUI Download

Information for eSignAnyWhere users

Effective January 23, 2019 Namirial has aligned brand and domain for eSignAnyWhere.

You have registered your account

  • prior to January 23, 2019, 11:40 AM CET:
    → Go to URL www.significant.com to access your account.

Users registering

  • on January 23, 2019 at 11:40 AM CET or afterwards:
    → Go to URL saas.esignanywhere.net to access your account.

Any questions? Don’t hesitate to contact Namirial eSignAnyWhere Support.

Regards,
Your Namirial Team

Explains how to login to the right account

Information for eSignAnyWhere users

Effective January 23, 2019 Namirial has aligned brand and domain for eSignAnyWhere.

You have registered your account

  • prior to January 23, 2019, 11:40 AM CET:
    → Go to URL www.significant.com to access your account.

Users registering

  • on January 23, 2019 at 11:40 AM CET or afterwards:
    → Go to URL saas.esignanywhere.net to access your account.

Any questions? Don’t hesitate to contact Namirial eSignAnyWhere Support.

Regards,
Your Namirial Team