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 order line item (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

  • The Price Type field is Recurring.
  • No custom plan is associated with the asset line item (ALI) or OLI.

For more on how Billing works on the Conga Platform, see  Understanding the Billing Architecture on Conga Platform.

Based on the pricing source chosen in the Billing Settings, the pricing information is fetched from the Order Line Item (OLI) or Asset Line Item (ALI). When the pricing source is set to OLI, Billing fetches all the information, including the pricing information, from the OLI. If the pricing source is set to ALI, Billing fetches the pricing information from the ALI. For more details on pricing sources, see Managing Pricing Source.

Use Case: Renewal of a Product or Service

After a product or service is renewed, and you initiate billing, the engine creates new BSRs and simultaneously updates various status, amount, and date-related fields on BH, BSRs, and BSDs.

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 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.
  • 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

ALI-1

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  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

Pricing Source

Billing Frequency

Billing Start Date

Billing End Date

Asset Line Item

Billable Amount for Current Order Line

TCV (Sales)

Total Invoiced Amount

Pending Invoice Amount

Status

BH-1

OLI-1

Recurring

ALI or OLI

Half-yearly

01 Jan 2024

31 Dec 2024

ALI-1

USD 1,200.00

USD 1,200.00

USD 600.00

USD 600.00

Active

Billing schedule 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 details:

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) (Sales) 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

ALI-1

Renewed

01 Jan 2025

31 Dec 2025

USD 2,400.00

Activated

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

BH ID

OLI ID

Price Type

Pricing Source

Billing Frequency

Billing Start Date

Billing End Date

Asset Line Item

Billable Amount for Current Order Line

TCV (Sales)

Total Invoice Amount

Pending Invoice Amount

Status

BH-1

OLI-1

Recurring

ALI or OLI

Half-yearly

01 Jan 2025

31 Dec 2025

ALI-1

USD 2,400.00

USD 3,600.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

Subsequent Renewals

When the OLI or ALI goes through multiple renewals, Billing creates renewal BSRs and populates the billing header information. 

For example, a recurring asset with yearly selling frequency undergoes multiple renewals as indicated:

ActionAssetOrderSelling TermSelling FrequencyStart DateEnd DateContract Price
New SaleAsset 1O-11Yearly01 Jan 202431 Dec 2024USD 1,000.00
Renewal 1Asset 1O-23Yearly01 Jan 202431 Dec 2027USD 3,600.00
Renewal 2Asset 1O-34Yearly01 Jan 202731 Dec 2031USD 4,800.00
Renewal 3Asset 1O-42Yearly01 Jan 203131 Dec 2033USD 2,400.00

For the above data, the billing services API generates the billing header (fewer fields are shown for clarity), billing schedule records, and billing schedule details as follows:

Action

BH ID

OLI ID

Billing Frequency

Billing Start Date

Billing End Date

Billable Amount for Current Order Line

TCV (Sales)

BSRs and BSDs

New Sale

BH-1

O-1

Yearly

01 Jan 2024

31 Dec 2024

USD 1,000.00

USD 1,000.00

One BSR and BSD with a fee amount of USD 1,000.00 is created

Renewal 1

BH-1

O-2

Yearly01 Jan 202431 Dec 2027

USD 3,600.00

USD 4,600.00

Three BSRs and BSDs with a fee amount of USD 1,200.00 are created

Renewal 2

BH-1

O-3

Yearly01 Jan 202731 Dec 2031

USD 4,800.00

USD 9,400.00

Four BSRs and BSDs with a fee amount of USD 1,200.00 are created

Renewal 3

BH-1

O-4

Yearly01 Jan 203131 Dec 2033

USD 2,400.00

USD 12,200.00

Two BSRs and BSDs with a fee amount of USD 1,200.00 are created