The AddLicenseOrder function is used to add a complete License Order to LAC.

This function requires a login token (obtained using the Login function), the Customer ID, and the Product Template ID. A License Order object with pre-filled values can be retrieved from LAC using the GetLicenseOrderTemplate method, and then changes to the template values can be made in this method.

See ID fields for information about using the ID field.

Return values

On success, the result string contains the activation key of the created license order.

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:AddLicenseOrder soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <token xsi:type="xsd:string">bf1a02f2554e71b6867dae307956a2e4fa1abe1e</token>
         <licenseOrder xsi:type="ns:Soap_LicenseOrder">
               <!--You may enter the following 9 items in any order-->
               <customer_id xsi:type="xsd:int">1</customer_id>
               <product_template_id xsi:type="xsd:int">1</product_template_id>
               <activation_key xsi:nil="true"/>
               <creation_time xsi:type="xsd:string"></creation_time>
               <license_type xsi:type="xsd:string">local</license_type>
               <licensee_type xsi:type="xsd:string">not_specified</licensee_type>
               <licensee xsi:nil="true"/>
               <hostid_match_rate xsi:type="xsd:int">100</hostid_match_rate>
               <min_hostids xsi:type="xsd:int">1</min_hostids>
               <activated_licenses_count xsi:type="xsd:int">0</activated_licenses_count>
               <enabled xsi:type="xsd:boolean">true</enabled>
               <description xsi:type="xsd:string">desc</description>
               <Hostids SOAP-ENC:arrayType="ns1:Soap_Hostid[1]" xsi:type="ns1:ArrayOfSoap_Hostid">
                  <item xsi:type="ns1:Soap_Hostid">
                     <name xsi:type="xsd:string">Not Locked</name>
                     <min_amount xsi:type="xsd:int">1</min_amount>
                     <max_amount xsi:type="xsd:int">1</max_amount>
                  </item>
               </Hostids>
               <Features SOAP-ENC:arrayType="ns1:Soap_Feature[1]" xsi:type="ns1:ArrayOfSoap_Feature">
                  <item xsi:type="ns1:Soap_Feature">
                     <name xsi:type="xsd:string">f1</name>
                     <version xsi:type="xsd:string">1</version>
                     <expiration_type xsi:type="xsd:string">no_expiration</expiration_type>
                     <expiration_date xsi:nil="true"/>
                     <additional_settings xsi:nil="true"/>
                     <enabled xsi:type="xsd:boolean">true</enabled>
                     <days_from_activation xsi:nil="true"/>
                     <count xsi:nil="true"/>
                  </item>
               </Features>
         </licenseOrder>
      </ns:AddLicenseOrder>
   </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:AddLicenseOrderResponse>
         <return xsi:type="ns1:Soap_Response">
            <result_code xsi:type="xsd:int">0</result_code>
            <result_string xsi:type="xsd:string">58ARD-JETMQ-7Z4NQ-WMOEL</result_string>
         </return>
      </ns1:AddLicenseOrderResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
  • No labels