---
schema_version: "1"
id: dadf89df5d6ec3d9f27bf806a428c9e3ca7564acf60e4806c3bcdc68ef1beade
title: BillingTreatment
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_billingtreatment.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_billingtreatment.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 400b2c9d7059128d4bdac53a29c2ab63ac24b55077a92a75a6c25b710ebd32c4
description: Defines how Subscription Management bills an order item. The Exclude From Billing field controls whether the order item is invoiced. Child billing treatment items control how much of the order item's balance is invoiced for each invoice across the subscription's lifecycle. Billing treatments are assigned to order items based on the parent billing policy's Billing Treatment Selection field. This object is available in API version 55.0 and later.
---
# BillingTreatment

Defines how Subscription Management bills an order item. The Exclude From Billing field controls whether the order item is invoiced. Child billing treatment items control how much of the order item's balance is invoiced for each invoice across the subscription's lifecycle. Billing treatments are assigned to order items based on the parent billing policy's Billing Treatment Selection field. This object is available in API version 55.0 and later.

## 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_billingtreatment.htm).

## Fields

| Field | Details |
| --- | --- |
| BillingPolicyId | 
Type

reference

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

The ID of the billing policy for the billing treatment.

This field is a relationship field.

Relationship Name

BillingPolicy

Relationship Type

Lookup

Refers To

BillingPolicy



 |
| Description | 

Type

textarea

Properties

Create, Filter, Nillable, Sort, Update

Description

Optional user-defined description of the billing treatment.



 |
| ExcludeFromBilling | 

Type

picklist

Properties

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

Description

Excludes any order items assigned to the treatment from creating billing schedules.

Possible values are:

- No
- Yes





 |
| 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.



 |
| LegalEntityId | 

Type

reference

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

The ID of the legal entity used to assign the treatment to order items when the parent billing policy's BillingTreatmentSelection is LegalEntity.

This field is a relationship field.

Relationship Name

LegalEntity

Relationship Type

Lookup

Refers To

LegalEntity



 |
| Name | 

Type

string

Properties

Create, Filter, Group, idLookup, Sort, Update

Description

Optional user-defined name for the billing treatment.



 |
| Status | 

Type

picklist

Properties

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

Description

Draft or inactive billing treatments can't be assigned to order items.

Possible values are:

- Active
- Draft
- Inactive





 |

## Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

[BillingTreatmentHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") (API version 55.0)

History is available for tracked fields of the object.