AddOrUpdateLicense Method
This method adds or updates licenses for a single customer account that is related to the partner's account.
SOAP Request
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header> <AuthenticationHeader xmlns="http://websvcs.quikforms.com/Partner"> <PartnerID>string</PartnerID> <UserName>string</UserName> <Password>string</Password> </AuthenticationHeader> </soap:Header> <soap:Body> <AddOrUpdateLicense xmlns="http://websvcs.quikforms.com/Partner"> <CustomerID>int</CustomerID> <CustomerUserUniqueID>string</CustomerUserUniqueID> <ProductID>int</ProductID> <ProductLicenseStatusID>int</ProductLicenseStatusID> <ProductLicenseExpiryDate>dateTime</ProductLicenseExpiryDate> <FirstName>string</FirstName> <MiddleName>string</MiddleName> <LastName>string</LastName> <Suffix>string</Suffix> <EMail>string</EMail> <Phone>string</Phone> <PhoneExt>string</PhoneExt> <Fax>string</Fax> <AddressLine1>string</AddressLine1> <AddressLine2>string</AddressLine2> <AddressLine3>string</AddressLine3> <AddressLine4>string</AddressLine4> <City>string</City> <StateID>int</StateID> <Zip>string</Zip> <CountryID>int</CountryID> </AddOrUpdateLicense> </soap:Body> </soap:Envelope>
SOAP Body Request Parameters
The following parameters can be used with this web service. Required parameters are highlighted in RED. This method only operates against a single license as indicated by the CustomerID and the CustomerUserUniqueID values. You need only enter the values you wish to update and any parameters that are not populated will remain unchanged. If you wish to clear a value, populate the parameter with a space.
Field Name | Data Type | Length | Direction | Display | Required? | Description |
---|---|---|---|---|---|---|
CustomerID | Integer | 4 | In | YES | YES | The customer's CustomerID to associate the license |
CustomerUserUniqueID | String | 250 | In | YES | YES | The customer's unique ID to use for the license name (e.g. advisor name, rep name, user name, customer's UNID, any value that represents the license for the customer). |
ProductID | Integer | 4 | In | YES | NO | Default value if left blank is ProductID 14 (Quik! Forms Engine). Any valid/active product ID can be passed. |
ProductLicenseStatusID | Integer | 4 | In | YES | NO | If adding a new license, set the value to ACTIVE. If updating and empty, leave status the same. |
ProductLicenseExpiryDate | Date | 8 | In | YES | NO | Date to expire the product license |
FirstName | String | 250 | In | YES | NO | Licensee's First Name – if no first or last name, use the CustomerUser UniqueID as First Name |
MiddleName | String | 250 | In | YES | NO | Licensee's Middle Name |
LastName | String | 250 | In | YES | NO | Licensee's Last Name |
Suffix | String | 250 | In | YES | NO | Licensee's Suffix |
String | 1000 | In | YES | NO | Licensee's Email | |
Phone | String | 25 | In | YES | NO | Licensee's Phone |
PhoneExt | String | 25 | In | YES | NO | Licensee's Phone Extension |
Fax | String | 25 | In | YES | NO | Licensee's Fax |
AddressLine1 | String | 1000 | In | YES | NO | Licensee's Address line 1 |
AddressLine2 | String | 1000 | In | YES | NO | Licensee's Address line 2 |
AddressLine3 | String | 1000 | In | YES | NO | Licensee's Address line 3 |
AddressLine4 | String | 1000 | In | YES | NO | Licensee's Address line 4 |
City | String | 1000 | In | YES | NO | Licensee's City |
StateID | Integer | 4 | In | YES | NO | Licensee's State ID |
Zip | String | 15 | In | YES | NO | Licensee's Zip Code |
CountryID | Integer | 4 | In | YES | NO | Licensee's Country ID |
Product License Status ID
The following statuses apply to the Product License Status:
ProductLicenseStatusID | ProductLicenseStatus | ProductLicenseStatusDesc |
---|---|---|
1 | Active | The license is active and available for use |
2 | Inactive | The license is inactive and cannot be used |
3 | Delete | The license was marked for deletion |
SOAP Response
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <AddOrUpdateLicenseResponse xmlns="http://websvcs.quikforms.com/Partner"> <AddOrUpdateLicenseResult> <ErrorCode>int</ErrorCode> <Message>string</Message> <ResultData> <xsd:schema>schema</xsd:schema>xml</ResultData> </AddOrUpdateLicenseResult> </AddOrUpdateLicenseResponse> </soap:Body> </soap:Envelope>
Result Fields
The ResultData contains the following fields.
Field Name | Data Type | Length | Description |
---|---|---|---|
CustomerID | Integer | CustomerID for the added/updated record | |
CustomerUserUniqueID | Integer | Customer's User UNID for the added/updated record | |
ProductLicenseExpiryDate | Date | Date the license expires (returns NULL if no expiry date) | |
ProductLicenseStatusID | Integer | Product License Status ID | |
ProductLicenseStatus | String | 255 chars | Status of the product license record |
For help regarding Quik! Forms and the Quik! API
Email: support@quikforms.com | Phone: (877) 456-QUIK