During the renewal of a product or service, users may want to switch the billing of a recurring subscription from regular billing to custom billing. This is achieved by associating a custom plan to the billing header (BH) during the renewal process. Billing creates the renewal billing schedule records (BSRs) per the custom plan updated on the billing header.

the BSRs are created in a recurring fashion since there wasn't any custom plan. However, during the renewal, the customer opts for a customized billing hence there will be a custom plan on the BH post a renewal transaction. When initiated, the billing engine creates the renewal schedules as per the plan information.

For example, a new sale is initiated for a service with a TCV (Sales) of USD 1,200.00. The billing frequency is quarterly. The start date is 01-July-2024 and the end date is 30-June-2025. Initiating the billing creates a billing header and four BSRs with a fee of USD 300.00 each. All the BSRs are invoiced.

New Sale

The billing header has the following data:

BH ID

Current OLI

Parent OLI

ALI

Custom Plan ID

Billing Start Date

Billing End Date

TCV (Sales)

Billable Amount for Current OLI

Total Invoiced Amount

Pending Invoice Amount

Status

BH-1OLI-1OLI-1ALI-1Null01-July-202430-June-2025USD 1,200.00USD 1,200.00USD 1,200.00USD 0.00Active

The four BSRs and BSDs contain the following data:

BSR ID

BSD ID

Record Type

Category

Period Start Date

Period End Date

Actual Fee Amount

Invoice Status

BSR-1BSD-1RegularFee01-July-202430-September-2024USD 300.00Invoiced
BSR-2BSD-2RegularFee01-October-202431-December-2024USD 300.00Invoiced
BSR-3BSD-3RegularFee01-January-202531-March-2025USD 300.00Invoiced
BSR-4BSD-4RegularFee01-April-202530-June-2025USD 300.00Invoiced

After renewal

During the renewal of the service, there was a change in the payment requirement and the customer decided to proceed with custom billing with three installments, rather than recurring billing. Hence the renewal is initiated with a custom plan associated with the billing header. The renewal term is one year starting from 01-July-2025 and the renewal TCV is USD 1,200.00. To learn more about custom plans, refer to Creating a Custom Plan.

The custom plan is activated and has the following details:

Order ID

Plan Template

Custom Plan ID

Name

Plan Type

Based On

Computation Method

O-1PT-1CP-1My Custom Plan 1MilestonePercentageCustom

along with the plan line items showing the following fields:

Custom Plan ID

Plan line item ID

Percent

Milestone Expected Date

Payment Term

CP-1PLI-130

01-August-2025

Term 1
CP-1PLI-240

15-November-2025

Term 1
CP-1PLI-330

01-May-2026

Term 1

Initiating the billing shows the custom plan ID on the BH. The Billing Start Date and Billing End Date fields are updated with the renewal start date and the end date. The TCV (Sales) field is updated with the sum of previous sales and the renewal amount. The billing header fields are updated as follows:

BH ID

Current OLI

Parent OLI

ALI

Custom Plan ID

Billing Start Date

Billing End Date

TCV (Sales)

Billable Amount for Current OLI

Total Invoiced Amount

Pending Invoice Amount

Status

BH-1OLI-12OLI-1ALI-1CP-101-July-202530-June-2026USD 2,400.00USD 1,200.00USD 1,200.00USD 1,200.00Active

Suppose you completed the BSD milestones and initiated the billing to create the BSRs as follows:

BSR IDBSD IDPeriod Start DatePeriod End dateReady for Invoice DateActual Fee AmountInvoice StatusRemarks
BSR-1BSD-101-July-202430-September-202401-July-2024USD 300.00Invoiced
BSR-2BSD-201-October-202431-December-202401-October-2024USD 300.00Invoiced
BSR-3BSD-301-January-202531-March-202501-January-2025USD 300.00Invoiced
BSR-4BSD-401-April-202530-June-202501-April-2025USD 300.00Invoiced
BSR-5BSD-5

NA

NA

01-August-2025

USD 360.00Pending BillingRenewal BSR
BSR-6BSD-6

NA

NA

15-November-2025

USD 480.00Pending BillingRenewal BSR
BSR-7BSD-7

NA

NA

01-May-2026

USD 360.00Pending BillingRenewal BSR

The BSDs are as follows:

BSD IDBSR IDRecord TypeCategoryPeriod Start DatePeriod End dateMilestone StatusActual Fee AmountDerived Invoice StatusRemarks
BSD-1BSR-1RegularFee01-July-202430-September-2024NAUSD 300.00Invoiced
BSD-2BSR-2RegularFee01-October-202431-December-2024NAUSD 300.00Invoiced
BSD-3BSR-3RegularFee01-January-202531-March-2025NAUSD 300.00Invoiced
BSD-4BSR-4RegularFee01-April-202530-June-2025NAUSD 300.00Invoiced
BSD-5BSR-5

Milestone

Fee

NA

NA

Completed

USD 360.00Pending Renewal BSD
BSD-6BSR-6

Milestone

Fee

NA

NA

Completed

USD 480.00Pending Renewal BSD
BSD-7BSR-7

Milestone

Fee

NA

NA

Completed

USD 360.00Pending Renewal BSD