--- schema_version: "1" id: 6c155ceab1c96afff8e6fee39409a2e7ea0420897a679ca0506152f3889d7eca title: Consumption Schedule collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_consumption_schedule.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_consumption_schedule.htm source_site: developer.salesforce.com content_type: documentation content_hash: 2886ea045d40913f65b40b0c45f1501f088633e1cd3d0322fc79112103b2cd46 description: A consumption schedule organizes a set of consumption rates by which usage-based products are quoted and billed. This object is available in API version 45.0 and later. --- # Consumption Schedule A consumption schedule organizes a set of consumption rates by which usage-based products are quoted and billed. This object is available in API version 45.0 and later. Salesforce uses consumption schedules to group consumption rates. Your consumption schedule defines the unit of measurement and rating method for the schedule's rates. It also defines the billing frequency that Salesforce Billing uses to invoice a usage product. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields | Field | Details | | --- | --- | | BillingTerm | Type int Properties Create, Filter, Group, Sort, Update Description The number used with the billing term unit to determine billing frequency. | | BillingTermUnit | Type picklist Properties Create, Filter, Group, Restricted picklist, Sort, Update Description The unit used with the billing term to determine billing frequency Possible values are: - Month— - Quarter— - Year— | | CurrencyIsoCode | Type picklist Properties Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Available only for orgs with the multicurrency feature enabled. Possible values are: - AUD—Australian Dollar - CAD—Canadian Dollar - GBP—British Pound - JPY—Japanese Yen - USD—U.S. Dollar | | Description | Type textarea Properties Create, Nillable, Update Description Description of the consumption schedule. | | IsActive | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether this record is active (true) or not (false). Label is **Active**. | | 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. | | MatchingAttribute | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Salesforce Billing matches usage with a consumption schedule if the records share Matching Attribute value. | | Name | Type string Properties Create, Filter, Group, idLookup, Sort, Update Description Required. Default name of this record. Label is **Product Name**. | | NumberOfRates | Type int Properties Filter, Group, Nillable, Sort Description The number of consumption rates in this consumption schedule. | | OwnerId | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The user who owns a consumption schedule record. This is a polymorphic relationship field. Relationship Name Owner Relationship Type Lookup Refers To Group, User | | RatingMethod | Type picklist Properties Create, Filter, Group, Restricted picklist, Sort, Update Description A specific use case to rate usage against the schedule. This field is the controlling picklist for the Type field. Possible values are: - Tier | | SBQQ\_\_Category\_\_c | Type picklist Properties Create, Defaulted on create, Filter, Group, Sort, Update Description This field is available only with Salesforce CPQ. You can define custom categories to organize consumption schedules in separate tabs on sales rep UI. If you do this, make sure to create a field set for each category. Possible values are: - Rates | | Type | Type picklist Properties Create, Filter, Group, Restricted picklist, Sort, Update Description Defines how rate tiers are calculated. Possible values are: - Range—The schedule prices only using the tier that applies to the usage quantity. - Slab—Usage within a given bound receives pricing equal to its tier’s value. | | UnitOfMeasure | Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description A unit of measure defines how you quantify instances of usage for your usage products. For example, if your usage product is a cloud storage subscription, you could provide a value of GB for your unit of measure. | | blng\_\_BillingRule\_\_c | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description This field is available only with Salesforce Billing. Salesforce Billing invoices usage summaries based off their related consumption schedule's billing rule. | | blng\_\_RevenueRecognitionRule\_\_c | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description This field is available only with Salesforce Billing. Salesforce Billing recognizes usage summary revenue based off the summary's related revenue recognition rule. | | blng\_\_TaxRule\_\_c | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description This field is available only with Salesforce Billing. Salesforce Billing taxes usage summary invoice lines based off the summary's related tax rule. |