Overview
Cumulus staff users and end users (via the end user portal) can manage their subscriptions to bolt-ons and bolt-on add-ons. In the case of automated service types, requests to alter a subscription are sent directly to the carrier's provisioning platform via integration between the carrier's platform and the Emersion system.
A variety of use cases will see the carrier's platform return a negative result, meaning the provisioning request cannot be fulfilled.
This article covers how to use the Provisioning Errors page in Cumulus to address these issues.
Permissions
The Provision Errors page will require a Power to be enable
Base Power > Subscription Management > Managing Halted Subscriptions
Viewing Provisioning Errors
If a provisioning request against a subscription is halted due to a provisioning error, the system will store the underlying failure reason against the subscription.
To access a list of halted subscriptions and the reasons, go to:
Services > Provisioning Errors
This list contains all subscriptions that have been unable to be processed properly by the service supplier's platform.
- Service Subscriptions
- Service Bolt-On Subscriptions
- Service Bolt-On Add-On Subscriptions
- Service Feature Subscriptions (Service Feature Subscriptions currently will not show a failure reason in the list. The Service Subscription > Provisioning Logs tab can be used to view the provisioning log output instead.)
Subscriptions on this page will only be shown if they are in either PreActive or PendingProvCancel status.
For WME services specifically, these typically halt due to things like missing DOB or Account Number (or it's been entered wrong) - especially for Port In scenarios. We suggest consulting the the service subscription page as additional information may be required prior to retrying.
Operations Permitted
Against each halted subscription, there is a selection check box. User can select one or more halted subscriptions to perform a certain action against them. User has the "Check All" checkbox also available that can select all the items in the list.
The operations that are permitted against the selected halted subscriptions include the following:
- "Retry Selected" will mark the selected subscription object(s) ready for re-provisioning.
- "Abort Selected" will mark the selected subscription object(s) as Aborted. However, subscriptions which are in "Pending Prov Cancel" status, cannot be aborted.
Retrying and Aborting Halted Subscriptions
- Navigate to Services > Provisioning Errors
- Using the filters supplied, search for your chosen subscription and click Search
- Check the box beside each row you wish to act on, or alternatively check the top-most box to automatically check all within the current paginated view
- Depending on your desired outcome, either click the Retry Selected or the Abort Selected button
- A confirmation box will always be displayed to allow you to confirm your action by clicking Yes or to cancel the action click No
A successful Retry or Abort attempt will display a notice like the following;
An attempt to Abort a subscription in PendingProvCancel status will result in the following error message;
Business Rules and Outcomes
Business Rules for Retry:
- There is no limit on the number of retries
- A success message says "Your provisioning request(s) will be processed as soon as possible.".
- Failures, although not likely, will provide an error message containing the failure reason.
| Subscription Type | Current Status | Action | Outcome |
|---|---|---|---|
| Service Subscription | PreActive | Retry | Remove Halted flag and retry external provisioning |
| Service Feature Subscription | PreActive | Retry | Remove Halted flag and retry external provisioning |
Service Bolt On Subscription or Service Bolt On Add On Subscription | PreActive | Retry | We will update the subscriptions provisioning status and retry external provisioning |
| Service Subscription | PendingProvCancel | Retry | Remove Halted Flag and retry external provisioning |
| Service Feature Subscription | PendingProvCancel | Retry | Remove Halted flag and retry external provisioning |
Service Bolt On Subscription or Service Bolt On Add On Subscription | PendingProvCancel | Retry | We will update the subscriptions provisioning status and retry external provisioning |
Business Rules for Abort:
- Abort will actually Abort the selected Preactive subscription(s) and provide a success message as per above.
- If the selection contains a "Pending Prov Cancel" subscription, system will show an error saying "
Abort operation cannot proceed because at least one of your selected subscriptions is not in Preactive status.". This is the only point where user needs to contact Emersion support.
| Subscription Type | Current Status | Action | Outcome |
|---|---|---|---|
| Service Subscription | PreActive | Abort | Will change to Aborted status. No further provisioning will take place. |
| Service Feature Subscription | PreActive | Abort | Will change to Aborted status. No further provisioning will take place. |
Service Bolt On Subscription or Service Bolt On Add On Subscription | PreActive | Abort | Will change to Aborted status. No further provisioning will take place. |
| Service Subscription | PendingProvCancel | Abort |
|
| Service Feature Subscription | PendingProvCancel | Abort |  Not currently supported |
Service Bolt On Subscription or Service Bolt On Add On Subscription | PendingProvCancel | Abort | Not currently supported |