> For the complete documentation index, see [llms.txt](https://docs.soraco.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.soraco.co/docs/api-reference/.net-api/qlmlicense/management-methods/createorderex.md).

# CreateOrderEx

### Description

Creates an activation key on the License Server.

Note that to call this function, you must:

* Enable the Server Property enableCreateActivationKey
* Set the AdminEncryptionKey
* Call [DefineProduct](/docs/api-reference/.net-api/qlmlicense/client-side-methods/defineproduct.md)

```csharp
void CreateOrderEx(string webServiceUrl, string email, 
                   int[] features, int quantity, 
                   bool useMultipleActivationsKey, string qlmVersion, 
                   string vendor, string userData1, 
                   string affiliateID, DateTime expiryDate, 
                   int expiryDuration, string orderID, 
                   int orderStatus, out string response)
```

### Parameters

| Parameter                 |   Type   | Description                                                                                                                                              |
| ------------------------- | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| webServiceUrl             |  string  | URL to the QLM License Server.                                                                                                                           |
| email                     |  string  | email address to associate with to the license key - can be empty                                                                                        |
| features                  |  int\[]  | array of feature sets. Each feature set is an OR'ed value of the features to enable in the feature set.                                                  |
| quantity                  |    int   | the number of licenses to create.                                                                                                                        |
| numSeats                  |    int   | the number of licenses to embed in the key. This controls how many activations are allowed per key.                                                      |
| useMultipleActivationsKey |   bool   | if set to true and quantity > 1, one license key will be generated for all required licenses. The number of licenses will be embedded in the license key |
| qlmVersion                |  string  | version of the QLM Engine                                                                                                                                |
| vendor                    |  string  | eCommerce vendor to use when generating the key                                                                                                          |
| userData1                 |  string  | user data to associate with the license key                                                                                                              |
| affiliateID               |  string  | ID of affiliate                                                                                                                                          |
| expiryDate                | DateTime | expiry date of the key. Set this value to DateTime.MinValue to not set an expiry date.                                                                   |
| expiryDuration            |    int   | Expiry duration of the key. Set this value to -1 to not set an expiry duration.                                                                          |
| orderID                   |  string  | ID of the order                                                                                                                                          |
| orderStatus               |    int   | set the order status of the license to one of the allowed values: EInProgress \| EComplete \| EUpgraded \| EReleased                                     |
| response                  |  string  | XML fragment containing the result of the call.                                                                                                          |

### Response XML format

```xml
<?xml version='1.0' encoding='UTF-8'?>
<QuickLicenseManager>
<keys>A062E-9D0CC-6DC80-0D6A0-E0701-000A0;A062E-9D0CC-6DC80-0D6A0-E0701-000A0</keys>
</QuickLicenseManager>
```

### Example error response

```xml
<?xml version='1.0' encoding='UTF-8'?>
<QuickLicenseManager>
<error>Details about the error</error>
</QuickLicenseManager>
```

## Remarks

Use [ParseResults ](/docs/api-reference/.net-api/iqlmcustomerinfo/methods/parseresults.md)to interpret the results of the call and load the returned data into an [ILicenseInfo ](/docs/api-reference/.net-api/ilicenseinfo.md)object.

```csharp
ILicenseInfo li = new LicenseInfo();
string message = string.Empty;
if (lv.QlmLicenseObject.ParseResults(response, ref li, ref message))
{
  // The operation  was successful	
}
else
{
  // The operation failed
}
```