Forms Data – Web Service

Forms Data – Web Service

To show a list of forms to your end users, you will need to manage a list of forms available to the user. Maintaining this list is done via the forms data web service. The web service requires user authentication information as well as dealer parameters in order to return the correct list of forms. In all valid requests, the list of forms can include any or all public dealer forms, broker/dealer forms, plus any other private dealer forms that the customer is specifically allowed to access.
Please see the QuikFormsWizard web application project with accompanying SQL Server database for a turnkey solution!
PLEASE CLICK ON THE URL'S BELOW TO SEE THE EXACT XML FORMAT OF EACH SERVICE
Production URL: https://websvcs.quikforms.com/qfem/v5200/formsdatawebservice.asmx
WSDL: https://websvcs.quikforms.com/qfem/v5200/formsdatawebservice.asmx?WSDL

Forms Data Methods:

The following methods are used to obtain all the data you need to properly display form information to your users. You should update your list of forms and dealers at least once per week, if not daily. You can update any other information as often as you'd like, but probably only need to once per month.
Each of the data sets returned by the methods below correspond to a table in your database (tables are provided – see section named "Managing And Displaying Forms To Users").

  • GetFormsList – returns a list of subscribed forms

  • GetDealerList – returns a list of subscribed dealers and attributes

  • GetDealerTypes – returns a list of dealer types

  • GetDealerTypeXREF – returns a list of dealers and their associated dealer types

  • GetCategoryList – returns a list of form categories

  • GetFormCategoryXREF – returns a list of forms and their associated categories

  • GetFormStateXREF – returns a list of states each form applies to

  • GetStatesList – returns a list of states used with forms

  • GetFormTransTypeXREF – returns a list of forms and their assigned transaction types

  • GetFormTransTypes – returns a list of transaction types that can be assigned to forms

  • GetFormSignRoles – returns a list of signatory roles on a set of forms

 

GetFormsList Details

Returns a list of the forms you have subscribed to and wish to show to your users.

SOAP Request

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap12:Header>
<AuthenticationHeader xmlns="https://websvcs.quikforms.com/QFEM/v5000/">
<CustomerID>string</CustomerID>
<UserName>string</UserName>
<Password>string</Password>
</AuthenticationHeader>
</soap12:Header>
<soap12:Body>
<GetFormsList xmlns="https://websvcs.quikforms.com/QFEM/v5000/">
<FormIDList>string</FormIDList>
<DealerIDList>string</DealerIDList>
<DealerName>string</DealerName>
<FormCategoryIDList>string</FormCategoryIDList>
<FormShortName>string</FormShortName>
<FormStatusIDList>string</FormStatusIDList>
<PublishDateFrom>dateTime</PublishDateFrom>
<PublishDateTo>dateTime</PublishDateTo>
<LitNo>string</LitNo>
<DealerTypeIDList>string</DealerTypeIDList>
<DealerStatusIDList>string</DealerStatusIDList>
<StateIDList>string</StateIDList>
<FormTransTypeIDList>string</FormTransTypeIDList>
</GetFormsList>
</soap12:Body>
</soap12:Envelope>

SOAP Body Request Parameters

The GetFormsList method returns a list of the customer's subscribed forms. Search criteria can be used to return subsets of records for real-time end-user searches. If using these web services to perform real-time queries, then this is the last web service to call.

Field Name

Data Type

Length

Required?

Description

FormIDList

String

8000 chars

NO

CSV list of unique form IDs

DealerIDList

String

8000 chars

NO

CSV list of unique dealer IDs

DealerName

String

1000 chars

NO

Quik! dealer company name

FormCategoryIDList

String

8000 chars

NO

CSV list of form category IDs

FormShortName

String

250 chars

NO

Short descriptive name of the form

FormStatusIDList

String

8000 chars

NO

CSV list of form status IDs

PublishDateFROM

Date

 

NO

The minimum date form was published to Quik! users

PublishDateTO

Date

 

NO

The maximum date form was published to Quik! users

LitNo

String

100 chars

NO

Literature number of the form, as provided by the dealer

DealerTypeIDList

String

8000 chars

NO

CSV list of dealer type IDs

DealerStatusIDList

String

8000 chars

NO

CSV list of dealer status IDs

StateIDList

String

8000 chars

NO

CSV list of state IDs

FormTransTypeIDList

String

8000 chars

NO

CSV list of transaction type IDs

 

SOAP Response

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetFormsListResponse xmlns="https://websvcs.quikforms.com/QFEM/v5000/">
<GetFormsListResult>
<ErrorCode>int</ErrorCode>
<Message>string</Message>
<ResultData>
<xsd:schema>schema</xsd:schema>xml</ResultData>
<File>base64Binary</File>
</GetFormsListResult>
</GetFormsListResponse>
</soap12:Body>
</soap12:Envelope>

Result Fields

The GetFormsList method returns a list of the customer's subscribed forms. Search criteria can be used to return subsets of records for real-time end-user searches. If using these web services to perform real-time queries, then this is the last web service to call.

Field Name

Data Type

Length

Description

FormID

Integer

 

Quik! unique form ID

DealerID

Integer

 

Quik! unique dealer ID

DealerName

String

1000 chars

Quik! dealer company name

FormShortName

String

250 chars

Short descriptive name of the form

FormDesc

String

1000 chars

Long description of the form

FormStatusID

Integer

 

Form status (1 = active / 2 = inactive)

PublishDate

Date

 

Date form was published to Quik! users

FileSize

Integer

 

File size of form's PDF file in bytes

LitNo

String

100 chars

Literature number of the form, as provided by the dealer

NoPages

Integer

 

Number of pages in the form's PDF file

DealerStatus

String

255 chars

Dealer status description


GetDealerList Details

Returns a list of dealers and their attributes based on the forms that you have subscribed to. This information is helpful for displaying a form's dealer (company) name.

SOAP Request

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap12:Header>
<AuthenticationHeader xmlns="https://websvcs.quikforms.com/QFEM/v5000/">
<CustomerID>string</CustomerID>
<UserName>string</UserName>
<Password>string</Password>
</AuthenticationHeader>
</soap12:Header>
<soap12:Body>
<GetDealerList xmlns="https://websvcs.quikforms.com/QFEM/v5000/">
<DealerIDList>string</DealerIDList>
<DealerName>string</DealerName>
<DealerStatusIDList>string</DealerStatusIDList>
</GetDealerList>
</soap12:Body>
</soap12:Envelope>

SOAP Body Request Parameters

The GetDealerList method returns a list of the customer's subscribed dealers and attributes.

Field Name

Data Type

Length

Required?

Description

DealerIDList

String

8000 chars

NO

CSV list of unique dealer IDs

DealerName

String

1000 chars

No

Quik! dealer name (form company)

DealerStatusIDList

String

8000 chars

NO

CSV list of dealer status IDs

 

SOAP Response

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetDealerListResponse xmlns="https://websvcs.quikforms.com/QFEM/v5000/">
<GetDealerListResult>
<ErrorCode>int</ErrorCode>
<Message>string</Message>
<ResultData>
<xsd:schema>schema</xsd:schema>xml</ResultData>
<File>base64Binary</File>
</GetDealerListResult>
</GetDealerListResponse>
</soap12:Body>
</soap12:Envelope>

Result Fields

Field Name

Data Type

Length

Description

DealerID

Integer

 

Quik! dealer unique ID

DealerName

String

1000 chars

Quik! dealer name (form company)

DealerStatusID

Integer

 

Dealer status unique ID

DealerStatus

String

255 chars

Dealer status description


GetDealerTypes Details

Returns a list of dealer types that apply to the companies that provide forms. Dealer types include Insurance, Annuity, Broker/Dealer, Clearing House, etc.

SOAP Request

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap12:Header>
<AuthenticationHeader xmlns="https://websvcs.quikforms.com/QFEM/v5000/">
<CustomerID>string</CustomerID>
<UserName>string</UserName>
<Password>string</Password>
</AuthenticationHeader>
</soap12:Header>
<soap12:Body>
<GetDealerTypes xmlns="https://websvcs.quikforms.com/QFEM/v5000/">
<DealerTypeIDList>string</DealerTypeIDList>
</GetDealerTypes>
</soap12:Body>
</soap12:Envelope>

SOAP Body Request Parameters

The GetDealerTypes method returns a list of dealer types for use when selecting dealers.

Field Name

Data Type

Length

Required?

Description

DealerTypeIDList

String

8000 chars

NO

CSV list of dealer type IDs

 

SOAP Response

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetDealerTypesResponse xmlns="https://websvcs.quikforms.com/QFEM/v5000/">
<GetDealerTypesResult>
<ErrorCode>int</ErrorCode>
<Message>string</Message>
<ResultData>
<xsd:schema>schema</xsd:schema>xml</ResultData>
<File>base64Binary</File>
</GetDealerTypesResult>
</GetDealerTypesResponse>
</soap12:Body>
</soap12:Envelope>

Result Fields

Field Name

Data Type

Length

Description

DealerTypeID

Integer

 

Dealer type unique ID

DealerType

String

255 chars

Dealer type

For help regarding Quik! Forms and the Quik! API
Email: support@quikforms.com | Phone: (877) 456-QUIK