Generate Forms - Quik! Forms Engine Services
Description
Instead of installing the QuikFormsEngine.dll to generate forms, you can use the REST web service version instead. The web service is essentially a wrapper for the QuikFormsEngine.dll enabling you to use the software remotely without installing the actual software or requiring the .NET Framework in your production environment. This is ideal for non-.NET users (e.g. Linux, Unix, MacOS, tablet OS, etc.). The most popular method below is Execute HTML, which is used to generate HTML forms.
Endpoint URL: https://websvcs.quikforms.com/rest/quikformsengine
Endpoint Documentation (Swagger - Production): https://websvcs.quikforms.com/rest/quikformsengine/swagger/index.html
Endpoint Documentation (Swagger - UAT): https://uatwebsvcs.quikforms.com/rest/quikformsengine/swagger/index.html
A note on UNID values
The UNID value Quik! shows to customers is encoded (you will notice that it is encoded when you see either %2b or %2f in the value), then Quik! APIs will first decode it (where %2b results in + and %2f results in /) and then we decrypt it to get the UNID format like 893A4B6E-9DBD-4EB3-83EA-B2A723EF101E. When customers pass an encoded value in a query string like the Get Attachments endpoint below (like https://websvcs.quikforms.com/rest/quikformsengine/attachments?unid=yINpmhmAQ9a%2buIEBwcURm476DfkhVfxyJV%2fCfBN8fDl5sSHiUBagJsA%2bIFfUhmOY4), the .NET framework will decode it automatically and then we perform the decode again, resulting in an error. A workaround is to encode the value before building the url with the unid in it. In .NET you can do that by using HttpUtility.UrlEncode(unid). This transforms % into %25 so it comes as % again in the API.
Methods
| Service | URL | Type | Description |
|---|---|---|---|
| Execute HTML | /qfe/execute/html |
POST | Execute the Quik! Forms Engine for HTML form output |
| Execute PDF | /qfe/execute/pdf |
POST | Execute the Quik! Forms Engine for PDF form output |
| Get Attachments | /attachments |
GET | Get all attachments associated with a UNID |
| Upload Attachments | /attachments/upload |
POST | Upload an attachment file to a specified UNID |
| Delete Attachments | /attachments/{id}/remove |
DELETE | |
/print |
POST | Generate a PDF of the form from HTML | |
| FormLinks | INTERNAL QUIK! USE ONLY | ||
| Save | INTERNAL QUIK! USE ONLY |
Execute HTML
HTMLSettings (Object with properties to be set in the QuikFormsEngine)
Sample Request:
{
"HostFormOnQuik": true,
"FormFields": [
{
"FieldName": "1own.FName",
"FieldValue": "Joe"
},
{
"FieldName": "1own.LName",
"FieldValue": "Smith"
}
],
"QuikFormID": "12"
}
Execute PDF
PDFSettings (Object with properties to be set in the QuikFormsEngine)
Sample Request:
{
"ForSign": true,
"QuikFormID": "12",
"PrintEditablePDF": false
}
Note: the ExecutePDF method will output a signable PDF if and only if ForSign is true and PrintEditablePDF is false.
Get Attachments
unid: The UNID value of the transaction that you wish to retrieve attachments from.
Upload Attachments
unid: The UNID value of the transaction that you wish to upload attachments to.
Name (string): Assign a name to the attachment that will be displayed in the Attachments panel of the Form Viewer. Given name string must end with the file extension that matches the file type of the original attachment. For example, if uploading a PDF attachment, the Name parameter must end in “.pdf”.
Path (string): Leave this parameter empty.
Content: The base 64 string for the byte content of the attachment.
DocSortOrder (int): See details below.
BeforeForm (bool): If TRUE, all attachments are placed at the beginning of the package and displayed before forms when package is printed or shown in DocuSign. In this case, if multiple attachments are used, they are ordered in ascending order based on DocSortOrder value.
If FALSE, all attachments are placed in the middle or at the end of the package when printed or shown in DocuSign. Each form in a package has a “position” which is the order they were generated in. An attachment is placed in the order with the DocSortOrder value after the form in that position.
EXAMPLE
Customer generates Forms 1 and 2 together in a package, and they have positions 1 and 2 respectively. If Attachment A is uploaded with BeforeForm = FALSE and DocSortOrder = 1, then the Attachment is placed after Form 1 and before Form 2. If customer wants it shown after Form 2 then the DocSortOrder value must be 2 or greater.
If a customer wants more than one Attachment in the same position in a package, then they must upload every attachment with the same DocSortOrder value and they will be placed in ascending order by upload order.
Delete Attachments
{id} (int): The Attachment ID to be deleted. This Attachment ID must be entered in the URL when calling this API.
unid: The UNID value of the transaction that you wish to delete an attachment from.
Use this method for generating a PDF of a form using data submitted in a Submit event. Documentation here.
Details
ETI.Domain.Classes.PDF.HTMLData {
EditablePDF (boolean, optional),
IncludeCoverPage (boolean, optional),
UNID (string, optional),
QFEVersion (string, optional),
CustomerID (integer, optional),
Fields (Array[ETI.Domain.Classes.PDF.FieldGroup], optional),
NativeESign (boolean, optional),
NativeESignatures(Array[ETI.Domain.Classes.PDF.NativeESignature], optional),
SignAllDocsCombined (boolean, optional),
SignMultipleDocs (boolean, optional),
CustomFields (ETI.Domain.Classes.PDF.CustomField, optional),
ForSign (boolean, optional)
}
ETI.Domain.Classes.PDF.FieldGroup {
FormID (integer, optional),
FormInstance (integer, optional),
Order (integer, optional),
HTMLFields(Array[ETI.Domain.Classes.PDF.HTMLField], optional)
}
ETI.Domain.Classes.PDF.NativeESignature {
FieldName (string, optional),
SignURL (string, optional),
Width (number, optional),
Height (number, optional),
GeoLocation (string, optional),
SignDate (string, optional),
NewSignature (boolean, optional)
}
ETI.Domain.Classes.PDF.CustomField {
MetaData(Array[ETI.Domain.Classes.PDF.CustomFieldMetaData], optional),
Fields (Array[ETI.Domain.Classes.PDF.HTMLField], optional)
}
ETI.Domain.Classes.PDF.HTMLField {
Name (string, optional),
Value (string, optional)
}
ETI.Domain.Classes.PDF.CustomFieldMetaData {
Name (string, optional),
Left (number, optional),
Top (number, optional),
Width (number, optional),
Height (number, optional),
Page (integer, optional),
RelPage (integer, optional),
Value (string, optional),
FormID (string, optional)
}

