What's the subscription lifecycle?
Each subscription typically moves through certain predefined statuses as part of its lifecycle.
Here are the predefined statuses:
-
Draft: The initial status of the subscription.
-
Pending Approval: When you submit a subscription for internal approval, its status changes to Pending Approval.
-
Active: When you approve a subscription, its status changes to Active.
-
Under Amendment: When you amend a subscription line, its status changes to Under Amendment.
-
Expired: When a subscription reaches its end date, the status of the subscription changes to Expired.
The actions you can take on a subscription during each of its statuses are determined by status rules. For example, you can’t edit some fields in the UI for certain statuses. And, for example, the Tax Control field becomes read-only when a subscription is in active status.
In addition, when a subscription moves out of a status, the resulting status follows rules.
This chart shows how a subscription moves through its lifecycle, from its creation to its approval. A new subscription is created in the Draft status. Then, depending on different actions, some manual and some through workflow, the subscription goes through different lifecycle statuses.
![Create subscription workflow](images/OSS_SubscriptionLifecycle_1_20068369.png)
Actions for Draft Subscriptions
Here are the different actions you can perform on a subscription and its lines when the subscription is in Draft status:
Subscription Action |
Resulting Subscription Status |
Subscription Line Action |
Resulting Subscription Line Status |
---|---|---|---|
Activate |
Active |
Add subscription line |
Draft |
Preview |
No change |
Update subscription line |
Draft |
Reprice |
No change |
Reprice line |
Draft |
Regenerate Billing Schedule |
No change |
Regenerate Billing Schedule |
Draft |
Cancel |
Canceled |
Cancel |
Canceled |
Actions for Subscriptions Under Amendment
Here are the different actions you can perform on a subscription and its lines when the subscription is in the Under Amendment status.
Subscription Action |
Resulting Subscription Status |
Subscription Line Action |
Resulting Subscription Line Status |
---|---|---|---|
Activate |
Active |
Add subscription line |
Draft |
|
No change |
Amend subscription line (only if the line is active) |
Under amendment |
Preview |
No change |
Delete subscription line (only if the line is draft) |
NA |
Validate |
No change |
Reprice line (only if the line is draft) |
Draft |
Validate |
No change |
Regenerate billing schedule (only if the line is draft) |
Draft |
Validate |
No change |
Cancel (only if the line is draft) |
Canceled |
Validate |
No Change |
Close (only if the line is active or expired) |
Closed |
Actions for Subscriptions Pending Approval
Here are the different actions you can perform on a subscription and its lines when the subscription is in the Pending Approval status.
Subscription Action |
Resulting Subscription Status |
Subscription Line Action |
Resulting Subscription Line Status |
---|---|---|---|
Withdraw |
Under amendment (if the previous state was under amendment) |
NA |
NA |
Withdraw |
Draft (if the previous state was draft) |
NA |
NA |
|
No change |
NA |
NA |
Preview |
No change |
NA |
NA |
Actions for Active Subscriptions
Here are the different actions you can perform on a subscription and its lines when the subscription is in the Active status.
Subscription Action |
Resulting Subscription Status |
Subscription Line Action |
Resulting Subscription Line Status |
---|---|---|---|
Renew |
Active |
Add subscription line |
Draft |
Close |
Closed |
Close subscription line (only if the line is active or expired) |
Closed |
|
Active |
Amend subscription line (only if the line is active) |
Under amendment |
Preview |
Active |
NA |
NA |
Validate |
Active |
NA |
NA |
Actions for Expired Subscriptions
Here are the different actions you can perform on a subscription and its lines when the subscription is in the Expired status.
Subscription Action |
Resulting Subscription Status |
Subscription Line Action |
Resulting Subscription Line Status |
---|---|---|---|
Renew |
Expired |
Add subscription line |
Draft |
Close |
Closed |
Close subscription line (only if the line is active) |
Closed |
|
Expired |
Amend subscription (only if the line is active) |
Under amendment |
Preview |
Expired |
NA |
NA |
Validate |
Expired |
NA |
NA |