Synchronize Fees

Synchronization of service plan fees is the next step after the fees are updated at the highest level of the sales channel hierarchy.

../../../_images/price-step-init.png ../../../_images/price-step-get.png ../../../_images/price-step-update.png ../../../_images/price-step-sync-b.png

Applicable Scenarios

There are at least two cases in which synchronization of the delegated service plans is required:

  • The provider delegates service plans to resellers. However, the resellers cannot see the delegated plans until the provider synchronizes them with the resellers.

  • The provider needs to update some fees in the delegated service plans. To have the same fees appear in the delegated service plans on the reseller side, the synchronization is required.

Create Resellers

As explained in the Customization for Sales Channels document, the typical reseller creation process consists of the following steps:

  1. In OSS, create a branding service template (ST) containing reseller specific resources. We will call it branding ST.

  2. In BSS, create an ST based on the Reseller gateway and bind it to the branding ST. We will call it L1 reseller ST.

  3. In BSS, use the newly created L1 reseller ST to create a service plan (SP) that the provider will need to assign the L1 reseller status to its partners. We will call it L1 reseller SP.

  4. Subscribe an account to the L1 reseller SP to assign the L1 reseller status to that account. Repeat this step for every new reseller contract.

Create Branding ST

In the OSS PCP, create a branding service template containing reseller specific resources:

  1. Navigate to Products > Service Templates and click Add New Service Template.

  2. In the Name field, enter a name, for example, “L1 Reseller Resources”, and then click Next.

  3. Select at least the following two resources (they are generally necessary for a reseller):

    • The Client accounts resource allows a reseller to have their own customers.

    • The Reseller accounts resource allows a reseller to have their own sub-resellers.

    Click Next.

  4. Do not change the limits in this demo and click Next.

  5. In the final step, click Finish.

You have a new branding ST in OSS.

Create L1 Reseller ST

In the BSS PCP, create a new ST that (along with the SP considered later) that will allow the provider to create resellers and delegate service plans to resellers.

  1. Navigate to Products > Service Plans and on the Service Template tab, click Add New Service Template.

  2. Select the Resellers Management gate and then click Next.

  3. Fill out the form with ST properties:

    ../../../_images/reseller-st.png
    • In the Name field, enter “L1 Reseller”.

    • In the Version field, enter “1”.

    • Check the Active box.

    • In the Branding Template selection field, select the newly created “L1 Reseller Resources” branding ST.

    • In the Order Flow selection field, select the Default Order Flow.

    Click Save.

You now have a new L1 reseller ST for managing resellers through the BSS reseller gateway.

Create L1 Reseller SP

In the BSS PCP, create a new SP for creating reseller subscriptions that define the reseller status. A reseller is active while their reseller subscription is active.

  1. Open the L1 reseller ST you have created in the previous section.

  2. On the Plans tab, click Add New Service Plan.

  3. Fill in the necessary properties:

    • In the Name property, enter “L1 Reseller”.

    • In the Short Summary and Detailed Description enter any text.

    • Check the Published box.

    Click Next.

  4. In the list of subscription periods, select 1 Year and click Next.

  5. In the next screen, click Finish.

  6. To activate the new SP, first create a sales category for it:

    • Navigate to Products > Service Plans and on the Sales Categories tab, click Add Sales Category.

    • Fill out the open form:

      • In the Category Name, enter “Reseller Plans”.

      • Type any text in the required description fields.

      • Check the Expand box.

      Click Save.

  7. Open the newly created sales category and on the Service Plans tab, bind it to the new L1 reseller SP.

You now have a new L1 reseller SP to be used to assign the reseller status to accounts by subscribing those accounts to the SP.

Create and Activate Reseller

