---
schema_version: "1"
id: 2ea36f7639d4919f10a075db9d0b6cdc96c1ff7a38a22611fc9d4a9f616f31e9
title: BillingPolicy
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_billingpolicy.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_billingpolicy.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: a285b75a9e77f9e5050b6b22dd9ab01d2083102026e745e6f159c48cd1a7800a
description: Represents a group of billing treatments, which define the rules for how to invoice a customer for an order item. This object is available in API version 55.0 and later.
---
# BillingPolicy

Represents a group of billing treatments, which define the rules for how to invoice a customer for an order item. This object is available in API version 55.0 and later.

Billing policies are related to products, which pass the policy on to the resulting order items. When an order is activated, Subscription Management assigns a billing treatment to each order item based on the values in the BillingTreatmentSelection field. Then Subscription Management uses the billing treatment to create billing schedules.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update(), upsert()

## Special Access Rules

This object is available with Subscription Management and Billing (Revenue Cloud).

For information about this object that's available with Billing (Revenue Cloud), including its special access rules, see the [Revenue Cloud Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.264.0.revenue_lifecycle_management_dev_guide.meta/revenue_lifecycle_management_dev_guide/sforce_api_objects_billingpolicy.htm "HTML (New Window)").

## Fields

| Field | Details |
| --- | --- |
| BillingTreatmentSelection | 
Type

picklist

Properties

Create, Filter, Group, Restricted picklist, Sort, Update

Description

Defines how Subscription Management assigns billing treatments to order items and to assets related to the billing policy.

Possible values are:

- Default—The value specified in the DefaultBillingTreatmentId field is automatically applied to order items and assets.
- Manual—Users must specify the billing treatment that's applied to the order items and assets.





 |
| DefaultBillingTreatmentId | 

Type

reference

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

When BillingTreatmentSelection has a value of Default, Subscription Management uses the selected billing treatment for all order items and assets related to the billing policy.

This field is a relationship field.

Relationship Name

DefaultBillingTreatment

Relationship Type

Lookup

Refers To

BillingTreatment



 |
| Description | 

Type

textarea

Properties

Create, Filter, Nillable, Sort, Update

Description

Optional user-defined description that describes the billing policy.



 |
| LastReferencedDate | 

Type

dateTime

Properties

Filter, Nillable, Sort

Description

The timestamp when the current user last accessed this record, a record related to this record, or a list view.



 |
| LastViewedDate | 

Type

dateTime

Properties

Filter, Nillable, Sort

Description

The timestamp when the current user last viewed this record or list view. If this value is null, the user might have only accessed this record or list view (LastReferencedDate) but not viewed it.



 |
| Name | 

Type

string

Properties

Create, Filter, Group, idLookup, Sort, Update

Description

Optional user-defined name for the billing policy.



 |
| Status | 

Type

picklist

Properties

Create, Filter, Group, Restricted picklist, Sort, Update

Description

The billing policy's status.

Possible values are:

- Active—Indicates that the billing policy is available for use on products.
- Draft—Indicates that the billing policy isn't available for use on products. Use this status when creating billing policies that aren't ready to be activated.
- Inactive—Indicates that the billing policy isn't available for use on products.





 |