Setting Billing Header to Contracted

It’s a common standard for an enterprise to create bundles and nested bundles as a part of their product offering and configuration. When these bundles are configured, ordered, and billed, there are multiple possibilities on how such bundles must be invoiced to the “Bill To” account on that order.

Invoice only the top bundle or the main assembly.
Invoice only the detailed components.
Invoice only the sub-bundles or the sub-assemblies.
Invoice any combinations from the above.

Hence, it becomes essential to provide a feature that enables the admin to know which level of the bundle component will be invoiced. To facilitate this, a new field "Contracted?" is introduced on the billing header. When invoicing is initiated, the billing schedule records (BSRs) under the billing header with the value "Contracted = True" are picked for invoicing.

To Set Billing Header to Contracted

If the billing header is created with a Conga Product reference, then the Contracted value is derived based on what has been chosen at the product setup w.r.t what has been ‘derived’ at the Order Line Item level based on various configurations.

Prerequisites

The billing header references a product.
The Price Type field on the billing header is either Recurring or Evergreen or Usage or One Time.
The value in the product field "Invoice Level for Bundle" = the value in the OLI field "Derived Level in a Bundle Structure".

You must create a product and pass the product ID during OLI creation. When the OLI is created, run the Initiate Billing API to generate the billing header, BSRs, and BSDs. Per the settings given in the prerequisites, the BH is marked as Conrtacted = True.

Consider the example:

You have created a product FFP_GP with the "Invoice Level for Bundle" field set to Bundle. Create an OLI to include this product. The "Derived Level in a Bundle Structure" field must be updated with a value as "Bundle" on the OLI as shown:

OLI ID	Order	Price Type	Line Status	Product	Selling Frequency	Billing Frequency	Start Date	End Date	Derived Level in a Bundle Structure	Net Price	Status
OLI-1	O-1	Recurring	New	FFP_GP	Yearly	Monthly	01-Oct-23	30-Sep-24	Bundle	USD 1,200.00	Activated

Call the initiate billing API to generate the billing header, BSRs, and BSDs. You can see that the BH is marked as Contracted = True as shown:

ID	OLI ID	Price Type	Contracted	Period Start Date	Period End Date	Current Unbilled Amount	Total Invoice Amount	Pending Invoice Amount	Status
BH-1	OLI-1	Recurring	True	01-Oct-2023	30-Sep-2024	USD 1,200.00	USD 0.00	USD 0.00	Active

BSRs and BDSs will be genarated in usaual manner. For more information, see Billing Recurring Products.

When you initiate invoicing the BSRs under BH-1 are picked for invoicing.