Download PDF
Download page Change Action for Minimizing the Superseding.
Change Action for Minimizing the Superseding
When you execute the API for Change, Billing modifies the fields on the activated billing header per the change request or displays an error message.
Prerequisites
- The billing setting, Superseding the Schedules during Asset Management is set to Minimize.
- The current OLI's Delta Price field is populated. It can be 0.00 but not null.
Contact your admin to make this functionality available in your application so that clicking a button calls the billing services API.
At the end of the amendment process:
- Billing schedule records (BSRs) for the periods not impacted by the Change operation remain unchanged.
- Because the Superseding the Schedules during Asset Management billing setting is set to Minimize for the impacted period, Billing creates delta billing schedule details (BSDs) and BSRs based on the record's invoice status.
- For un-invoiced records: Billing creates BSDs with delta fee amounts under existing BSRs. Existing adjustment BSDs remain unchanged. The BSRs reflect the updated fee amount to be billed to the customer.
- For invoiced records: Billing creates new BSRs and BSDs for the invoiced records. A period's BSD captures the delta price, which can be either negative or positive.
- On the billing header:
- The values in the Billing Start Date, Billing End Date, Selling Term, Net Unit Price, and Quantity fields are updated to the corresponding values from the Current OLI fields.
- The value in the Billable Amount from the Current Order Line field is updated to the Current OLI's Delta Price field.
- TCV (Sales) is updated to the sum of the previous TCV (Sales) and the value in the Current OLI's Billable Amount field.
The above-mentioned statements can be understood with the help of the example given below.
A new sale is initiated for a service with a TCV (Sales) of USD 600.00. The billing frequency is monthly. The start date is 01-January-2024 and the end date is 30-June-2024. You initiate the billing to create a billing header and six BSRs with a fee amount of USD 100.00 each. There are adjustments of USD 30.00 for BSD-5 and BSD-6.
New Sale
Suppose you invoiced BSR-1, BSR-2, BSR-3, and BSR-4. The billing header shows the following data:
BH ID | Current OLI | Parent OLI | ALI | Billing Start Date | Billing End Date | TCV (Sales) | Billable Amount for Current OLI | Total Invoiced Amount | Pending Invoice Amount | Total Adjusted Amount | Total Bill Including Adjustments | Status |
---|---|---|---|---|---|---|---|---|---|---|---|---|
BH-1 | OLI-1 | OLI-1 | ALI-1 | 01-January-2024 | 30-June-2024 | USD 600.00 | USD 600.00 | USD 400.00 | USD 200.00 | USD 60.00 | USD 660.00 | Active |
The data of the six BSRs and BSDs are shown in the table:
BSR ID | BSD ID | Record Type | Category | Period Start Date | Period End Date | Actual Fee Amount | Derived Invoice Status | Remarks |
---|---|---|---|---|---|---|---|---|
BSR-1 | BSD-1 | Regular | Fee | 01-January-2024 | 31-January-2024 | USD 100.00 | Invoiced | |
BSR-2 | BSD-2 | Regular | Fee | 01-February-2024 | 29-February-2024 | USD 100.00 | Invoiced | |
BSR-3 | BSD-3 | Regular | Fee | 01-March-2024 | 31-March-2024 | USD 100.00 | Invoiced | |
BSR-4 | BSD-4 | Regular | Fee | 01-April-2024 | 30-April-2024 | USD 100.00 | Invoiced | |
BSR-5 | BSD-5 | Regular | Fee | 01-May-2024 | 31-May-2024 | USD 100.00 | Pending | |
BSD-5.a | Regular | Adjustment | 01-May-2024 | 31-May-2024 | USD 30.00 | Pending | Adjustment | |
BSR-6 | BSD-6 | Regular | Fee | 01-June-2024 | 30-June-2024 | USD 100.00 | Pending | |
BSD-6.a | Regular | Adjustment | 01-June-2024 | 30-June-2024 | USD 30.00 | Pending | Adjustment |
After Change
Suppose you want to provide a discount of USD 125.00 from the mid-period of BSR-4 through BSR-6 and initiate the change operation which is effective from 16-April-2024. You should send this price change to the existing billing header using a new OLI. When the OLI is activated and initiated for billing, the billing engine applies the price changes on the header and adjusts the schedules as shown below:
BH ID | Current OLI | Parent OLI | ALI | Billing Start Date | Billing End Date | TCV (Sales) | Billable Amount for Current OLI | Total Invoiced Amount | Pending Invoice Amount | Total Adjusted Amount | Total Bill Including Adjustments | Status |
---|---|---|---|---|---|---|---|---|---|---|---|---|
BH-1 | OLI-110 | OLI-1 | ALI-1 | 16-April-2024 | 30-June-2024 | USD 475.00 | (USD 125.00) | USD 400.00 | USD 75.00 | USD 60.00 | USD 535.00 | Active |
The BSRs and BSDs after the change operation:
BSR ID | BSD ID | Record Type | Category | Period Start Date | Period End Date | Actual Fee Amount | Derived Invoice Status | Remarks |
---|---|---|---|---|---|---|---|---|
BSR-1 | BSD-1 | Regular | Fee | 01-January-2024 | 31-January-2024 | USD 100.00 | Invoiced | |
BSR-2 | BSD-2 | Regular | Fee | 01-February-2024 | 29-February-2024 | USD 100.00 | Invoiced | |
BSR-3 | BSD-3 | Regular | Fee | 01-March-2024 | 31-March-2024 | USD 100.00 | Invoiced | |
BSR-4 | BSD-4 | Regular | Fee | 01-April-2024 | 30-April-2024 | USD 100.00 | Invoiced | Since BSR-4 is invoiced, it remains unchanged. A new BSR-7 is created to accommodate the effect of the Change operation. |
BSR-5 | BSD-5 | Regular | Fee | 01-May-2024 | 31-May-2024 | USD 100.00 | Pending | |
BSD-5.a | Regular | Adjustment | 01-May-2024 | 31-May-2024 | USD 30.00 | Pending | Adjustment | |
BSD-5.b | Regular | Fee | 01-May-2024 | 31-May-2024 | (USD 50.00) | Pending | Incremental BSD | |
BSR-6 | BSD-6 | Regular | Fee | 01-June-2024 | 30-June-2024 | USD 100.00 | Pending | |
BSD-6.a | Regular | Adjustment | 01-June-2024 | 30-June-2024 | USD 30.00 | Pending | Adjustment | |
BSD-6.b | Regular | Fee | 01-June-2024 | 30-June-2024 | (USD 50.00) | Pending | Incremental BSD | |
BSR-7 | BSD-7 | Regular | Fee | 16-April-2024 | 30-April-2024 | (USD 25.00) | Pending | New BSR to provide a refund for the partial period against BSR-4, which is invoiced. |