Billing Contract Fields

Lookup to the Salesforce Account to which this contract belongs.

Lookup to the most recent version of the contract if the current contract is a change request or a superseded contract. It can be an active or expired contract.

For example, if a change request was applied to contract CT0000310 six months ago, and another change request is currently underway but has not yet been applied, the value in the Active Contract field on both the superseded contract and on the change request will be CT0000310.

Monthly Recurring Revenue multiplied by 12. This includes discounts.

The Monthly Recurring Revenue for contract line items with the billing type "One-off" is zero, therefore they do not add to this amount.

Company to which this contract relates.

Name of the contract.

Number of the contract.

Currency of the contract. This field is only displayed if multiple currencies are enabled in your Salesforce org.

If the contract contains contract line items, you cannot change the currency from the Billing Contract Detail page when working in Lightning Experience or Classic.

If the contract contains contract line items and you change the currency using the enhanced Billing Contract Detail page, that change is applied to the contract line items, but the prices and discounts are not updated to reflect the change. If you select a price book using the enhanced Billing Contract Detail page, the prices in that price book for the selected currency are listed when you choose a product to add to the contract. The Discount popup on the enhanced Billing Contract Detail page lists the discounts for the selected currency.

Description of the contract.

Additional information about the reason for ending the contract. This field is shown as Notes when ending a contract.

End date of the contract. The end date of new contract line items are initially set to this date. Entering an End Date sets the Renewal Reminder automatically if your administrator has entered a value in the Renew Reminder Days Before Contract End field in the Billing Central Settings custom setting:

• If the value is positive, the Renewal Reminder is set before the End Date.
• If the value is negative, the Renewal Reminder is set after the End Date.
• If the value is zero, the Renewal Reminder is the End Date.
• If the field does not contain a value, the Renewal Reminder is not set automatically.

When the Renewal Reminder is set, changing the End Date of the contract has no effect on the Renewal Reminder. See Renew Reminder Days Before Contract End. If you edit the Renewal Reminder while creating the contract, the value you enter is retained and the reminder is not set using the custom setting.

When working in Lightning Experience or Classic, the Renewal Reminder on the Billing Contract Detail page is set automatically when you save the contract.

On the enhanced Billing Contract Detail page, the Renewal Reminder is set automatically when you enter an End Date for the first time. If you edit the End Date after the Renewal Reminder is set, the Renewal Reminder does not change.

First date on which the contract is to be billed. The first bill date of new contract line items are initially set to this date. If the contract includes lines with amounts that have been billed externally, their first bill date must be set to the date they were first billed in the external system.

Indicates the major version of the contract. This field is set to 1 when the contract is created. When you create a renewal the value of this field is incremented by 1.

Total monthly recurring revenue for all contract line items. This includes discounts.

The Monthly Recurring Revenue for contract line items with the billing type "One-off" is zero, therefore they do not add to this amount.

Date on which the contract was originally due to end. If this field contains a date, the duration of a renewal is calculated using this date instead of the contract end date. In this scenario, the contract end date is still used to calculate the start date of the new contract.

Lookup to the previous version of the current contract. For example:

• If the current contract was created by the renewal process, this is the active or expired contract from which the renewal was created.
• If the current contract has had change requests applied to it, this is its most recent superseded contract.
• If the current contract is itself a superseded contract, this is either its preceding superseded contract (if the active contract has undergone multiple change requests) or the contract from which it was originally created, for example, via the renewal process.

Lookup to the proration policy that defines proration for this contract.

• When creating a new contract, the default proration policy The proration policy that has the Automatically Assign to New Contracts checkbox set. is assigned unless you select an alternative. Similarly if a new contract is created automatically from an opportunity and there is no field mapping for the Proration Policy field, or there is a field mapping but it is left blank on the opportunity, the default policy is assigned.
• When creating a renewal or change request, the proration policy on the existing contract is copied to the new contract. The default is not assigned.
• When editing a contract, if you change or delete the value in this field your edit persists. The default is not assigned.

