What does this section cover?

When to use Add Service Usage

Use Add Service Usage to add usage services, such as a movie or a telephone log or a game, ordered by a subscriber. The Usage Services made available for selection are based on the available Usage Service Catalogs. 
Once the action is executed provisioning signals will be sent to the device of the subscriber to enable the item they have ordered, and UDR will be created in the system, that will either be billed immediately or in the next Billing Run executed. 

Add Service Usage Information

Action can be scheduled
Behavior Code	ADDSERVICEUSAGE
Business Classification Code	ADDSERVICEUSAGE

Restrictions & Validations

Executing Add Service Usage

1. Navigate to BILLING APPLICATION > BILLING > SUBSCRIPTIONS > MANAGE SUBSCRIPTIONS
2. Search for the Subscription you are looking for, using the criteria section
3. Click on the Subscription number to go to the Data Entry page of the subscription
4. On the left hand side of the screen you can see the ACTION PANEL
5. Click on Subscription Service Related Actions 
6. Find the action you would like to execute and click on the link to open the action details in a modal window
   

7. 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. (i.e. if your Usage Service Catalog, has PPV service in the criteria, and you select VOD service in the actions Termed Service, then the products in the Usage Service Catalog, won't be filtered.) 
         In addition it will be used when creating the UDR (after submitting the action) 
      2. Used as UDR information: Once the action is submitted the Termed Service defined will be added on the UDR
   3. UDR information: 
      1. The information displayed below will be written on the UDR that will be created. Note that UDR Type and UDR Usage Amount are mandatory
         1. Type: Search and add UDR's Type
         2. Usage Method:Search and add the usage method
         3. Device: Search and add for the device
         4. Source System: Search and add the source system
         5. Usage Amount: Type UDR's total usage amount
         6. Source ID: Type the ID of the source that initiated the service, for example the phone number that initiated a phone call
         7. Source Category: Search and add the category of the source that initiated the service. The source categories are filtered based on the selected UDR Type.
         8. Destination ID: Type the ID of the destination that received the service, for example the phone number that received a phone call
         9. Destination Category: Search and add the category of the destination that received the service. The destination categories are filtered based on the selected UDR Type

   FILTER AVAILABLE USAGE SERVICES

   1. BY USAGE SERVICE CATALOG

      1. Select from the drop down list the Usage Service Catalog from where you would like to retrieve available services

   2. BY PRODUCT FAMILY

      1. Select from the drop down list the Product Family from where you would like to retrieve available services

   3. BY PRODUCT TYPE

      1. Select from the drop down list the Product Type from where you would like to retrieve available services

   4. BY PRODUCT

      1. Type the name of the product (usage service) you would like to add. The text added is used along LIKE operator
         

8. Click on SEARCH

   If the usage service is not for immediate view, then you should first select the Scheduled Date and then search for available usage services, as they are always filtered based on their Validity

    

   1. From the populated list select the Usage Services that you would like to add by clicking on SELECT
      

9. PREVIEW & ACTION PANEL

   1. USAGE SERVICES TO BE ADDED

      1. Provides an overview of the usage services to be added on the subscription

      2. Click on REMOVE to remove the added Usage Services that you wouldn't like to add.
          

10. SUBSCRIPTION ACTION DETAILS

    1. Action Type: Select action type from the drop down if you have configured custom actions in the system, using the specific behaviour code
    2. Sub Action Type: Select action type from the drop down if you have configured custom actions in the system, using the specific business classification code
       Action Type and Sub Action type are visible only if applicable
    3. Performed By User : Search and add the user that logs the action 
       If you leave empty then the Logged in user will be set

    4. Performed Date: Click on the calendar icon and select date and time

    5. SCHEDULING INFORMATION

       1. NOW: Select Now to execute the action immediately
       2. ON A SPECIFIC DATE
          1. Click on the calendar icon and select a date
          2. Use the time scroller and select time or leave as is to set at midnight

          3. Click on DONE
             The date field is mandatory and the date must be greater than the current date

       3. AFTER A NO. OF DAYS

          1. Enter the value of days based on your business requirements. For example, add 7 days 
             The number field is mandatory and the specified value must be an integer and greater than 0.

11. Click on SUBMIT
    Action will be validated as provided in the section above and submitted if validations are passed

System Processing

Once the action is submitted the following changes will be carried out by the system:

When you select to Submit the action with the Scheduling Information set to NOW then both submitting and executing steps take place directly. When you submit the action as scheduled then only the submitting steps will take place and then once the scheduled action is executed the execution steps will take place.

• On submitting the subscription action:
  • The system validates that activation conditions, defined on the active billing term definitions are not violated. 
    • The activation conditions which are considered are those that include the Add Service Usage actions in the list of events
  • A UDR is created for each usage service that was submitted
  • UDR information is set based on the information specified for each usage service that was submitted.
    • The billing effective date is set equal to the date that the action is scheduled to be executed
    • The billing directive is set to To be billed unless a different billing directive is specified.
  • If the action is scheduled then the UDR is created as scheduled otherwise 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
  • The system validates that activation conditions, defined on the active billing term definitions are not violated. 
    • The activation conditions which are considered are those that include the Add Service Usage actions in the list of events
      
  • If the usage services should be rated immediately after execution, based on usage service billing rules defined on the active billing term, then:
    • The rating subscription usage services process is applied
  • If the action was scheduled then the UDR is updated to Posted