Evergreen subscriptions do not end automatically. Unlike normal products or services, subscriptions for evergreen products or services are persistent unless explicitly canceled. 

Depending on the origin of the order creation either from CPQ  or an external system, an evergreen product is defined as:

Using CPQ functionality, if a PriceListItem of a product has the following valuesOrders created from external systems without referencing a product, and if the OLI has the following fields populated
  • PriceType is Recurring
  • AutoRenewal Type is Evergreen
  • AutoRenewalTerm is not null.
  • PriceType is Recurring
  • AutoRenewal Type is Evergreen
  • AutoRenewalTerm is a user-entered value or a derived term.

Evergreen orders can originate from various sources, like Conga CPQ, CLM, or eternal systems. Apart from this, the existing CPQ customers can create evergreen ALIs. Irrespective of their origin, evergreen OLIs or ALIs are billed more or less in the same way. Conga Billing provides you the flexibility to select the pricing source as OLI or ALI. Based on the pricing source chosen in the Billing Settings, the pricing information can be fetched either from the OLI or ALI. If the pricing source is ALI, during the creation of the BH, Billing fetches the pricing information from the ALI and the remaining data from the OLI. For more details, see Managing Pricing Source.

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

Evergreen-Billed Order and Asset Lines

If an OLI has a set of fields populated with the following values:

  • PriceType is Recurring
  • AutoRenewal Type setup is Evergreen
  • AutoRenewalTerm is either a user-entered value or a derived term but can not be null.

When billing is initiated by calling the Initiate Billing API, the Price Type field on the billing header (BH) for this product is updated to Evergreen. The billing header of an evergreen product is activated like normal products and it fetches the details like start date, end date, quantity, current unbilled amount, net unit price, etc. from the OLI. 

If any of the fields AutoRenewal Type or AutoRenewalTerm does not have a valid value or the value is missing, then the Price Type field on the billing header is marked as "Recurring".

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.

Suppose the order line item for a standalone product has the following details:

Order No.

Order Line No.

Product

Billing Frequency

Price Type

AutoRenewalType

AutoRenewalTerm

Start Date

End Date

Quantity

List price

Net Price 

O-1OLI-1ServiceHalf-yearlyRecurringEvergreen2

01-January-2024 

31-December-2024

1USD 1,200.00USD 1,200.00

When Billing is initiated, the resulting Billing Header will contain the Price Type as Evergreen instead of Recurring. The billing header shows:

Billing header ID

Order No.

Current Order Line

Product

Status

Price Type

Billing Frequency

Billing Rule

Billing Start Date

Billing End Date

Quantity

Net Unit Price 

Total Invoiced Amount

Pending Invoiced Amount

BH-1O-1OLI-1ServiceActiveEvergreenHalf-yearlyBill In Advance

01-January-2024 

31-December-2024

1USD 1,200.00USD 0.00USD 1,200.00

Auto-Renewal

As the BSRs are marked as Invoiced (using the API or using the other out-of-the-box methods), additional BSRs are auto-created based on the value of the setting Evergreen Billing Schedule Records Creation Option defined in Billing Settings. This setting cannot be kept null simultaneously at the Billing Settings and Billing Preference levels. The following table captures the business purpose of each setting value.

Suppose you have entered the value for the Evergreen Billing Schedule Records Creation Option at both the Billing Settings and Billing Preference levels. In that case, precedence is given to the value provided at the Billing Settings level.

Value

Description

Ahead of Time

New billing schedule records are created when the number of BSRs in Pending Billing status is less than the Auto Renewal Term.

Only When Needed

New billing schedule records are created only after all the existing records are Invoiced.

Pick from Billing Preference

The value is picked from the Billing Preference associated with the Billing Header.

From the above example, when billing is initiated, two BSRs are generated in pending billing status. (BSD is not shown here to keep the example simple. It is assumed that the BSD is approved and the fee amount is rolled up to the BSR.)

Billing Schedule Record No

Billing header ID

Period Start Date

Period End Date

Actual Fee Amount

Ready for Invoice Date

Status

BSR-1BH-1

01-January-2024 

30-June-2024 

USD 600.00

01-January-2024 

Pending Billing
BSR-2BH-1

01-July-2024

31-December-2024

USD 600.00

01-July-2024

Pending Billing

You called the Update Invoice API to change the status of BSR-1. The status of BSR-1 is changed to "Invoiced".

Billing Schedule Record No

Billing header ID

Period Start Date

Period End Date

Actual Fee Amount

Ready for Invoice Date

Status

BSR-1BH-1

01-January-2024 

30-June-2024 

USD 600.00

01-January-2024 

Invoiced
BSR-2BH-1

01-July-2024

31-December-2024

USD 600.00