Reason that the contract ended. The default options are:

• Terminated
• Did not renew
• Renewed

Your administrator can change these options.

Lookup to the renewal that has been created from the current contract. Billing Central automatically populates this field when renewing a contract if the Automatically Populate Renewal Contract field in the Billing Central Settings custom setting is enabled.

Date on which to report that the contract is due for renewal. When you create a contract, this date is set automatically using the End Date depending on the value in the Renew Reminder Days Before Contract End field of the Billing Central Settings custom setting:

• If the value is positive, the Renewal Reminder is set before the End Date.
• If the value is negative, the Renewal Reminder is set after the End Date.
• If the value is zero, the Renewal Reminder is the End Date.
• If the field does not contain a value, the Renewal Reminder is not set automatically.

See Renew Reminder Days Before Contract End.

Date on which the contract commences. The start date of new contract line items are initially set to this date.

Status of the contract. The status can be:

• Active – When a contract is active, you might need to create a change request to edit the contract depending on the options your administrator has chosen. See Billing Central Settings and Billing Contract Field Sets.
• Draft – You can edit, delete and add lines to the contract. You can also edit and delete the contract.
• Expired – The end date of the contract has been reached and the contract is not continuous or the contract was ended.
• Superseded – This contract has been replaced by another contract. You cannot edit a contract with this status.

Total value of all "Recurring Fixed" and "One-off" contract lines over the entire life of the contract if the contract is not continuous. “Recurring Variable” lines are billed based on customer usage so they are not included unless they have a quantity set as estimated usage. See How Total Contract Value is Calculated for more information. When you make changes to the contract, this field updates automatically based on the Dynamic TCV field.

Lookup to a contract line item that the current line aligns to for its billing dates and periods. This field can be populated either when aligning contract line items manually, or as a result of amending prices. For more information, see Aligning Billing Dates When Adding Lines to an Active Contract and Amending Prices on Active Contracts.

Monthly Recurring Revenue multiplied by 12. This includes discounts.

The Annual Recurring Revenue for contract line items with the billing type "One-off" is zero.

This checkbox is used for reporting purposes only. You should select this option if the contract line item is being billed in arrears based on usage.

Date up to which the contract line item has been billed outside of Billing Central. Billing schedules are not created for periods before this date. This field must be populated if the Amount Billed Externally is a value other than zero. This field is cleared on renewals.

Date up to which the contract line item has been billed. This is the Billing Period End Date of the related billing document line item, which belongs to the last completed billing document associated with this contract line item.

This field is updated when the related billing document is complete and Foundations messaging has run successfully. The Message Delivery job is usually scheduled to run at regular intervals (via the Foundations Setup tab) or can be run immediately using the Run Job Now action. See Scheduling Message Delivery.

Defines the frequency in which billing schedules are created for the contract line item, and is used with First Bill Date to calculate billing dates for the schedules if Recurring Bill Date is not set. This is a lookup to a soft date. For more information, see Soft Dates.

The way in which a bill is to be generated. You can choose from:

• One-off – a fee is billed once.
• Recurring Fixed – a fixed fee is billed at a regular interval.
• Recurring Variable – a fee is billed at a regular interval based on the quantity and usage data associated with the contract line item.

The default value is None.

The frequency at which the contract line item is to be charged (if different from the billing term). For example, the contract line item might be billed quarterly but charged monthly. This is a lookup to a soft date. For more information, see Soft Dates.

A charge term can only be set for lines where the billing type is "Recurring Fixed". If this field is left blank, the contract line item is both charged and billed at the frequency defined by the Billing Term.

The formula that represents the charge term soft date. For more information, see Soft Dates.

If Charge Term is blank, the Billing Term Definition is used.

Contract to which this contract line item belongs.

Status of the contract to which this contract line item belongs.

