On this page
Subscription Actions Overview
Subscription actions are used to perform specific business processes on subscriptions, such as activating deactivating, resting, providing discounts etc.
Using Subscription Action Modal
All subscription actions that can be performed on a subscription are available in the Actions Panel located on the right hand side of the subscription's Data Entry page. Actions are categorised in 3 areas based on the object the changes are performed on.
The Action Panel is always filtered to display the allowed subscription actions, based on the life cycle state of the subscription and other scheduled subscription actions; this ensures that no action is scheduled or executed which could disrupt the scheduling and behaviour of presently scheduled actions.
To view the complete list of available actions, to schedule a new action to occur after the existing scheduled action is executed, use the "VIEW ALL ACTIONS" link.
To use an action:
- Click on the action you wish to perform, to open the subscription action modal and complete the action by providing the required information.
- The subscription action modal for all actions follows the same outline, separated in three semantic areas, described below. Action Selection Area is the area that differentiates most, based on the selected action.
Action Selection Area
Located on the left side of the modal. Any amendments allowed by the subscription action are available for selection in this area. If the subscription action has multiple 'Classifications' then the respective classification should be selected before any changes are performed.
Preview Area
Located at the top right of the modal, under Preview & Action Panel. It displays the changes to be performed on the subscription once the action is submitted. Different information is displayed according to the Subscription Action.
Subscription Action Detail Area
Located at the bottom right of the modal, under Preview & Action Panel, and displays information regarding the execution of the action.
- Performed By User the user that performed the Action. If left empty then the logged in user is set.
Through the calendar select the date and time to determine Performed Date of the action
If the action is related to the ACTIVATION of a service, then the Performed Date can be set to a date in the past and billing for the service(s) will start based on that date. The performed date which can be in the past must be after the date on which the service was added on the subscription in a 'Draft' state.Scheduling Information
Scheduling of an action is only available for specific actions- Find out what the upcoming bill of the subscriber will include if the action is submitted by using the 'Preview Rates' link. The process is available for both Normal and Prepaid Subscriptions. The link is only available for specific subscription actions.
- Click on Submit to execute or schedule the action.
All actions are subject to validations which take place before an action is initiated (prerequisite) or after it is submitted (postcondition).
Prerequisites define what is needed for an action to be available in the Action panel.
Below you can find all the actions available in CRM.COM.
Subscription Actions
Subscription related actions are used to make changes to the subscription as a whole, such as activate and deactivate, apply discounts, bill it and many more.
Action | Use the action to: | Preconditions | Postconditions and Processing | Can be scheduled | Preview available | Additional Information |
---|---|---|---|---|---|---|
Become Subscriber (Effective or Draft) | Register a new subscription from scratch. The action is triggered when NEW is clicked from the Action Menu of subscription Data Entry or Summary page. The subscription can be created in either a 'Draft' or an 'Effective' life cycle state. If the state is 'Draft' then the subscription is created but not activated, i.e. signals are not transmitted to the subscriber. | Services physical goods price plans and billing term schemes allowed to be added to the subscription are filtered based on the subscription type.
| Once you Submit the action, the system checks that the subscription account is active, and restriction and dependency rules defined for services, physical goods and subscriptions in the subscription type and billing definition are met. To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. 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. If conditions are met a new subscription is created and related to the account. services and installed items are added to the subscription with their distributions. The subscription and services life cycle state is set to 'Draft' or 'Effective' according to how you submit the action. A billing term that holds all the information related to the contact is created and set to 'Effective'. | If the subscription is activated it is Instantly billed if billing term scheme requires prepayment. | ||
Activate Subscription | Activate all 'Draft' and 'Not Effective' services of a subscription.
| Action is available only if subscription has a 'Draft' or 'Not Effective' life cycle state The action cannot be used, if some of the services are 'Draft' or 'Not Effective'. 'Start Service' action must be used.
| Once you Submit the action the system checks that the subscription account is active, and restriction and dependency rules defined for services, physical goods and subscriptions in the subscription type and billing definition are met, while services must belong in the billing term scheme of the subscription. To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. 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. If conditions are met subscription and subscription services life cycle state arw set to 'Effective'. The following will be set on the Subscription Services according to business rules:
| Instantly billed if billing term scheme requires prepayment. Performed Date can be set on a date in the past and the billing of the Service(s) will start based on the Performed date. Even though Performed date can be set on a date in the past, it must be after the Service was added on the Subscription as 'Draft' | ||
Bill Subscriber | Bill a normal subscription or preview the dates on which a prepaid subscription is estimated to be disconnected, based on the available amount of money present in the subscriber's wallet.
| Action is available only if subscription is in one of the following life cycle states:
| Once you Submit the action, the system checks that the subscription account is active. and that the specified date is equal to or further than the date that the subscription is already billed. i.e the latest Rated To Date. If validations are passed then
| 'Bill as of Date' cannot be set for prepaid subscriptions. Normal subscription's bills can be settled directly by using the QUICK PAY action once the bill is created. | ||
Deactivate Subscription | Disconnect all effective subscription services. | Action is available only if subscription is in 'Effective' life cycle state.
| Once you Submit the action the system checks that the subscription account is active. If validations are passed then the Subscription and services life cycle state is set to 'Not Effective'. Billable period start dates and billing effective dates are set based on the billing term scheme. Binding end and allowed cancel date extensions are applied based on the billing term scheme. Billing directive is set based on the additional Billing directions, specified on the billing definitions. | |||
Extend Grace Period | Accord a number of days to a subscriber who might be behind in payments before disconnecting them or to reactivate their subscription if it has already been disconnected. | Action is available if the subscription is in one of the following life cycle states:
| Once you Submit the action, the system checks that the subscription account is active and Grace rules set in the billing definition are met To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. If validations are passed: If the subscription is 'Not Effective' then it is activated by applying the following steps:
The subscription is updated with extend grace period information (such as grace period start and end dates). Grace period history records are created for the subscription. Binding end and allowed cancel date extensions are applied based on the billing term scheme | |||
Terminate Subscription / Cancel | Cancel a subscriber's subscription and all of its services. | Action is available if the subscription is in one of the following life cycle states:
| Once you Submit the action, the system checks that the subscription account is active and 'Cancellation inside and outside binding' rules set in the billing definition are met. If validations are passed subscription services and distributions are removed. and the subscription life cycle state is set to 'cancelled'. Cancellation penalties are applied as specified on the 'active' billing term definitions. Any actions scheduled after the cancellation are deleted.
| If the subscription has any actions scheduled after the cancellation, they are deleted. | ||
Terminate Subscription / Regret | Regret is used when a subscriber changes his mind and no longer wants to be subscribed, within a given time from his first activation. | Action is available if the subscription is in one of the following life cycle states:
| Once you Submit the action, the system checks that the subscription account is active and 'Regret period' rules set in the billing definition are met. If validations are passed subscription services and distributions are removed. and the subscription life cycle state is set to'regretted'. Any actions scheduled after the regret are deleted.
| If the subscription has any actions scheduled after the regret, they are deleted. | ||
Short Term Subscription Activation | Temporarily activate a subscription and its services before proper activation, without charging the subscriber for the activated period. Subscriptions in Short Term Activation can be deactivated automatically when the Short Term Activation end date is reached or through the Subscription Action End Short Term Subscription Activation. | Action is available if the subscription is in one of the following life cycle states:
| Once you Submit the action, the system checks that the subscription account is active. If the action is scheduled by using a value for the specific date or specific number of days, the Short Term Activation End Date must be greater than scheduled date. The short term activation rules specified on the billing definitions, should be met To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. 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. If validations are passed the life cycle state of all subscription and all its services which are in a 'draft' or 'not effective' is set to 'short term effective'. Bill effective date, billable start period and billing directives are set according to the business rules.
| Instantly billed if billing term scheme requires prepayment. Before submitting you must select when the short term activation should end:
| ||
End Short Term Subscription Activation | Deactivate subscriptions that were activated using Short Term Subscription Activation action and which the subscriber wishes to deactivate earlier than planned. | Action is available if the subscription is in a 'Short Term Effective' life cycle state.
| Once you Submit the action, the system checks that the subscription account is active. If validations are passed the subscription and services life cycle state is set to 'not effective'.Bill effective date, billable start period, and billing directives are set according to business rules. The short term activation life cycle state period is updated by setting the end short term activation action as that which ended the period. | |||
Short Term Subscription Deactivation | Temporarily deactivate a subscription for a short period and automatically reactivate. | Action is available only if the subscription is in a 'Effective' life cycle state.
| Once you Submit the action, the system checks that the subscription account is active and that the short term deactivation rules defined in the billing definition are met. If validations are passed the life cycle state of the subscription and its services which are in a 'draft' or 'effective' life cycle state are set to 'short term not effective'. The subscription service life cycle state, bill effective date, billable start period and billing directives are set according to the business rules. | Before submitting you must select when the short term deactivation should end:
| ||
End Short Term Subscription Deactivation | Activate subscriptions that were deactivated using Short Term Subscription Deactivation action and which the subscriber wishes to activate earlier than planned. | Action is available only if the subscription is in a 'Short Term Not Effective' life cycle state.
| Once you Submit the action, the system checks that the subscription account is active. To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. If validations are passed the subscription and subscription services life cycle state is set to 'effective' or 'not effective' according to the credit limit status of the customer. The short term deactivation life cycle state period is updated by setting the end short term deactivation action as that which ended the period. Billable period start dates and billing effective dates are set based on the billing term scheme. Binding end and allowed cancel date extensions are applied based on the billing term scheme. | Instantly billed if billing term scheme requires prepayment. | ||
Rest Subscription | Place a subscription 'In Resting'; this means that the subscription is deactivated and will be excluded from billing for a specific period of time.Particularly useful when subscribers will be away for an x amount of time and they would like to pause their subscription. | Action is available only if the subscription is in one of the following life cycle states:
| Once you Submit the action, the system checks that the subscription account is active and that the resting rules defined in the billing definition are met. If validations are passed then life cycle state of the subscription and its services is set to 'in resting'. Billable period start dates and billing effective dates are set based on billing term scheme. Billing directive is set based on the additional billing directions specified on the billing definition. | You can setup rules in the billing term scheme to extend the contact dates by the number of days the subscription is resting. Before submitting you must select when the resting should end:
| ||
End Subscription Resting | Force a subscription out of a resting earlier than initially scheduled. | Action is available if the subscription is in an 'In Resting' life cycle state.
| Once you Submit the action, the system checks that the subscription account is active. To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. If validations are passed then if the subscription and the services were 'effective' prior to resting, the system validates whether the subscription can become 'effective'. If it cannot, then the subscription and its services will be set to 'not effective', based on the activation conditions set in the 'active' billing definition. Billable period start dates and billing effective dates are set based on the billing term scheme. Binding end and allowed cancel date extensions are applied based on billing term scheme.
| Instantly billed if billing term scheme requires prepayment. Subscription that come out of resting will either be activated or dactivated depending on the activation conditions. For example, if the amount of debt of the customer exceeds that allowed by the business threshold then the subscription is set as Not Effective. | ||
Change Subscriber Account / Change Subscriber | Use to transfer the subscription from one account owner to another. You can use an existing account or create a new one .
| Action is available if the Subscription is in one of the following life cycle states:
| Once you Submit the action the system checks the following:
To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. If validations are passed a new accounts receivable is created (if new is specified). A new contact information is created (if new is specified). The accounts receivable related with the subscription is replaced with the new one. A new billing address is created or the current one is updated. A new subscription location is created or the current one updated. | |||
Change Subscriber Account / Same Subscriber | Use the to change the subscription's account, to another one belonging to the same subscriber (i.e., to change the account that will be billed for the Subscription). | Action is available if the Subscription is in one of the following life cycle states:
| To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. If validations are passed a new accounts receivable is created (if new is specified). A new contact information is created (if new is specified). The accounts receivable related with the subscription is replaced with the new one. A new billing address is created or the current one is updated. A new subscription location is created or the current one updated. | |||
Amend Billing Terms / Adjust Binding Period | Use when the contract needs to be re-adjusted to either start sometime in the future or moved to the past. The action resets both the Binding Start and End date of the contract. | Action is available if the subscription is in one of the following life cycle states:
Action is not allowed if another scheduled 'Amend Billing Terms' action exists. You are allowed to schedule the action only after the execution of the scheduled action.
| Once you Submit the action the system checks that billing term amendment rules defined in the billing term scheme are met. If validations are passed the binding start and binding end dates are adjusted by a common period of time.
| Adjust By: You can adjust using either positive or negative number (to the future or the past). | ||
Amend Billing Terms / Cancel Binding Period | Use to cancel any current customer contracts. Subscriptions may be created with or without a contract. When the Subscription is without a contract the subscriber is not bound by any agreement. | Action is available if the subscription is in one of the following life cycle states:
Action is not allowed if another scheduled 'Amend Billing Terms' action exists. You are allowed to schedule the action only after the execution of the scheduled action.
| Once you Submit the action, the system checks that billing term amendment rules defined in the billing term scheme are met. If validations are passed a new billing term (the customer's contract) instance with no binding terms, which replicates the previous one is created and activated. The existing billing term is replaced and set it to 'inactive'.
| Agreement Date: The date on which the subscriber cancelled their contract. | ||
Amend Billing Terms / Extend Binding Period | Use to to extend a customer's current contract when it is about to expire.The contract is extended by updating the Binding End date of the customer, for a period of time defined by the user. | Action is available if the subscription is in one of the following life cycle states:
Action is not allowed if another scheduled 'Amend Billing Terms' action exists. You are allowed to schedule the action only after the execution of the scheduled action.
| Once you Submit the action, the system checks that billing term amendment rules defined in the billing term scheme are met. If validations are passed a new billing term instance which replicates the previous one is created and activated. The binding end date is extended by a number of days while the binding start date remains the same. Existing billing term is replaced and set to 'inactive.'
|
| ||
Amend Billing Terms / New Binding Period | Use to change the contracted period. With this action, both the Binding Start and Binding End date are renewed. | Action is available if the subscription is in one of the following life cycle states:
Action is not allowed if another scheduled 'Amend Billing Terms' action exists. You are allowed to schedule the action only after the execution of the scheduled action.
| Once you Submit the action the system checks that billing term amendment rules defined in the billing term scheme are met. If validations are passed a new billing term instance which replicates the previous one and has identical binding terms is created and activated. The existing billing term is replaced and set to 'inactive'.
| The available Binding Periods are the ones defined in the Billing Term Scheme. | ||
Amend Billing Terms / Renew Binding Period | Use to renew an expired contract by setting the Binding End Date to the new date on which the contract should expire | Action is available if the subscription is in one of the following life cycle states:
Action is not allowed if another scheduled 'Amend Billing Terms' action exists. You are allowed to schedule the action only after the execution of the scheduled action.
| Once you Submit the action the system checks that billing term amendment rules defined in the billing term scheme are met. If validations are passed a new billing term instance which replicates the previous one and has identical binding terms is created and activated. The binding start date is set to the date of execution and the binding end date is set equal to the binding start date plus the binding period. The existing billing term is replaced and set to 'inactive
| Agreement Date: Regardless of the Agreement Date, the Binding Start will be set to the date of the execution. The Agreement Date only defines the date on which the contract was signed. | ||
Amend Billing Terms / New Billing Terms | Use to replace the subscriber's current contract with a new one or in order to change basic attributes of the current contract such as:
| Action is available if the subscription is in one of the following life cycle states:
Action is not allowed if another scheduled 'Amend Billing Terms' action exists. You are allowed to schedule the action only after the execution of the scheduled action.
| Once you Submit the action the system checks that billing term amendment rules defined in the billing term scheme are met. If validations are passed a new billing term instance which replicates the previous one and has identical binding terms is created and activated. The existing billing term is replaced and set to 'inactive'. On switching from prepaid post-rated to prepaid pre-rated billing term scheme the system checks that there are enough funds in the wallet to cover the service which is charged by the next scheduled prepaid billing run. On switching from prepaid pre-rated to prepaid post-rated billing term scheme no billing actions are applied. The services that changed from pre-rated to post-rated will be credited for the period that was billed in advance and will be billed again through the next scheduled prepaid billing run. The period to be credited will start from the date after the action was executed up to the date that the service was billed in advance. | Instantly billed if the subscription changes to a normal billing term scheme that requires prepayment. The following fields are only visible and available for selection if certain conditions are met:
| ||
Change Subscription Address | Use to change the subscription address, which indicates the physical address where the services are received. The action can be used to:
| Action is available if the Subscription is in one of the following life cycle states:
| The subscription address is updated. | |||
Provide Ad Hoc Discount | Use to select and apply one of the pre-configured discounts to the subscription. For more information view Additive Discounts | |||||
Submit Buy in Advance Request | Use to provide subscribers with the possibility to be billed for a period longer than that of their normally contracted billing frequency or prepaid/pre-rated period, in exchange for a discount. Billing Frequency applies to Subscriptions with Normal Billing Term Schemes and Prepaid / Pre-rated period applies for Subscriptions with Prepaid Billing Term Schemes. For more information view Buy in Advance | Buy in advance definition must be configured. No other 'Effective' or not billed Buy in Advance request exists for the specific Subscription. If the subscription has a Prepaid Billing Term Scheme, at least one pre-rate subscription service must exist.
| Once you Submit the action the system checks that the specified duration is within one of the settings defined in the Buy in Advance Definitions. For normal subscriptions the specified duration is more than the existing billing frequency of the Subscription and for prepaid subscriptions the specified duration is more than the existing pre-rated period of at least one of the Subscription services. If the request is submitted If the request is for a specific subset of prepaid pre-sated subscription services in which case the specified duration must be more than the maximum pre-rated period among all of the selected services bought in advance. | A Buy in Advance Request can also be submitted for a specific subset of Prepaid Pre-Rated Services of a Subscription.
| ||
Change Subscription Distribution | Use to assign or switch subscription services and installed items to a different provisioning distributor or if the existing distribution must be cancelled. When you use the action on a service you can
When you use the action on an installed item
| Action is available if the Subscription is in one of the following life cycle states:
| Once you Submit the action the system will check that restrictions and dependencies on services and installed items set on the billing definition are met. To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. If validations are passed then related provisioning distributors are added if not already there. The initial distribution of the specified installed item or service is removed if an installed item's distribution change was specified. The installed item and/or service are distributed to the new distributors, as long as they are specified. The new subscription provisioning distribution record is marked as 'not initialised'. The new subscription provisioning distribution record is marked as 'not authorised. | Instantly billed if billing term scheme requires prepayment. This is a legacy subscription action, which means that to display it in the action panel, the compatibility settings found at Platform > Manage Admin Settings > Set up Compatibility Settings should be enabled; if not the 'Amend Services and Installed Items' subscription action can be used instead. Use Enable and Disable Links to add or remove services and Installed Items from and to Provisioning Distributors.
| ||
Manage provisioning distributors label | Use to provide alias names to provisioning distributors used by the subscription. For example, if a subscriber labels Twin 1 distributor as Master Bedroom and has the Gold service and a Roku box distributed to the Twin 1 then the following is displayed wherever the distributor is shown:
| |||||
Amend Services and Installed Items | Use to amend a subscription by adding or removing termed services and /or installed items or amending distribution of either of the 2. | Allowed only if subscription life cycle state is not or will not be equal to draft or cancelled This action is applicable only if the subscription type is classified as "Flexible selection of services"
| Once you Submit the action the system checks that subscription type, billing definition and provisioning provider rules, restrictions and dependencies are not violated To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. If validations are passed and according to what you use the action for the system executes the same things as in the following actions
| Scheduling is allowed only if the subscription's life cycle state is not 'draft' or scheduled to be cancelled during that period of time. If the action is used to add new installed items then it cannot be scheduled.
| Instantly billed if billing term scheme requires prepayment. |
Subscription Service Actions
Subscription service related actions are used to amend services of the subscription.
Action | Use the action to | Preconditions | Postconditions and Processing | Can be scheduled | Preview available | Additional Information |
---|---|---|---|---|---|---|
Add Services Draft | Use to add termed services (services charged on a recurring basis) whose activation must be done at a later stage. services that should be activated directly (i.e., those ready to be billed) should be added as 'Effective', using the Add Service as Effective action. You can also use the action to add Installed Items. | Action is available if the subscription is in one of the following life cycle states:
Only services, distributors and physical goods allowed by the subscription type and billing term scheme are available for selection.
| Once you Submit the action if any of the following actions is also scheduled for the subscription then the new service cannot be added before the scheduled date:
If validations are passed then draft services and distributors are added to the subscription and billing dates are set according to the rules. If installed items are added then they are added along with their distributors to the subscription, removed from the warehouse using a stock out warehouse transaction and the installed item history is updated. | This is a legacy subscription action, which means that to display it in the action panel, the compatibility settings found at Platform > Manage Admin Settings > Set up Compatibility Settings should be enabled; if not the 'Amend Services and Installed Items' subscription action can be used instead. | ||
Add Services / Effective | Use to add termed services (services charged on a recurring basis) that should be immediately activated. If their activation is scheduled for a later stage then subscription services should be added as 'Draft' using the 'Add Draft services' action. The actions can also be used for adding installed items. | Action is available if the subscription is in an 'Effective' life cycle state. Only services, distributors and physical goods allowed by the subscription type and billing term scheme are available for selection.
| Once you Submit the action the system checks that subscription type and billing definition rules are met. To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. 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. If any of the following actions is also scheduled for the subscription then the new service cannot be added before the scheduled date:
Service and installed items dependencies and restrictions defined on the subscription type are observed. If validations are passed then effective services and distributors are added to the subscription and billing dates are set according to the rules. If installed items are added then they are added along with their distributors to the subscription, removed from the warehouse using a stock out warehouse transaction and the installed item history is updated
| Instantly billed if billing term scheme requires prepayment. This is a legacy subscription action, which means that to display it in the action panel, the compatibility settings found at Platform > Manage Admin Settings > Set up Compatibility Settings should be enabled; if not the 'Amend Services and Installed Items' subscription action can be used instead. The Performed Date can be set in the past (it must be after the service was added on the subscription as 'Draft') and the billing of the service(s) will start on that date. | ||
Add Expense | Use to add a one-off charge to the subscription. | The subscription is in one of the following life cycle states:
Only expenses allowed by the subscription type and billing term scheme are available for selection. | 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.
If validations are passed then the expense is added on the subscription and set as 'Effective' Its bill effective date, billable start period and billing directive are set according to the business rules. |
| Instantly billed if billing term scheme requires prepayment. The same expense can be added as many times as necessary. Expenses can also be automatically added to a subscription through the execution or scheduling of another subscription action, provided pre-defined conditions are met. For more information, refer to the POLICIES section in billing definitions. | |
Add Service Usage | Use this action to add usage services (services charged based on their usage, such as movies, telephone logs or games) ordered by a subscriber. The available usage services are defined in the 'Usage Service Catalogs' unlike the rest of the services that are defined as products.. | The action is available if the subscription is in an 'Effective' life cycle state A termed service may have to be selected as a prerequisite (depending on the configuration of the 'termed service requirements' in the usage service catalog), with a life cycle state not
Usage Service Catalogs are filtered on the following conditions:
If a catalog is specified, then the available usage services are filtered based on the services included in that catalog. If a catalog is not specified, then the available usage services are filtered based on the services included in all the available catalogs (considering the usage service catalog filtering logic described above) | Once you Submit the action the system checks that the subscription is owned by an active account. To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. Once the action is executed, provisioning signals are sent to the subscriber's device to enable the ordered item, and a 'UDR' is created in the system and billed immediately or in the next Billing Run. For prepaid subscriptions usage service orders are always billed instantly and if there are no funds available in the subscriber's wallet , then the service cannot be added. For normal subscriptions usage service orders are billed according to the configuration of 'Usage Service Billing Rules' set in the billing term scheme.
| Instantly billed if billing term scheme requires prepayment. 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 with the information defined in the action. If the action is scheduled the UDR is created as scheduled. Otherwise the UDR is created as 'Posted'.
On executing the Subscription Action:
| ||
Start Service | Use this action to activate termed services that are in a 'Draft' or 'Not Effective' state. | Action is available if the subscription is in one of the following life cycle states:
The subscription services are in one of the following life cycle states:
The subscription services that will become 'Effective' must be allowed by the subscription type, billing term scheme and provisioning distributor. | Once you Submit the action the system checks that the subscription is owned by an active account.
Service and installed items dependencies and restrictions defined on the subscription type are observed. 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. To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. If validations are passed then the service is set as effective.
.
|
| Instantly billed if billing term scheme requires prepayment. The Performed Date can be set in the past (it must be after the service was added on the subscription as 'Draft') and the billing of the service(s) will start o Subscription life cycle state is set to 'Effective' if is in a 'Draft' or 'Not Effective' state and the life cycle state of the subscription services is set to 'Effective'. Billable period start date, billing effective date, binding end and allowed cancel date extensions are set based on the billing term scheme. Billing directive is set based on the billing directives specified in the 'Active' billing definition n that date. | |
Stop Services | Use this action to deactivate selected or all of the subscription's termed services. The effect of the action is identical to Deactivate Subscription, but in this case, it is applied to individual services. | Action is available only if the subscription service is in an 'Effective' life cycle state.
| Once you Submit the action the system checks that the subscription is owned by an active account. Service and installed items dependencies and restrictions defined in the subscription type are observed. If the validations are passed the subscription life cycle state is set to 'Not Effective' if no other 'Effective' services exist and the service life cycle state to 'Not Effective' Binding end and allowed cancel date extensions are applied based on the billing term scheme. Billing directive is set based on the billing directives specified in the 'Active' billing definition. | The action can be applied to all or to a selection of subscription services. | ||
Swap Services | Use to change an existing subscription termed service to a different one. There are three available swapping classifications:
The system distinguishes between swap classification on submitting the action without the need of user assistance. If a Classification is selected by the agent, then available services will be filtered based on it. | The action is available if subscription service is in one of the following life cycle states
The available services to swap are the ones allowed by the subscription type, billing term scheme and provisioning distributor. The available services to swap to follow the Tier rules specified in the subscription type
| Once you Submit the action the system checks that the subscription is owned by an active accounts receivable. Service and installed item dependencies and restrictions defined in the subscription definition type are observed as well as the service swap rules defined in the billing definition 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.
To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. If validations are passed then the new subscription services are added together with the related provisioning distributors, if not already there. The removed subscription services are removed together with their distribution. The life cycle state of the added service is set equal to the life cycle state of the removed one. The life cycle state of the removed service is set to 'Swapped', and the initial life cycle state Period is 'Closed'. Billable start period and billing effective date are set based on the billing term scheme. Billing directive is set based on the active billing definition. | Instantly billed if billing term scheme requires prepayment. If there are multiple lever of tiers in the subscription definitions, then when selecting a mandatory service belonging to a leading tier to switch to, optional subscription services (if any) following the same tier will be displayed. | ||
Amend Bundle Services | Use this action to change the services (i.e. channels) included in a Flexible Product Bundle Termed Service. Services can be added to or removed from the bundle, based on the Bundle Components and Bundle Restrictions that are set up on creating the Product. | Action is available if the subscription is in one of the following life cycle states:
and only for subscriptions that already have at least one service of type Flexible Bundle. | Once you Submit the action the system checks that bundle service composition rules defined at the Product are met. To allow service activation in normal subscriptions the credit limit of the account should not be exceeded, unless otherwise defined in the 'override credit limit rules' of the billing definition. 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. If validations are passed then subscription service components are either added or removed along with their related provisioning distributions. For removed subscription service components the subscription service life cycle state is set to 'Removed' while for added it is set equal to the life cycle state of the bundled service. | Instantly billed if billing term scheme requires prepayment. Use MODIFY to open the modal and select components. Use VIEW PRODUCT BUNDLE COMPOSITION link to see the allowed composition structure. Use product, product type and product family filters to filter the available service components. Use SELECT to add a new component to the bundle. Use REMOVE to remove an existing or a newly added component to the bundle. | ||
Cancel Expense | Use this action to remove Expenses ( Add Expense ) added to the subscription. The action cannot be used after the expense has been billed, but it can be used after it has been rated. | Action is available if the subscription is in one of the following life cycle states:
The expense is not already billed. The expense has not already been cancelled. | The expense life cycle state is set to 'Cancelled'. If the expense is rated (but not billed), related rated billing items are cancelled. | |||
Remove Services / Cancel | Use this action when a termed service is no longer required by the subscriber and they wish to cancel it. The time by which a service can be cancelled and whether penalties are applied, depends to your business rules. The Cancel Service action is a child of the Cancel Subscription action where the former cancels specific services while the latter cancels all services. Refer to billing definition for more information on validations and penalties that can be applied on the Cancel Service and Cancel Subscription Actions. | Action is available if the subscription service is in one of the following life cycle states:
| Once you Submit the action the system checks that the subscription is owned by an active account. Service and installed item dependencies and restrictions defined in the subscription type must be met. Cancellation outside or during binding rules, defined in the 'Active' billing definition are observed. If validations are passed services and provisioning distributors that are no longer distributing any subscription services or installed items are removed. Service life cycle state is set to 'Cancelled' and subscription life cycle state is set to 'Not Effective' if no other services exist. Cancellation penalties are applied as specified on the billing definition. Any actions scheduled for after the cancellation are deleted. |
| The Action can be applied to all or to a selection of subscription services. | |
Remove Services / Regret | Use this action to remove a termed service, soon after it was added due to customer regretting. The action can also be used to regret a Service swap. i.e., use it if a subscriber recently changed their service from P1 to P2 and would like to return to P1. Regret Service action is a child of the Regret Subscription action where the former regrets specific services while the latter regrets all the services of the subscription. | Action is available if the subscription service is in one of the following life cycle states:
| Once you Submit the action the system checks that the subscription is owned by an active account, and the service dependencies and restrictions defined in the subscription type must be met. Regret rules defined in the billing definition must also be met. If validations are passed then services and provisioning distributors that are no longer distributing any subscription services or installed items are removed. Service life cycle state is set to 'Regretted' and subscription life cycle state is set to 'Not Effective' if no other services exist If the subscription services to be regretted were added by the swap subscription service process, then the previous subscription service is restored with its former (pre-swap) attributes. Billable period start date and billing effective date are updated based on the billing term scheme. Any actions scheduled for after the cancellation are deleted. | |||
Remove Services / Undo Add Service | Use this action to remove 'Draft' termed services that have mistakenly been added to a subscription. | Action is available if the subscription is in one of the following states:
and subscription services are in a 'Draft' life cycle state. | When the action is execute services and provisioning distributors that are no longer distributing any subscription services or installed items are removed. Subscription service life cycle state is set to 'Removed'. Any actions scheduled for after the cancellation are deleted. | The action can be applied to all or to a selection of subscription services. |
Subscription Installed Items Actions
Subscription related actions are used to amend installed items of the subscription.
Action | Use the action to | Preconditions | Postconditions and Processing | Can be scheduled | Preview available | Additional Information |
---|---|---|---|---|---|---|
Add Installed Item | Use to add traceable physical goods to a subscription such as decoders smartcards, modems, or telephones, which may be required for its operation. | The action is available if the subscription has one of the following life cycle states:
Physical goods that can be selected must be allowed by the subscription type and the provisioning provider of the selected distributor. The installed items available to be added are as defined in the active inventory management definition. You cannot add a new item, if there is a 'New Subscription Job' related to this subscription which is not 'Cancelled' or 'Completed'.
| Once you Submit the action, if the subscription is effective then the system checks the installed item restrictions and dependencies defined on the billing definition. If validations are passed then the installed items are distributed to their related distributors, removed from the warehouse using a stock out warehouse transaction and the installed item history is updated. | This is a legacy subscription action, which means that to display it in the action panel, the compatibility settings found at Platform > Manage Admin Settings > Set up Compatibility Settings should be enabled; if not the 'Amend Services and Installed Items' subscription action can be used instead. For more information on adding Installed Items using the action follow the links below: | ||
Remove Installed Item | Use to remove an installed item from a subscription in case the subscription is cancelled or regretted, or the item is no longer necessary. | Action is available if the subscription is in one of the following life cycle states:
| Once you Submit the action the system checks that the subscription is owned by an active account and that a valid warehouse to store the removed item exists, as defined in the active inventory management definition exists. If the subscription is effective then the system checks the installed item and service restrictions and dependencies defined on the subscription type and subscription restrictions defined on the billing definition. If validations are passed then if the installed item was rented then it's added back to a warehouse as specified in the active inventory management definition using a 'stock in' warehouse transaction and installed items history is updated. If the item was sold it will be removed from the subscription and remain in the account as an asset, | This is a legacy subscription action, which means that to display it in the action panel, the compatibility settings found at Platform > Manage Admin Settings > Set up Compatibility Settings should be enabled; if not the 'Amend Services and Installed Items' subscription action can be used instead. If the subscription is still in a 'Draft' life cycle state, the system will execute the Undo Add Installed Item subscription action. If the subscription is in any life cycle state other than 'Draft', then the system will execute the Remove Installed Item subscription action. | ||
Swap Installed Item | Use to replace an existing installed item. For example, the existing item may need to be replaced because it is broken or exchanged for a new or different model. | Action is available if the subscription is in one of the following life cycle states:
The installed items available to be added are as defined in the active inventory management definition.
| Once you Submit the action the system checks that the subscription is owned by an active account and that a valid warehouse to store the removed item exists, as defined in the active inventory management definition exists. If the subscription is effective then the system checks the installed item and service restrictions and dependencies defined on the subscription type and subscription restrictions defined on the billing definition. If validations are passed then new installed items are distributed accordingly, and removed from the warehouse using a 'stock out' warehouse transaction and installed items history is updated. | When swapping an installed item related to a fixed product bundle you have 2 options:
| ||
Move Installed Items between Subscriptions | Use to move installed items between subscriptions of the same account owner. | The action is available if the source subscription has one of the following life cycle states:
Installed items exist on the subscription. There are more than one subscriptions related to the account.
| Once you Submit the action the system checks that both source and target subscriptions belong to the same account owner. If either the source or target subscription is 'Effective' then restrictions and dependencies set on the subscription type must be met. The installed items and distributors must be allowed by the target's subscription type.. If validations are passed then the installed item is removed from the source subscription and added to the target subscription and distributed accordingly. The installed item history is updated by specifying the source subscription and the subscription to which the installed item is moved. |
Working with Scheduled Subscription Actions
Viewing scheduled subscription actions
Scheduled Subscription Actions (including cancelled ones) can be viewed from the following screens:
- Subscription Data Entry page
- VIEW HISTORY LINK
- SUBSCRIPTION ACTIONS HISTORY > SCHEDULED ACTIONS
- VIEW HISTORY LINK
- Subscription Summary page
- Subscription Information Drill-down
- Scheduled Actions
- Subscription Information Drill-down
- Communication Centre > Subscription Section
- VIEW HISTORY LINK
- SUBSCRIPTION ACTIONS HISTORY > SCHEDULED ACTIONS
- VIEW HISTORY LINK
Executing scheduled subscription actions
Subscription actions which are scheduled for the future, are executed by the Maintenance Utility process. The process must be configured and enabled once and from then on any scheduled subscription actions whose execution date is before or equal to the current date (of execution) are executed.
Billing > Subscriptions > Subscriptions Maintenance Utility
The process is configured once and according to the Frequency settings it is executed on a recurring basis. All you need to do is navigate to the utility, set Frequency settings, ENABLE and SAVE it so that the system will start executing scheduled actions. Once executed, a Process Run is logged available through the View Process Runs. The log can include only subscription actions that failed to execute or both successful and unsuccessful according to the Logging Method selected.
Rejecting and cancelling scheduled subscription actions
Scheduled subscription actions may be rejected during their execution due to not meeting validations based on configuration, i.e. business rules and restrictions which were met at the time of scheduling and not anymore, or due to the fact that the action's affected services, installed items or distribution are no longer available on the subscription. When actions are rejected, they are logged along with the reason that they were rejected.
Scheduled subscription actions can be cancelled manually by users, from the same pages from
- Subscription Data Entry page > View Subscription History
- Communication Centre > Subscription Tab > View Subscription History
To cancel an action
- Open the Subscription History Modal.
- Click on the Subscriptions Actions History Section.
- Select the Scheduled Tab.
- Find the Scheduled Action you would like to cancel.
- Click on the CANCEL LINK to open a modal prompting for an optional cancellation reason.
- Click on SAVE
Any changes done on the subscription from the scheduled action prior to its cancellation or rejection, are reverted. In general the following ares that may have been affected by the action before it was scheduled will now be handled:
- The binding period end date of the subscription's billing terms is rolled-back to the previous one
- The subscription's life cycle state history is updated
- Each affected subscription service's life cycle state history is updated
- If the action marked a service as to be added or added due to swap then the service is removed from the subscription
- If at least one service is already billed, billing is reverted (related Rated Billing Items are cancelled)
- If more scheduled subscription actions were submitted after the action which is being rejected then the actions remain as scheduled and the affected services are adjusted according to the rejected action's affected services
Amending scheduled subscription Actions
Scheduled Subscription Actions can be amended if they have not been cancelled or executed. Only Subscription Action Details and the Scheduling Information can be modified while amending a Scheduled Action.
Existing Scheduled Actions can be amended from the same pages from which they are viewed.
- Subscription Data Entry page > View Subscription History
- Communication Centre > Subscription Tab > View Subscription History
- Open the Subscription History Modal.
- Click on Subscriptions Actions History Section.
- Select Scheduled Tab.
- Find the Scheduled Action you would like to cancel.
- Click on the AMEND LINK to open a modal prompting for an optional amendment reason.
- New Scheduled Date: Click on the calendar to set the new Date for the Action.
- New Performed Date: Click on the calendar to set the date that you would like to have the Action logged as performed.
- New Performed By User: Search and add the user you would like to have the Action logged from.
- Click on SAVE
- The Action is updated with the new information.
- The System updates the Scheduled Subscription Action by:
- Cancelling the existing Scheduled Subscription Action.
- Creating a new scheduled Subscription Action with the updated information.
Billing scheduled subscription actions
Scheduled Subscription Actions are taken into consideration by Billing as long as their life cycle state is set to 'Scheduled', and falls within the period for which the Subscription is being billed.
In case Rated Billing Items are already present in the System and the Scheduled Action is cancelled or rejected, then associated Rated Billing Items are taken into consideration by the Billing Run, billing over the related period.
Provisioning of scheduled subscription actions
Unlike other processes which occur during the Scheduling of the Action, Provisioning takes place during its execution.
Subscription Actions Example
Scenario
Company ZX has two ways for creating new subscriptions.
- Through retailer shops, from where customers receive all the required equipment and are able to start using their subscription directly.
- Through an order placed by calling the Call Centre. In this case, an installation order is placed, and when the installers are at the customer's residence they activate the subscription via their company phones.
Solution
Retailer Shop Subscriptions
When subscriptions are made at a retailer shop, the "Become Subscriber" action is used triggered when NEW is selected from the subscription Summary page. All of the new customer's details are entered, and the requested services and hardware equipment are registered at once in the system.
Once the subscription action is submitted using the Submit button, the subscription becomes 'Effective' and as soon as the customers connect the equipment, the channels are available on their TV.
Call Centre Subscriptions
When Subscriptions are registered at the Call Centre the "Become Subscriber" action is used triggered when NEW is selected from the subscription Summary page. All of the new customer's details are entered, and the requested services are registered at once in the system.
The Subscription action is submitted as 'Draft' using the Submit as Draft button. The subscription and subscription services remain in the system as 'Draft'.
Once at the customer's residence, the installer enters in the system the Serial Numbers of the installed items that were added by subscription action Add Installed Item and then activates the Subscription using the Activate Subscription aaction.
The installer can do this by sending predefined messages integrated with CRM.COM via WEB APIs.