Add Service Usage

Owned by Persia Xenopoulou (Deactivated)
Last updated: Dec 01, 2016
4 min read

Back to Subscriptions Main Page

Table of Contents

When to use Add Service Usage

Use Add Service Usage to add Services, such as a movies, telephone logs or games, ordered by a subscriber. The available Usage Services are those defined in the Usage Service Catalogs. 
Once the Action is executed, Provisioning signals are sent to the subscriber's device to enable the ordered item, and UDR is created in the System and  billed immediately or in the next Billing Run.

Billing of Usage Services

For Prepaid and Normal: Usage Service orders are either billed right after execution or during the next Billing Run, according to the configuration of 'Usage Service Billing Rules' set in the 'Active' Billing Term Definition.

AVAILABLE FROM CRM.COM R10.0.0

For Prepaid - Usage Service orders for Subscriptions of Prepaid Billing Term Schemes are always billed instantly.

For Normal - Usage Service orders for Subscriptions of Normal Billing Term Schemes are billed according to the configuration of 'Usage Service Billing Rules' set in the 'Active' Billing Term Definition. They can either be billed right after the execution of the Action, if the number of unbilled Services is greater than the defined number, or if the amount of the unbilled Services is more than the defined amount. In all other cases, the Services will be billed by the next Billing Run.

View the Information Table below for information related to the Scheduling, Preview Rating and Classification of the Subscription Action.  Check the Validations & Restrictions Table for a list of available Actions, including each Action's related validations, restrictions and additional information.
View 'Using Subscription Action Modal' available in Managing Subscriptions for more information on executing the Action.

Subscription Action Information

Action can be scheduledPreview Rate AvailableBehaviour CodeBusiness Classification Code
(tick)(error)ADDSERVICEUSAGEADDSERVICEUSAGE

Restrictions & Validations

ActionValidationsRestrictionsAdditional InformationSystem Processing
Add Service Usage
  • The Subscription should be owned by an 'Active' Accounts Receivable.
  • If the Subscription follows a Prepaid Billing Term Scheme, the System validates that there are enough funds in the Wallet.
  • If the Subscription follows a Normal Billing Term Scheme and the Add Service Usage Action is in the selected list of events, the System validates that activation conditions defined in the Billing Term Definition are observed.
  • The Action is available only if the Subscription's Life Cycle State is 'Effective'.
  • A Termed Subscription Service should be selected as a prerequisite, whose Life Cycle State is not
    • Draft
    • Not Effective 
      or

    • Cancelled

  • Usage ServiceCatalogsare filtered on the following conditions:
    • The Usage Service Catalog is Effective
    • The Usage Service Catalog is valid during the period that the Action is scheduled to be executed
    • The Usage Service Catalog Provisioning Provider is the same as at least one Provisioning Provider of the selected termed Service
    • Specified Subscription conditions are fulfilled
    • Specified Accounts Receivable conditions are fulfilled
    • The User adding the Service belongs to one of the Allowed Organisational Units of the Usage Service Catalogs
  • If a Usage Service Catalog is specified, then the available Usage Services are filtered based on the Services included in the Usage Service Catalog.
  • If a Usage Service Catalog is not specified, then the available Usage Services are filtered based on the Services included in all the available Usage Service Catalogs (considering the Usage Service Catalogs filtering logic described above)

 

  • For prepaid subscriptions, the related wallet must have enough funds to activate all services. If at least one service cannot be activated then the action is rejected. If the action is successfully submitted the wallet is debited for all the services.

When an Action whose Scheduling Information set to NOW is submitted, both the submitting and executing steps take place directly.

When an Action is submitted as scheduled then only the submitting step takes place. The execution step takes place once the scheduled Action is executed.

  • On submitting the Subscription action:
    • A UDR is created for each submitted Usage Service.
    • UDR information is set based on the information specified for each submitted Usage Service.
      • The Billing Effective date is set equal to the date on which the Action is scheduled to be executed.
      • The Billing Directive is set to TobBeBilled.
    • If the Action is scheduled the UDR is created as scheduled. Otherwise the UDR is created as 'Posted'.

  • On executing the Subscription Action:
    • For each Usage Service classified as a Provisioning Service:
      • Subscription Service Provisioning Distributions are created based on the selected Termed Subscription Service and Provisioning Distributor.
      • Provisioning commands are sent to the related Provisioning Provider to enable the signal. Provisioning commands are sent directly.
    • Usage Services are rated and billed if they should.
    • If the Action was scheduled then the UDR is updated to 'Posted'.

Executing Add Service Usage

To place an order for a Usage Service, follow the steps below:

  1. INPUT

    1. Distributor: Select the Distributor on which the Service will be added. 

      1. The distributor must belong to a Provider that has a related Usage Service Catalog as it will be used as a filter on the Usage Services that will be provided for selection.

    2. Termed Service: Search for the Termed Service on which the Usage Services will be added.
      1. Used as a filter: It will be compared against the Termed Subscription Services Criterion available in the Usage Service Catalogs.
      2. Used as UDR information: Once the Action is submitted, the Termed Service defined will be added on the UDR.
    3. UDR information: 
      1. Fill out the UDR information which will be logged on the UDR that will be created. Note that UDR Type and UDR Usage Amount are mandatory.

  2. Filter Allowed Usage Services

    1. BY USAGE SERVICE CATALOG : The Usage Service Catalog from where the available Services should be retrieved. 

    2. BY PRODUCT FAMILY: The Product Family from where the available Services should be retrieved. 

    3. BY PRODUCT TYPE: The Product Type from where the available Services should be retrieved. 

    4. BY PRODUCT: The product (Usage Service) to be added. The text added is used with the LIKE operator.

    If you are looking for a Usage Service (e.g. a movie) which will be offered in the future, you should first select the Scheduled Date and then search for available Usage Services, as the Services are always filtered on their Validity.

View Understanding Usage Service Catalogs for business examples related to adding Usage Services on a Subscription.

Related Areas

Helpful Links