For internal use only. Indicates that one or more lines on this contract are aligned to this contract line item for billing purposes. When selected, the contract line item cannot be deleted and its billing details cannot be edited.

You cannot edit this field manually. It is edited automatically as a result of aligning contract line items manually, or amending prices. For more information, see Aligning Billing Dates When Adding Lines to an Active Contract and Amending Prices on Active Contracts.

Currency of this contract line item.

Textual description of the contract line item.

End date of the contract line item. When a new contract line item is created, this is initially set to the end date of the contract.

First date on which the contract line item is to be billed. When a new contract line item is created, this defaults to the contract's first bill date.

Multiplier used to calculate monthly recurring revenue. This is copied from the Monthly Recurring Revenue Multiplier on the Charge Term or Billing Term associated with the contract line item. Charge Term can only be set for contract line items with the billing type "Recurring Fixed", and if left blank Billing Term is used. This is set to zero for contract line items with the billing type "One-off". For information, see Monthly Recurring Revenue Multiplier.

Indicates that the contract line item is on hold for billing, meaning that it is currently excluded from billing processes. If the contract is billed while this checkbox is selected, the billing documents created will not include amounts for this contract line item.

Lookup to the plan from which the contract line item was created.

Pricing type of the contract line item:

• Fixed – The Unit Price is fixed.
• Volume – The Unit Price varies depending on the quantity purchased.
• Tiered – The Unit Price varies depending on the quantity purchased and the quantity breaks in the pricing structure. Each quantity break is only applied to the units that exceed its quantity. See Tiered Pricing Structure.

When working in Lightning Experience or Classic, this field is populated automatically based on whether there is a pricing structure on the line.

Lookup to the Salesforce Product to which the contract relates. This can be a product or service.

Quantity of the product or service being purchased to six decimal places. If the contract line item's billing type is "One-off" or "Recurring Fixed" you must enter a value that is not zero or blank.

Lookup to a soft date which is applied to the First Bill Date to calculate billing dates for this contract line item's schedules. This can only be set for contract line items where the billing type is "Recurring Fixed" or "Recurring Variable". If this field is left blank, billing dates are calculated using Billing Term. For more information, see Using Recurring Bill Date.

The type of revenue from which the contract line item originates. You can choose from:

• Churn
• Downgrade
• Net New Booking
• Upgrade

Total price for the contract line including discounts. This is either calculated using the formula Quantity x Unit Price or it is equal to the Sales Price Override if that field contains a value.

Contains a value that overrides the Sales Price. This value is calculated when complex pricing rules apply, such as when the contract line item has a pricing structure.

First date from which billing can commence for this contract line item. This must be on or after the contract's start date.

Total amount billed for the contract line item. When a draft contract is saved, any Amount Billed Externally is included in this total.

Once the contract is activated, this field is updated when the related billing document is complete and Foundations messaging has run successfully. The Message Delivery job is usually scheduled to run at regular intervals (via the Foundations Setup tab) or can be run immediately using the Run Job Now action. See Scheduling Message Delivery.

When you set a billing document to "Complete", the Total Billed field on related contract line items is updated:

• If the billing document is of type "Invoice", the value of the related billing document line item is added
• If the billing document is of type "Credit Note", the value of the related billing document line item is subtracted

This enables you to create reports to analyze the revenue on each contract.

When you convert a billing document of type "Invoice" to "Credit Note", a process is started to update this field.

Total value of the contract line item over its lifetime including discounts. See How Total Contract Value is Calculated for more information about how Total Contract Value and Total Contract Line Value are calculated.

Lookup to the unit of measure used for reporting.

Price of one item to nine decimal places. This is used to calculate the Sales Price.

If a variable Billing Type and volume or tiered Pricing Type is selected, clicking this field in the enhanced Billing Contract Detail page displays the Unit Price popup that enables you to set quantity breaks or change the existing quantity breaks for the contract line item. If a pricing structure is set for the contract line item, this field shows the minimum and maximum unit prices of the quantity breaks in that pricing structure.