Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Service

URL

TYPE

Service Description

Parameters

Get E-Sign MetaData

/esignmetadata/esigntransactions

GET

This endpoint returns the list of transactions that are available to work on. 

Update E-Sign MetaData

/esignmetadata/esigntransactions/{transactionId}

PUT

This endpoint sets the status of a transaction record so that future calls to the GET esignmetadata/esigntransactions endpoint returns only the desired records (e.g. only the active records).

TransactionID

StatusID

GetESignTransactions Details

This method returns the list of transactions that are available to work on. 

REST Request

Request Parameters

Field Name

Data Type

Length

Required?

Description

StatusID

Integer

NO

The Status of the records to include:

1  Pending

2  Active

3  Inactive

4  Delete

5  In Process

StartCreatedDate

Date

NO

The start date to include results based on the date the record was created

EndCreatedDate

Date

NO

The end date to include results based on the date the record was created

Response

Result Fields

The meta data returned will include the following fields:

Field Name

Data Type

Length

Required?

Description

AccountID

String

NO

Customer AccountID

BDID

String

YES

Customer Broker Dealer identifier

ClientID

String

YES

Customer ClientID

RepCode

String

3

YES

Customer RepCode

DocumentSetId

String

YES

Document SetId from e-sign vendor

AttachmentFlag

Boolean

YES

If TRUE then the record is an attachment and the FullFileName and PartialFileName fields will be identical and reliable for matching, and the FormID value will be 0. If FALSE then the record is a form with a valid FormID.

FormName

String

YES

Name or description of the form

PageCount

Integer

YES

Number of pages for the FormID

FormOrder

Integer

YES

Order of the documents in the package

CreateDate

Date

YES

The Date & Time the document ready for signing ceremony.

DocSetDescription

String

YES

The DocSetDescription Quik! sent to e-sign vendor

FullFileName

String

YES

The expected file name of the PDF sent to the e-sign vendor. (NOTE: The PDF file name for forms is not stored in Quik!, only attachment file names are stored. Therefore, to return this value for forms, the file name is estimated and could possibly change between the time the PDF is sent to the e-sign vendor and when this service is called. To reliably match the file name between Quik! and the e-sign vendor, use the PartialFileName and match the right-most portion of the filename.)

PartialFileName

String

YES

The right-most portion of the file name that will never change. Use this value for matching file names between Quik! and the e-sign vendor – match against the right-most portion of the e-sign vendor’s filename.

StatusID

Integer

YES

The status of the records to include (1 = Active, 2 = Inactive, 3 = Pending, 4 = Delete)

TransactionID

String

36

YES

The TransactionID value Quik! sent to e-sign vendor

FormID

Integer

YES

Unique form ID within Quik! to differentiate one form from another. If the record is an attachment the FormID will be a zero.

UpdateESignTransactions Details

This method sets the status of a transaction record so that future calls to the GetESignTransactions method returns only the desired records (e.g. only the active records).

Request Parameters

Field Name

Data Type

Length

Required?

Description

TransactionID

String

36

YES

The TransactionID who’s status will be set

StatusID

Integer

YES

The status of the records to include:
1        Pending

2        Active

3        Inactive

4        Delete

Result Fields

This service will return no additional parameters beyond the standard results (error code, message, etc.).