Applying Distributor Updates



The products that a tenant reseller can resell are the products that are included in the price list his distributor has assigned to him. The changes that a distributor can make in the reseller’s pricelist (prices update, addition of new products etc.) are propagated to the reseller’s BSS with the following process. Updating a tenant in BSS, involves the transfer of only the changes that have taken place on the root’s BSS towards the tenant. The changes include: Additions of SKU's, changes in prices, discontinued SKU's, changes in add-on relations. The process will isolate the differences between the root and the tenant and proceed to transfer only those. Additionally, the process does not need to be monitored by the user.

Update Tenant Reseller


The distributor can control when the changes he performed in the product catalog will be propagated to a tenant reseller by running the Update Tenant Reseller action that is available on the pricelist details page:

  1. Open the pricelist details page

  2. Select Products tab

  3. Select the action Update Tenant Reseller and in the pop-up, select which resellers you want to update

  4. Select if you want the update process to update also the sell prices in the tenant's BSS. This option is not preselected by default, but If you select it, the update process will update all sell prices in all products the reseller inherits from the distributor.  This is optional for the tenant reseller but compulsory for the country tenant.

  5. Select if you want the update process to update also the names of the products in the tenant's BSS. This option is not preselected by default, but If you select it, the update process will update the names of all products the reseller inherits from the distributor.  This is optional for the tenant reseller but compulsory for the country tenant.



Update Actions


The following changes will be applied to the reseller's BSS too:

  1. New products / add-ons: Any new products/add-ons added to the reseller's price list will be copied in his BSS as described on Product Catalogue Initialization page. 

  2. Change of pricelist price. If the price of a product changes in the reseller's pricelist, the purchase price in the reseller's BSS will be updated.

  3. Activation of a new billing cycle. If a new unit (e.g., annually) has been added to the reseller's pricelist, the reseller's product will be updated with the new unit and the corresponding pricing info. If the unit is not active in the reseller's BSS, it will also be activated.

  4. Removal of a billing cycle. If a product is no longer available for a specific unit (e.g., annually) in the reseller's price list, it will also be removed from the product in the reseller's BSS.

  5. Activation / de-activation of a product. The product is also activated / de-activated in the reseller's BSS.

  6. New upgrade/downgrade/required/cross-relation between two products already present in reseller's BSS: This relation is also copied in the reseller's BSS.

  7. Changes in product groups. The following changes will be applied to the reseller's BSS too:

    1. one or more products in pricelist belong now to a new product group.  The new group will be created in the reseller's BSS, and the corresponding marketing material will also be copied.

    2. A new product was added to an existing product group. 

    3. A product was removed from a product group.

    4. A product was moved from product group A to product group B.

    5. An existing product group is no longer related to any product from the reseller's pricelist. It will be removed from the reseller's BSS.

  8. Update of product type options. Any change that occurs to any of the following product type options will be applied to the correspondent product type in the reseller's BSS:

    1. Automatic execution of add-ons cancellation requests

    2. Automatic execution of subscription cancellation requests

    3. Automatic execution of downgrade requests

    4. Quantity Limit

    5. Maintain one active subscription per product




Validations when a Product is Removed from Reseller’s Pricelist


For the BSS user of a parent organization to de-assign a product of a specific unit (e.g., monthly, annually, etc.) from a pricelist used to transfer and charge products in a tenant organization, certain checks need to be made.

A check runs to determine whether the unit/product is used in any active entities in any related tenant organizations. The entities are:

  • Active subscriptions

  • Active assets

  • Active promotions

  • Unexecuted orders

If the item to be removed does not belong to any of these entities, it will be removed from the tenant’s product. If it does belong to any such entity, it cannot be de-assigned. Furthermore, if all product units are removed from the pricelist, the product will be set to inactive in the tenant organization.

The sequence of checks is as follows: Active subscriptions → active assets → promotions → unexecuted orders

Error Messages

If any of the above validations fail, a pop-up is displayed to the BSS user of the parent organization. The pop-up is displayed upon the removal of the item from the pricelist before the update tenant process. The pop-up reads:

  • For active subscriptions: "Product_name(Unit)" is not able to be removed from the pricelist as it is used in an active Subscription in Tenant’s Organization “TenantResellerName”.”
    The message is displayed if the subscription has an active, inactive, suspended, or pending cancellation status.

  • For active assets: "Product_name(Unit)" is not able to be removed from the pricelist as it is used in an active Asset in Tenant’s Organization “TenantResellerName”.”

  • For promotions: “Product_name(Unit)" is not able to be removed from the pricelist as it is used in an active Promotion in Tenant’s Organization “TenantResellerName”.”
    The message is only displayed if the promotion is active or pending and not if it is terminated.

  • For unexecuted or partially executed order: “Product_name(Unit)" is not able to be removed from the pricelist as it is used in an unexecuted order in Tenant’s Organization “TenantResellerName”.”

Successful Removal of Pricelist Item

When an item can be successfully removed from a reseller’s pricelist, we have the following scenarios in the reseller’s organization:

  • The item was the last in the reseller’s pricelist for the specific product (e.g., the product is not available to the reseller with a different unit). In this case, the product in the reseller’s organization will become inactive.

  • The item wasn’t the last in the reseller’s pricelist for the specific product (e.g., the product is still available to the reseller with a different unit), and it is its default unit. In this case, the remaining unit will be the default unit for this product in the reseller’s organization. If more than one unit is available, the unit with the shortest billing cycle will become the default unit.

 De-assign Unit/Product in Pricelist from ProductsView


If a user de-assigns a product from a pricelist in Products View, the same checks are performed. The checks are performed whether the product is active or inactive in the parent’s organization. This refers to the status of the product and not its status in the catalog (e.g., discontinued) and applies to provisioned products.

 

If a bulk de-assign is performed, the pop-up includes all the products/units for which this action is not allowed with their specific reasons as in the figure below: