#Ingram Micro Xvantage

The following procedures can help you smoothly integrate Elements with the Ingram Micro Xvantage marketplace:

1. Add a reseller from the Ingram Micro Xvantage marketplace to manage customers' tenants within Elements. For details, refer to Manage Resellers.

2. Add a Tenant to the Ingram Micro Xvantage module for the customer you want to manage.

3. Connect the customer tenant in Elements to the Ingram Micro Xvantage marketplace. For details, refer to Connect a Tenant to Ingram Micro Xvantage.

4. Once a tenant is connected to Ingram Micro Xvantage, you can view the click the tenant name to manage licenses for the tenants. For details, refer to Manage Subscriptions and Licenses for a Tenant.

#Manage Resellers

To manage customers’ tenants in the Ingram Micro Xvantage marketplace within Elements, the reseller of customers needs to be configured in Elements. To manage resellers in the Ingram Micro Xvantage marketplace, click View details on the Resellers tile. On the Resellers page, you can perform the following actions:

• Add reseller – To add a reseller from Ingram Micro Xvantage to Elements, refer to Add a Reseller.

• Edit reseller – To edit the information of an existing reseller, select the reseller and click Edit.

• Delete reseller – To delete an existing reseller that is not connected to the marketplace, select the reseller and click Delete. Click OK in the confirmation window.

• View and edit reseller details – To edit the basics and customize prices for licenses of a reseller, click the reseller's display name to access the reseller details page. For details, refer to View and Edit Reseller Details.

#Add a Reseller

Refer to the following steps to add a new reseller in the Ingram Micro Xvantage marketplace to Elements:

1. On the Resellers page, click Add reseller in the upper-right corner.

2. Complete the following information about the reseller, and click Next.

   • Display name – Enter a display name for the reseller.

   • Region – Select the region of the reseller.

   • Subscription key – Enter the subscription key that provides access to the Ingram Micro Xvantage marketplace APIs.

   • API account username – Enter the username of the API account.

   • API account password – Enter the password of the API account.

3. Select the reseller from the marketplace.

4. Click Save to add the reseller.

#View and Edit Reseller Details

On the Reseller details page, the basic information of the reseller is displayed under the Basics tab. To update the information of the reseller, hover your mouse over the corresponding fields and click the pencil button.

Under the License mapping tab, you need to map the reseller’s licenses to subscriptions in the Ingram Micro Xvantage marketplace to retrieve and purchase the licenses. The following actions are available:

• Select the mapped subscription for each license in the Ingram Micro Xvantage column.

• To add a new mapping, click Add mapping. In the Add mapping window, select a license and the mapped subscription in the marketplace, then click Save.

• To delete a mapping, select the mapping and click Delete.

Under the Price customization tab, you can customize your own prices for plans, and the prices will be used to generate the cost reports on the Overview page. Click Add plan to add plans by defining the vendor, subscription, subscription period, and billing period. Enter the desired price for each license plan in the Price column. There is a convenient method to specify a percentage to adjust customer license prices proportionally using the current reseller price as the baseline. Select the plans you want to configure and click Set a uniform price. Enter an increase percentage value and click Save. The custom prices will be automatically calculated based on the percentage and the reseller prices.

#Add a Tenant

If an existing customer has tenants that are managed in the Ingram Micro Xvantage marketplace, you can add those tenants to the Ingram Micro Xvantage module in Elements.

Refer to the following steps to add a new tenant of an existing customer to the Ingram Micro Xvantage module in Elements:

1. On the Marketplace > Ingram Micro Xvantage page, click Add tenant in the upper-right corner.

2. Select a customer in Elements from the drop-down list, and then click Continue.

3. Select a tenant of the customer.

   If there are no available tenants for the customer, you can click Add new tenant. For detailed instructions on how to add a tenant, refer to Add a Microsoft 365 Tenant.

4. If the APElements Security and Analysis app for the tenant has already been consented, a green checkmark icon will appear. Click Save to add the tenant.

5. If the APElements Security and Analysis app for the tenant needs to be consented, complete the following steps:

   1. Click Authenticate.

   2. The permissions required for this app are displayed. Review the permissions and click Accept.

   3. A page appears indicating that the app was authorized. Close this page, and you will be redirected back to the Add tenant panel.

   4. Click OK to add the tenant.

#Disconnect a Tenant

You can disconnect tenants from Elements. To disconnect a tenant, select the tenant, click Disconnect tenant. A window appears asking for your confirmation. Enter Yes in the text box and click Disconnect to confirm your operation.

#Connect a Tenant to Ingram Micro Xvantage

To manage licenses for a marketplace, you need to connect the tenants in Elements to the marketplace. After adding a tenant in Elements, refer to the following steps to connect the tenant to Ingram Micro Xvantage:

1. Select the tenant and click Connect to Ingram Micro Xvantage.

2. In the Connect to Ingram Micro Xvantage window, select a reseller from the Reseller drop-down list, and then select a customer in Ingram Micro Xvantage to map to the tenant.

3. Click Save to connect the tenant to Ingram Micro Xvantage.

Once a tenant is connected, you can also edit the connection by selecting the tenant and clicking Edit connection.

If you no longer need to manage a tenant, you can disconnect it from Ingram Micro Xvantage. Select the tenant and click Disconnect from Ingram Micro Xvantage. In the confirmation window, click OK.

#Manage Subscriptions and Licenses for a Tenant

After you access a tenant, you can view and manage the customers’ subscriptions and licenses under these tabs: Subscriptions, Orders, Store, and Audit logs.

From the left navigation, you can also access the License change requests page to manage all license change requests of the tenant.

If you want to enable approval processes, auto-purchase, or auto-decrease for the licenses, go to Tenant settings > Licenses. Refer to Licenses for details.

#Subscriptions

After purchasing a subscription, you can view your current subscriptions under the Subscriptions tab.

Click the name of a subscription to go to the Subscription details page.

• Basics – The basic information of the subscription is retrieved from Ingram Micro Xvantage and displayed. The following actions may be available based on different subscription status after you click Manage subscription in the upper-right corner:

  • Cancel subscription – If any subscription is suspended and has reached the end date, you can click Cancel subscription to cancel it.

  • Enable/Disable auto-renewal – If you want to enable/disable the auto-renewal for a subscription, you can click Enable auto-renewal/Disable auto-renewal to enable or disable the auto-renewal for it.

• Options – The options for the subscriptions are listed with their quantities and prices. You can edit the quantity of each option.

• Audit logs – All actions performed to the current subscription within Elements are listed in the table. You can click Refresh to view the latest records.

#Orders

You can view all orders of the current tenant.

Click the order number link of an order to view its details.

#Store

Under the Store tab, you can view all your subscriptions from Ingram Micro Xvantage. Click the subscription name link to view the general information of the subscription.

• Basics – The basic information of the subscription is retrieved from Ingram Micro Xvantage and displayed.

• Dependent subscriptions – The dependent subscription information of the current subscription. By clicking the subscription name link can also view and manage its details.

• Plan cost – The cost information of the subscription.

• Audit logs – All actions performed to the current subscription within Elements are listed in the table. You can click Refresh to view the latest records.

In the store, you can purchase licenses for the current subscription by clicking the Purchase button in the upper-right corner of the Details page. In the Purchase subscription window, enter the reseller PO number in the marketplace and configure the quantity you want to purchase, and then click Purchase to purchase the licenses.

#Audit Logs

All actions performed for this tenant of the current marketplace are listed in the table. You can click Refresh to view the latest records.