In this step, you will create a new account and subscribe it to the L1 reseller SP to assign the reseller status to the account.

  1. In BSS PCP, navigate to Operations > Orders and click Create Account And Place Order.

  2. Leave the configuration in the first step intact and click Next.

  3. In the Account Settings step, enter the required account parameters and click Next.

  4. In the Control Panel Settings step, enter the login name and password and then click Next.

  5. In the Edit Order Details step, select the L1 reseller SP and 1 year subscription period. Click Next.

  6. In the final step, click Place order.

  7. Open the new sales order and click Open Order. This will start the order provisioning process.

  8. Click Check Order Provisioning Status to verify if the order provisioning is completed.

  9. Navigate to Operations > Resellers to verify that the new reseller is there in the list. Its status must be Not initialized.

  10. To open the Reseller Control Panel (RCP), click on the icon in the last column called Actions. You will be forwarded to the OSS RCP where you will work on behalf of the reseller.

  11. Click on the Billing icon on the top-right to enter to the BSS RCP.

  12. Select the regional currency for the new reseller and click Save and Continue.

Now you have a new active reseller. Find the respective APS resource by sending a request similar to the following:

GET /aps/2/resources/0ab950d1-abc9-4433-a87d-8ba009bf4bce/accounts

The response will contain the list of all L1 resellers. The aps.id property is the APS ID of the APS resource, for example:

HTTP/1.1 200 OK

[
   {
      "aps": {
         "type": "http://parallels.com/aps/types/pa/account/1.3",
         "id": "c5859e80-2db0-492a-af9f-425e1eccc5be",
         "status": "aps:ready",
         "revision": 3,
         "modified": "2017-08-11T07:14:45Z"
      },
      ...
   },
   ...
]

Now you have a new active reseller and you know the APS ID of the respective APS resource.

Delegate Service Plans to Resellers

Use the L1 reseller ST to delegate service plans to resellers.

  1. In BSS PCP, navigate to Products > Service Plans and on the Service Templates tab, click on the L1 reseller ST to open it.

  2. On the Delegated Plans tab, click Add New Delegated Plan(s).

  3. Select the plans you used to test the REST operations and click Add Selected Items.

You have delegated SPs that you will make available to resellers in the next step.

Synchronize Delegated Plans with Resellers

Since the SPs were delegated after the creation of the resellers, the latter cannot see those SPs yet. Verify if the list of plans is empty for the reseller by navigating in BSS RCP to Products > Service Plans.

You can synchronize the delegated service plans with resellers using one of the following ways:

  • Synchronize all service plans added as delegated in a particular reseller service template, for example, “L1 Reseller” service template, with all resellers subscribed to the reseller service plan, for example, “L1 Reseller”, based on that reseller service template. This requires the following steps:

    1. In BSS, open the “L1 Reseller” service plan.

    ../../../_images/reseller-sync1.png
    1. Click either Synchronize All Resellers to synchronize with all resellers down the account tree or Synchronize Direct Resellers to synchronize only the top-level resellers directly subscribed to the specified reseller service plan.

    2. Select necessary components for the synchronization and click Synchronize.

  • Synchronize service plans with a particular reseller. For this purpose, do the following:

    1. In BSS, open that reseller.

    2. On the bottom of the screen, click either Synchronize This Reseller and Sub-Resellers to synchronize this reseller and all its sub-resellers or Synchronize This Reseller to synchronize this reseller only.

    3. Select the components necessary for the synchronization and click Synchronize.

For more details about the synchronization process, refer to Reseller Synchronization.

Verify that this time the list of plans is not empty for the reseller by navigating in BSS RCP to Products > Service Plans.

Update and Synchronize Fees

Any time the management system needs to update the fees throughout the sales channels, it can first update the prices at the highest level using the updateRates operation and then synchronize the fees with the resellers and subresellers.

  1. Update the prices as explained in the Update Specified Fees section:

    PUT /aps/2/services/sku-manager/vendor/0ab950d1-abc9-4433-a87d-8ba009bf4bce/rates
    
    [ {<SKU-1>}, ... {<SKU-N>} ]
    
  2. Synchronize the updates with resellers as explained in the Synchronize Delegated Plans with Resellers section.

On completion of these steps, the updated fees will be synced throughout the sales channels of the specified vendor.

Conclusion

This step demonstrated a typical scenario of creating sales channels, propagating the delegated service plans and updating the fees throughout the sales channels of a specified vendor.