Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.

Show Page Sections

Direct Term-based Custom Plan

You can create direct term-based custom plans without using a plan template. You can create this plan for a line item(s) or order line item(s) (OLIs), containing one-time or recurring products.

You can define this plan with or without any period range for the plan line items. If the Periods Needed is set to True, the Start Date of the subsequent installments cannot be before the start of the previous installments and the Ready for Invoice Date must be in the range of Period Start Date and Period End Date.

If a line item or an order line item already has a custom plan ID (from the previous creation), then the user can click Edit to update the custom plan and its line items.
Note: The direct custom plans are created in Active status.

Parameters for Plan Header

Enter the following parameters for the plan header of every set of OLIs or Line Items:

ParameterValue
NameName of the custom plan, for example, My_Custom_Plan_1
Use Plan TemplateFalse
Plan Template ID ID of the plan template. For direct custom plans leave it blank.
Plan TypeTerm Based
Periods NeededFalse
Number of InstallmentsSpecify the number of payment installments, for example, 3
Based OnPercentage
Computation MethodCustom or Even Distribution
DescriptionDescribe the custom plan (optional)
LineItemIds or OrderLineItemIds (Enter the value if you create a custom plan using API)Set of LineItem(s) or OrderLineItem(s) IDs
Billing Amount CriterionIndicates whether to bill based on the delta revenue or the revenue indicated in the net price. It has two values -
  • Bill Only the Delta.
  • Bill the Net Price.
  • Bill the Un-invoiced and Un-billed.

The default value is Bill the Net Price.

This setting enables you to decide whether you want to bill the net price or bill the delta amount only as part of the amendment.

If you chose to bill the net price, the billing logic is invoked to calculate the net price. This net price is used to calculate the installment amounts per the new custom plan. The billing records generated during the new sale, if outside the amendment, remain untouched. The billing records falling inside the amendment period:

  • If Invoiced, are refunded.
  • If Pending Billing, they are either canceled or Superseded per the setting Superseding the Schedules during Asset Management.

If you chose to bill only the delta, the billing application simply distributes the received delta amount from the CPQ/upstream application as part of this amendment, into installment amounts per the new custom. The billing records generated during the new sale remain untouched.

If you chose to bill the un-invoiced and un-billed, the billing application, calculates pending invoice amounts from previous sales and new billing amounts for ongoing sales, supporting the full-term, mid-term, and mid-period scenarios in plan amendments and billing frequency changes.

Parameters or Rules for Plan Line Items

Enter the following parameters for every line item of the plan:
Note: Parameters for the plan line items are subjected to the rule Periods Needed = True or False. This is elaborated in the table below.
ParametersRule, Periods Needed = FalseRule, Periods Needed = True
Period Start Date(Optional) Billing period start date. Auto-populates the ready-for-invoice date if left blank.You must enter a date which is before, during or after the contract date. The start date of subsequent installments cannot be before the start of the previous installment. It can be on the same date as the previous installment or after.
Period End DateRequired only if you have entered the period start date. The value must be greater than or equal to the period start date. If left blank, the API auto-populates it to the max value from the Ready for Invoice Date or Period Start Date.The date must be in the range of Period Start Date and Ready for Invoice Date.
Ready for Invoice DateDate when the customer will be invoiced.Ready for Invoice Date per line item is greater than or equal to the Period Start Date of that installment and equal to or higher than the Ready for Invoice Date of the previous installment.
Payment TermThe payment term associated with the plan.The payment term associated with the plan.
PercentageThe percentage of each installment. The sum of percentages of all the installments must be equal to 100. To increase the precision of the forecasted amounts, you must mention eight digits of decimal precision wherever applicable (e.g., 33.33333333, 7.14285714, etc.).The percentage of each installment. The sum of percentages of all the installments must be equal to 100. To increase the precision of the forecasted amounts, you must mention eight digits of decimal precision wherever applicable (e.g., 33.33333333, 7.14285714, etc.).
CommentsWrite your comments (optional).Write your comments (optional).

There is a new sale of a recurring product with TCV (Sales) of USD 10,000.00 and monthly billing frequency. The requirement is to bill the customer in three installments. You created a custom plan with three line items containing 40.33333333%, 25.33333333%, and 34.33333334%. You entered the following parameters for the plan header:

NameUse Plan TemplatePlan Template IDPlan TypePeriods NeededNo. of InstallmentsBased OnComputation MethodDescriptionID
My_Custom_Plan_1FalseNullTerm -basedFalse3PercentageCustomCustom Plan for ABC CompanyLI-1 or OLI-1

Because there are three installments, you must provide the line item details for three plan lines. If you have enabled the Fee Amount Rounding Schedule setting at the Billing Setting level, the engine auto-computes the first or last value in the percent field. This is elaborated in Rounding the Values and Auto-Computation.

