The FindLicenseByExpirationDate function is used to to find all licenses that have an expiration date that is earlier than the date specified in this function.
This function requires a LAC administrator token, which is obtained using the Loginfunction, and an expiration date in the format YYYY-MM-DD. For example, if you have three licenses that expire on 2011-05-26, 2011-09-10, and 2012-12-02, and you specify an expiration date of 2011-09-10 in this function, the first two licenses will be returned.
In addition, this function uses an offset. Licenses are packed into arrays of 100 elements. You can use an offset greater than 0 to get additional licenses. For example, if you have 321 licenses, you would run this method 4 times using the offsets 0, 100, 200, 300. The first 3 responses will have 100 licenses each, and the last response will have 21 licenses.
See ID fields for information about using the ID field.
Return values
On failure, the result string contains an error message. See Return Codes for further information on error messages.
Example request
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://license.x-formation.com/soap/type/vendor/version/1?wsdl"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
<soapenv:Header/>
<soapenv:Body>
<ns:AddCustomer soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<token xsi:type="xsd:string">e84b130bcd3fdf26644064098acdf9f3e5a3bfaa</token>
<customer xsi:type="ns:Soap_Customer">
<!--You may enter the following 12 items in any order-->
<id xsi:type="xsd:int">0</id>
<name xsi:type="xsd:string">Customer Name</name>
<street xsi:type="xsd:string">Street Name</street>
<zip_code xsi:type="xsd:string">55562</zip_code>
<city xsi:type="xsd:string">City Name</city>
<state xsi:type="xsd:string">State Name</state>
<country xsi:type="xsd:string">Country Name</country>
<phone_number xsi:type="xsd:string">223236</phone_number>
<fax_number xsi:type="xsd:string">223236</fax_number>
<vat_number xsi:type="xsd:string">123</vat_number>
<description xsi:type="xsd:string">Optional description for this customer</description>
<Contacts xsi:type="ns:ArrayOfSoap_Contact" soapenc:arrayType="ns:Soap_Contact[]"/>
</customer>
</ns:AddCustomer>
</soapenv:Body>
</soapenv:Envelope>
Example response
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://license.x-formation.com/soap/type/vendor/version/1?wsdl"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:AddCustomerResponse>
<return xsi:type="ns1:Soap_Response">
<result_code xsi:type="xsd:int">0</result_code>
<result_string xsi:type="xsd:string"/>
</return>
</ns1:AddCustomerResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>