Applying Distributor Updates

A tenant reseller can only resell products included in the pricelist assigned to them by their distributor. Changes made by the distributor to the reseller’s pricelist (price updates, new product additions, etc) are propagated to the reseller’s BSS with the following process.

This update process ensures that only changes made at the distributor level (Root BSS) are transferred to the tenant’s BSS, including new SKUs, price adjustments, discontinued products, or changes in add-on relations. The process is automated and does not require user monitoring.

Update Tenant Reseller


The Update Tenant functionality was previously available on the Pricelist details page but has now been relocated to the Tenant Reseller page after the 3.28.171 Release.

The distributor can control when the changes made in the product catalog are applied to a tenant reseller by initiating the Update Tenant action within each Tenant Reseller page. The update can either be full or partial.

  • Full Update: All product catalog changes will be propagated towards the Tenant organization.

  • Partial Update: Only price changes that affect the purchase price of a product in the Tenant organization are propagated.

 

To proceed with the update as a distributor, follow the steps below:

  1. Navigate to the Tenant Resellers page in BSS from the left sidebar.

    image-20241127-112651.png

  2. Select the Tenant Reseller you wish to update.

  3. Click Update Tenant from the Shortcuts menu.

    menu-crop.jpg

The Update Tenant option is only available if the Tenant Reseller is active (and not in status In Progress, Suspended, or Marked as Deleted).

  1. A new pop-up window will appear, displaying the two available options: Full Update or Partial Update.

    Select Full Update to propagate all product catalog changes to the Tenant organization.


    Alternatively, select Partial Update to propagate only price changes that affect the purchase price of a product in the Tenant organization.

     

  2. Check the boxes to indicate whether to include additional updates of the sell prices, product names, or product availability.

  • The Product Availability checkbox option in Partial Updates will update the existing products in the Tenant Reseller organization, indicating whether each product is active or inactive. To add new products, you need to select the Full Update option.

  • For Country Tenants, sell prices are updated by default. In this case, the Update Sell Prices checkbox is automatically enabled by the system and cannot be unchecked.

  1. Click Update.

  2. A confirmation window will appear to indicate that the process is complete.

 

Full Update Tenant

Full Update Tenant propagates all changes made to a Root (Distributor) Organization towards the Tenant Organization, ensuring that the product catalogs in both organizations remain consistent.

Changes to the following features will be applied to the reseller's BSS:

  1. New products or add-ons: Any new product or add-on added to the reseller's price list is copied in their BSS as described on the Product Catalogue Initialization page. 

  2. Pricelists: If the price of a product changes in the distributor’s pricelist, the purchase price in the reseller's BSS is updated accordingly.

  3. Notifications: New system notifications and custom notifications are created in Tenant organizations based on changes in products or modules.

  4. Product Names: Any changes to product names will be reflected in the Tenant Reseller organization to align with the names in the Root Organization.

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

  6. 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.

  7. Product activation or de-activation: If a product is activated or de-activated in the Root Organization, it updates accordingly in the Reseller's BSS.

  8. Product Relations: Any new upgrade, downgrade, required, or cross-relation between two products is copied in the Reseller's BSS.

  9. Product Groups: The following updates will be applied to the reseller's BSS:

    • Products in the pricelist that now belong to a new product group will have the new group created in the reseller's BSS, along with the corresponding marketing materials.

    • A new product has been added to an existing product group.

    • A product has been removed from a product group.

    • A product has been moved from one product group to another.

    • If an existing product group no longer contains any products from the reseller's pricelist, it will be removed from the reseller's BSS.

  10. Product Type: Any changes made to the following product type options will be reflected in the corresponding product type in the reseller's BSS:

    • Automatic execution of add-on cancellation requests.

    • Automatic execution of subscription cancellation requests.

    • Automatic execution of downgrade requests.

    • Quantity limits.

    • Maintaining one active subscription per product.

       

Partial Update Tenant

Partial Update Tenant propagates a limited area of changes to the Tenant Organization's product pricelist, ensuring faster updates.

The Partial Update applies only to the purchase price of products in the Tenant Organization, including changes to the product price, pricing method, amount, or percentage in the pricelist.


De-assign Product from Reseller 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 Product from Products View

When a user de-assigns a product from a pricelist in the Products View, the same checks are applied, regardless of whether the product is active or inactive in the parent organization.

These checks refer to the product's status in the organization, not its catalog status (e.g., discontinued), and apply to provisioned products.

For bulk de-assign actions, the pop-up will display a list of all products/units that cannot be de-assigned, along with the specific reasons for each restriction, as shown in the figure below: