E-Sign MetaData Services
Description
The collection of Quik! Forms Engine E-Signature MetaData services are used to implement E-Signature MetaData features and capabilities within your environment.Â
Endpoint URL:Â https://websvcs.quikforms.com/rest/esignature/
Endpoint Documentation:Â https://websvcs.quikforms.com/rest/esignature/swagger/index.html
Quik! hosts a web service method to retrieve a list of TransactionIDs for documents sent to E-Sign vendors (DocuSign and SIGNiX) from Quik!.
Customers can set their metadata values for forms generated using the appropriate Quik! Forms Engine properties. After forms have been generated and submitted to an E-Sign vendor by the user, customers can then call GET esignmetadata/esigntransactions to get transactions in a specified status (e.g. Active). Customers can also call the E-Sign vendor to get their list of transactions, match the results, and determine which transaction records need further processing. When a record is done/processed, customers can PUT /esignmetadata/esigntransactions/{transactionId} to change the transaction's status, removing it from returned results in future calls to GET esignmetadata/esigntransactions.
E-Sign MetaData Services
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. | StartCreatedDate  |
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: 2Â Â Â Â Â Â Â Active 3Â Â Â Â Â Â Â Inactive 4Â Â Â Â Â Â Â Delete |
Result Fields
This service will return no additional parameters beyond the standard results (error code, message, etc.).
Related pages
For help regarding Quik! Forms and the Quik! API
Email: support@quikforms.com | Phone: (877) 456-QUIK