Renewal of a product or service is a common and effective way to extend its subscription. During the renewal of a product or service, new billing schedule records (BSRs) are created for the renewal period as indicated on the OLI. If any schedules are still in pending status from the previous sale, they remain as is and are not impacted by the renewal process.

Prerequisites

  • An order is created from CPQ.
  • The Price Type field is Recurring.

After a product, service, or asset line item is renewed, and you initiate billing, the engine creates new BSRs and simultaneously updates various status, amount, and date-related fields on OLI, BH, BSRs, and BSDs. At the end of the renewal process, 

  • The start date and the end date on the BH are updated as per the current OLI. The original start date remains unchanged. 
  • Billable Amount for the Current Order Line field on the BH shows how much amount is to be billed as a result of renewal operation.
  • The total invoice amount on the BH remains the same.
  • New BSRs are created in pending billing status. 
  • New BSDs are created in pending status. The fee amount reflects the net price derived from the renewal OLI.

Consider the example:

Before renewal: During a new sale following fields are populated on the OLI.

OLI ID

Order

Price Type

Asset Line Item

Line Status

Start Date

End Date

Net Price

Status

OLI-1

O-1

Recurring

Asset Line Item ID

New

01 Jan 2024

31 Dec 2024

USD 1,200.00

Activated

You called the initiate billing API and it generated a BH, a BSR, and a BSD. The BH is in active status. The statuses of BSR and BSD are pending billing and pending respectively. You initiated invoicing so that the status of the BSR and its corresponding BSD is updated to invoiced. The  Current Unbilled Amount and Total Invoice Amount fields on the BH are updated with the rolled-up fee amount from the BSD.

Billing Header:

BH ID

OLI ID

Price Type

Billing Frequency

Period Start Date

Period End Date

Asset Line Item

Billable Amount for Current Order Line

Total Invoice Amount

Pending Invoice Amount

Status

BH-1

OLI-1

Recurring

Half-yearly

01 Jan 2024

31 Dec 2024

Asset Line Item ID

USD 1,200.00

USD 600.00

USD 600.00

Active

BillingSschedule Record:

BSR ID

BH ID

Period Start Date

Period End Date

Ready for Invoice Date

Actual Fee Amount

Invoice Status

BSR-1

BH-1

01 Jan 2024

30 June 2024

01 Jan 2024

USD 600.00

Invoiced

BSR-2

BH-1

01 Jul 2024

31 Dec 2024

01 Jul 2024

USD 600.00

Pending Billing

Billing Schedule Detail:

BSD ID

BSR ID

Category

Period Start Date

Period End Date

Actual Fee Amount

Derived Invoice Status

BSD-1

BSR-1

Fee

01 Jan 2024

30 June 2024

USD 600.00

Invoiced 

BSD-2

BSR-2

Fee

01 Jul 2024

31 Dec 2024

USD 600.00

Pending

After Renewal: Say, you've initiated the renewal for another year. However, the price has doubled during the renewal. This results in a billable amount of USD 2,400.00 for the renewed period, thus resulting in a Total Contract Value (TCV) of USD 3,600.00 (USD 1,200.00 from new sale + USD 2,400.00 from the renewal).

OLI: The Line Status field on the OLI is updated to Renewed and the start and end dates are updated accordingly.

OLI ID

Order

Price Type

Asset Line Item

Line Status

Start Date

End Date

Net Price

Status

OLI-1

O-1

Recurring

Asset Line Item ID

Renewed

01 Jan 2025

31 Dec 2025

USD 2,400.00

Activated

Billing Header: Start Date, End Date, Billable Amount for Current Order Line, and Pending Invoice Amount fields are updated.

BH ID

OLI ID

Price Type

Billing Frequency

Period Start Date

Period End Date

Asset Line Item

Billable Amount for Current Order Line

Total Invoice Amount

Pending Invoice Amount

Status

BH-1

OLI-1

Recurring

Half-yearly

01 Jan 2025

31 Dec 2025

Asset Line Item ID

USD 2,400.00

USD 600.00

USD 3,000.00

Active

Billing Schedule Record: Two new BSRs are created.

BSR ID

BH ID

Period Start Date

Period End Date

Ready for Invoice Date

Actual Fee Amount

Invoice Status

BSR-1

BH-1

01 Jan 2024

30 June 2024

01 Jan 2024

USD 600.00

Invoiced

BSR-2

BH-1

01 Jul 2024

31 Dec 2024

01 Jul 2024

USD 600.00

Pending Billing

BSR-3

BH-1

01 Jan 2025

30 June 2025

01 Jan 2025

USD 1,200.00

Pending Billing

BSR-4

BH-1

01 Jul 2025

31 Dec 2025

01 Jul 2025

USD 1,200.00

Pending Billing

Billing Schedule Detail: Two new BSDs are created.

BSD ID

BSR ID

Category

Period Start Date

Period End Date

Actual Fee Amount

Derived Invoice Status

BSD-1

BSR-1

Fee

01 Jan 2024

30 June 2024

USD 600.00

Invoiced 

BSD-2

BSR-2

Fee

01 Jul 2024

31 Dec 2024

USD 600.00

Pending

BSD-3

BSR-3

Fee

01 Jan 2025

30 June 2025

USD 1,200.00

Pending 

BSD-4

BSR-4

Fee

01 Jul 2025

31 Dec 2025

USD 1,200.00

Pending