Enabling 'Costs Only' as the Default Rating Mode for New Service Plans

Costs Only is one of the rating modes you can enable for service plans.

To set Costs Only as the rating mode enabled by default for all new service plans:

1. Make sure that Rating Engine is deployed and configured.

2. Make sure that during Rating Engine deployment the applications whose resources must be rated and the billing rules to apply were specified.

3. Update Rating Engine configuration using the common CloudBlue Commerce component upgrade procedure and updating the config.yaml in the following way:

   1. If necessary, update the list of applications for which Rating Engine must calculate provider costs:

      In the config.yaml, set the ratingengine-backend.ratingaplications parameter to:

      • null: to compute provider costs for all applications:

        ratingengine-backend:
            ratingaplications: null

      • <a list of application names>: to compute provider costs for specific applications. For example:

        ratingengine-backend:
            ratingaplications: O365_APS2,DocuSign

      Note: For an application name, go to OSS > Applications > click an application > switch to the General tab > copy the Name field value.

   2. Update billing rule mappings for the applications:

      In the config.yaml, set the ratingengine-backend.rulesmapping parameter to a JSON with the necessary billing rule mappings, for example:

      Note: Escape the quotation marks.

      ratingengine-backend:
          rulesmapping: '"[{\"application_name\": \"O365_APS2\", \"rules_name\": \"o365-new\"},{\"application_name\": \"DocuSign\", \"rules_name\": \"docusign-new\"}]"'

4. Migrate subscription history of all selected applications from the BSS database to the Rating Engine database. For more information, contact your CloudBlue Commerce Technical Account Manager.

5. Create a custom attribute with the following configuration:

   • Name: MARKETPLACE_CODE

   • Applicable to: set to Accounts

6. Assign the MARKETPLACE_CODE attribute to all operating unit accounts for which you want to enable provider cost calculation.

7. Enable the following special feature in the Billing database: FEA_AutoEnableRatingMode.

   As a result, a new event, Auto Enable Rating Mode For Plans, will be added to BSS. It will be executed automatically once a day and will do the following:

   • Find all new service plans with Rating Mode not set.
   • Set Rating Mode to Costs Only for all service plans that satisfy the requirements, including delegated service plans.
   • Will not set Rating Mode for service plans that do not satisfy the requirements.
8. Configure provider costs using Product Inventory.

'Costs Only' Rating Mode Requirements for Service Plans

To automatically set Rating Mode to Costs Only for a service plan:

1. Enable Costs Only as the default rating mode for all new service plans.
2. When creating a service plan, make sure that it contains only resources delivered by the applications listed in the ratingengine-backend.ratingaplications parameter in the config.yaml.

Related Topics

• Setting 'Costs Only', 'Revenue Only', or 'Revenue and Costs' Rating Mode for Service Plans
• Upgrading Components