Scenario 5. Downgrading Resources via API and Manipulating with the Subscription

This is one of the scenarios in which a customer downgrades one of the services they use and the system delays the processing of the downgrade order until the next billing date to gather the necessary usage statistics and issue an invoice that will not need future corrections. The capability to delay the processing of such orders is configurable. For more detail see Configuring Delayed Processing of Orders with Downgrade Items. For the full list of such scenarios see List of Delayed Downgrade Scenarios and How Subscriptions and Delayed Orders Are Affected.

Note: This scenario is valid for all the available billing models in Billing: Charge Before Subscription Period, Charge Before Billing Period, and Charge After Billing Period. For more information see Billing Models. The example below is for the Charge Before Billing Period billing model.

These scenarios use API methods PlaceResourceUpgradeOrder_API and PlacePlanPeriodSwitchOrder_API and are similar to UI scenarios 1, 2, 3.B, and 3.C from Scenario 1. Downgrading Resource, Scenario 2. Downgrading Resource and Purchasing or Upgrading Another Resource, and Scenario 3. Downgrading Resource and Manipulating with Subscription:

• A. Place a change order to downgrade a resource via API.
• B. Switch the service plan or subscription period via API.
• C. Place another order to downgrade a resource for the same subscription via API.

Preconditions:

See Preconditions from Scenario 1. Downgrading Resource or Scenario 2. Downgrading Resource and Purchasing or Upgrading Another Resource.

Assumptions:

There are no open Change Orders placed for the subscription.

Scenarios:

A. Place a change order to downgrade a resource via API

1. Place a Change Order to downgrade a resource from the subscription via API method PlaceResourceUpgradeOrder_API.

2. Billing delays the processing of the Change Order until the next Billing Date.

   B. Switch the service plan or subscription period via API

3. Send an API call to switch the service plan or subscription period via API method PlacePlanPeriodSwitchOrder_API.

4. Billing returns an error in the response similar to this one:

   There is already a Change Order #CH000035 in Status Scheduled(WS). This order prohibits the 'Change Plan Period for Subscription' action. Please either cancel conflicting order or wait until it is processed; or contact Provider.

   C. Place another order to downgrade a resource for the same subscription via API

5. Send an API call to place another order to downgrade a resource for the same subscription via API method PlaceResourceUpgradeOrder_API.

6. Billing returns an error in the response similar to this one:

   Cannot Upgrade/Downgrade Resources for Subscription #1000025: there is already a Upgrade/Downgrade Order #CH000035 in status Scheduled(WS). This order prohibits placing an order of the same Order Type (per Subscription). Please either cancel conflicting order or wait until it is processed; or contact Provider.