Period Start DatePeriod End DateReady for Invoice DatePercentPayment TermComments
01-January-202520-January-202520-January-202540.33333333NET 30Comment 1
21-January-202515-March-202515-March-202525.33333333NET 60Comment 2
16-March-202525-July-202525-July-202534.33333334NET 90Comment 3
Note: When a direct custom plan is created for a line item, the custom plan ID is populated on the line item record.

When you initiate the billing, the billing header, three billing schedule records (BSRs), and three billing schedule details are created. The billing header contains the custom plan information.

BH IDCurrent OLIParent OLIBilling FrequencyBilling Start DateBilling End DateTCV (Sales)Custom PlanBillable Amount for Current OLIStatus
BH-1OLI-1OLI-1Monthly01-January-202531-December-2025USD 10,000.00Custom plan IDUSD 10,000.00Active

The BSRs are:

BSR IDCurrencyPeriod Start DatePeriod End DateReady for Invoice DateActual Fee AmountInvoice Status
BSR-1USD01-January-202520-January-202520-January-20254,033.33Pending Billing
BSR-2USD21-January-202515-March-202515-March-20252,533.33Pending Billing
BSR-3USD16-March-202525-July-202525-July-20253,433.34Pending Billing

The BSDs are:

BSR IDBSR IDRecord TypePeriod Start DatePeriod End DateReady for Invoice DateActual Fee AmountDerived Invoice StatusDescription
BSD-1BSR-1Custom Plan Line01-January-202520-January-202520-January-20254,033.33Pending Installment-1
BSD-2BSR-2Custom Plan Line21-January-202515-March-202515-March-20252,533.33Pending Installment-2
BSD-3BSR-3Custom Plan Line16-March-202525-July-202525-July-20253,433.34Pending Installment-3

Creating a Direct Custom Plan

  • For an Order Line Item (OLI):
    • The order and all selected OLIs must be in a non-activated status.
    • All selected OLIs must belong to the same order.
  • For a cart Line Item:
    • All selected line items must refer to the same configuration ID.
    • The proposal must not be in accepted status.
You can create a direct custom plan after your admin configures the Manage Custom Plan or a similar action on the Cart page.
  1. On the Cart page, click the more options icon () next to the cart actions to open the additional actions menu.
  2. Click Manage Custom Plan.
    Note: This action name is provided as an example. Administrators can customize the action name or define a new one to manage custom plans.
    The Custom Plan page opens in a new window.
  3. Click New to create a new custom plan. Create Custom Plan page opens in a new window.
    Note: The presence of warnings in a cart does not prevent custom plan creation for line items. Plan creation is restricted only when the cart contains errors.
  4. Select the line item for which you want to create a custom plan.
    Note: If a cart line item already has a custom plan, it appears grayed out and cannot be selected.
  5. Enter the header details (given in parameters for plan header) and plan line item details (given in parameters or rules for plan line items).
  6. Click Save to save the custom plan or Cancel to go back to the Cart.
A custom plan is created for the selected line item. This plan determines how billing schedule records and billing schedule details are generated for that line item.
Activate the order and initiate the billing to see that Conga Billing creates the Billing Schedule Records as per the information provided in the custom plan.

Editing a Custom Plan

The Manage Custom Plan or similar action is configured by the administrator.
Editing a custom plan typically allows the administrator to modify, update, or adjust details on the custom plan. Editing action is allowed only for a few editable fields while other fields remain un-editable.
Note: Editing a custom plan is currently supported only for cart line items.
  1. Click the row action menu () icon next to the cart actions to open the additional actions menu.
  2. Click Manage Custom Plan.
    Note: This action name is provided as an example. Administrators can customize the action name or define a new one to manage custom plans.
    The Custom Plan page opens in a new window showing a list of already created custom plans.
  3. Select the the custom plan you want to edit.
  4. Click the row action menu () icon on the left side of the target row.
    A context menu appears with two options: Edit and Delete.
  5. Click Edit from the context menu. The Edit Custom Plan window opens allowing editing the custom plan.
    Note: Fields that cannot be edited are displayed in a grayed‑out state.
  6. Make the changes and click Update.

Deleting a Custom Plan

The Manage Custom Plan or similar action is configured by the administrator.
Deleting a custom plan is typically used to revert to standard billing when customization is no longer required. After deletion, billing for the affected line items follows the default billing process.
Note: Deleting a custom plan is currently supported only for cart line items.
  1. Click the row action menu () icon next to the cart actions to open the additional actions menu.
  2. Click Manage Custom Plan.
    Note: This action name is provided as an example. Administrators can customize the action name or define a new one to manage custom plans.
    The Custom Plan page opens in a new window showing a list of already created custom plans.
  3. Select the the custom plan you want to delete from the list. The toolbar above the list becomes active once at least one row is selected.
  4. Click the Delete () icon in the toolbar above the list.
  5. Alternatively Click the row action menu () icon on the left side of the target row.
    A context menu appears with two options: Edit and Delete.
  6. Click Delete from the context menu.
  7. Confirm the deletion in the dialog prompt.