Download PDF
Download page Renewing the Billing of a Product.
Renewing the Billing of a Product
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:
Action | Asset | Order | Selling Term | Selling Frequency | Start Date | End Date | Contract Price |
---|---|---|---|---|---|---|---|
New Sale | Asset 1 | O-1 | 1 | Yearly | 01 Jan 2024 | 31 Dec 2024 | USD 1,000.00 |
Renewal 1 | Asset 1 | O-2 | 3 | Yearly | 01 Jan 2024 | 31 Dec 2027 | USD 3,600.00 |
Renewal 2 | Asset 1 | O-3 | 4 | Yearly | 01 Jan 2027 | 31 Dec 2031 | USD 4,800.00 |
Renewal 3 | Asset 1 | O-4 | 2 | Yearly | 01 Jan 2031 | 31 Dec 2033 | USD 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 | Yearly | 01 Jan 2024 | 31 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 | Yearly | 01 Jan 2027 | 31 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 | Yearly | 01 Jan 2031 | 31 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 |