01-July-2024

Pending Billing

The setting is set to Ahead of Time: To generate renewed BSRs ahead of time, at the Billing Settings or Billing Preference level, set the setting Evergreen Billing Schedule Records Creation Option to "Ahead of Time".

When the Evergreen Billing API is invoked, one more BSR is created. This happens because the setting value is Ahead of Time, so the API creates additional BSR(s) as soon as the existing BSR(s) are marked as Invoiced. The creation of the number of additional BSRs is determined based on the value in the Auto Renewal Term field when compared with the number of existing BSRs that are in Pending status. 

In this example, the Auto-Renewal Term is 02 (refer to the order line item details table) whereas the number of Pending BSRs dropped to 01 so the engine creates the additional BSR so that the count of the Pending BSRs matches with 02 (i.e., Auto-Renewal Term).

Billing Schedule Record No

Billing header ID

Period Start Date

Period End Date

Actual Fee Amount

Ready for Invoice Date

Status

BSR-1BH-1

01-January-2024 

30-June-2024 

USD 600.00

01-January-2024 

Invoiced
BSR-2BH-1

01-July-2024

31-December-2024

USD 600.00

01-July-2024

Pending Billing
BSR-3BH-1

01-January-2025

30-June-2025

USD 600.00

01-January-2025

Pending Billing

The date and amount fields on the BH are updated as:

Billing Start Date

Billing End Date

BH Total Invoiced AmountBH Pending Invoiced Amount

01-January-2024  

30-June-2025

USD 600.00USD 1,200.00

The setting is set to Only When Needed: To create BSRs when you need them, at the Billing Settings or Billing Preference level, set the setting Evergreen Billing Schedule Records Creation Option to "Only When Needed".

When the Evergreen Billing API is invoked, it creates BSRs according to the Auto-Renewal Term populated on the OLI.

Considering the above example, say you have invoiced both the BSRs and then invoked the Evergreen API, it creates two more BSRs. This happens because the setting value is Only When Needed, so the API creates additional BSR(s) only when all the existing BSR(s) are marked as Invoiced. The creation of the number of additional BSRs is determined based on the field Auto Renewal Term.

In this example, the Auto-Renewal Term is 02 (refer to the Billing Header) so the engine creates two more BSRs when the evergreen API is invoked after all the BSRs are invoiced. 

If you set the setting to Only When Needed at the Billing settings level and invoke the evergreen API when there are one or more BSRs in Pending Billing status, the API won't execute the request and throws an error message.

Billing Schedule Record No

Billing header ID

Period Start Date

Period End Date

Actual Fee Amount

Ready for Invoice Date

Status

BSR-1BH-1

01-January-2024 

30-June-2024 

USD 600.00

01-January-2024 

Invoiced
BSR-2BH-1

01-July-2024

31-December-2024

USD 600.00

01-July-2024

Invoiced
BSR-3BH-1

01-January-2025

30-June-2025

USD 600.00

01-January-2025

Pending Billing
BSR-4BH-1

01-July-2025

31-December-2025

USD 600.00

01-July-2025

Pending Billing

After the new BSRs are created, the TCV (Sales) field on the BH is updated to reflect the fee amount along with the TCV (Sales) from previous sales.

Updating the Total Contract Value (TCV) (Sales) on the Billing Header

The Total Contract Value (TCV) (Sales) field on the Billing Header (BH) stores the contract value of an asset from the new sale. For evergreen Order Line Items (OLI), this field is dynamic and keeps updating as new BSRs are added as part of the renewal process. The number of new BSRs created depends on the value populated in the Renewal Term field. The BSRs contain the fee amount rolled up from the respective BSDs. Therefore, the TCV (Sales) is updated to reflect the total amount from the new sale plus the sum of the amounts of the newly created BSRs.

Consider the following example:

An Evergreen service is billed for USD 1,200.00 every quarter. The TCV (Sales) field on the BH has a value of USD 1,200.00. Billing is initiated, and four BSRs (BSR-1, BSR-2, BSR-3, and BSR-4) are created with a fee amount of USD 300.00 and invoiced. 

The auto-renewal term is set to 2, hence two new BSRs are created because of auto-renewal functionality.

BSR ID

BH ID

Period Start Date

Period End Date

Actual Fee Amount

Status

BSR-5BH-101-March-202431-May-2024USD 300.00Pending Billing
BSR-6BH-101-June-202431-Aug-2024USD 300.00Pending Billing

Now the value in the TCV (Sales) field is revised to reflect the fee amount of the newly created BSRs (updated in the Billable Amount For The Current Order Line field on the BH) along with the previous sale TCV (Sales). 

Hence the new TCV (Sales) = USD 1,800.00 (USD 1,200.00 + USD 600.00).