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.

Creating Billing Plans

createBillingPlan API is used to create a billing plan. It creates a billing plan and billing plan line items for the given proposal ID.

API

Signature

createBillingPlan

static Apttus_Billing.BillingService.BillingPlanAPIResponse createBillingPlan(Id proposalId, Id billingPlanTemplateId, Set proposalLineItemIds)

This API accepts Proposal ID, Billing Plan Template ID, and Proposal Line Item IDs as input parameters. It creates a billing plan and billing plan line items for the given proposal ID. Created billing plan is applied to the list of provided proposal IDs. If you do not provide any proposal line item IDs as input parameters, the created billing plan is applied to all the proposal line items. This API skips the proposal line items that are already linked to a billing plan.

For a billing plan template with plan type as Milestones, createBillingPlan API also creates milestones.

Request

Field

Type

Required?

Description

proposalID

ID

Yes

ID of the proposal

billingPlanTemplateId

ID

Yes

IDof the Billing Plan Template

proposalLineItemIds

Set <Id>

No

Set of proposal Ids

Response

Field

Type

Description

isSuccess

Boolean

Returns true if the API is executed correctly

errorMessage

String

Error Message if the API is not executed successfully.

billingPlanId

ID

Id of the created Billing Plan

Code Sample

Id proposalId = 'a2G1N000002RpRZUA0';
Id billingPlanTemplateId = 'a3D1N000000blZc';
Set<Id> proposalLineItemIds = new Set<Id>('a2E1N000001dHox', 'a2E1N000001eHox');
Apttus_Billing.BillingService.BillingPlanAPIResponse response;
// Call API without proposal line item ids parameter
response = Apttus_Billing.BillingService.createBillingPlan(proposalId, billingPlanTemplateId);

// Call API with proposal line item ids parameter
response = Apttus_Billing.BillingService.createBillingPlan(proposalId, billingPlanTemplateId, proposalLineItemIds);
Warning: createBillingPlan API is not supported for Evergreen Billing and Usage-based products.