BillingPeriodItem | Object Reference for the Salesforce Platform

When a billing schedule is invoiced, Subscription Management creates a billing period item to store the billing and payment information that is passed to an invoice line. Subscription Management next creates an invoice line for billing period items that match the invoice's target date. One billing period item is created for each billing period in the billing schedule. For example, a one-year subscription that's billed quarterly creates a billing schedule with four billing period items.

Supported Calls

describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search()

Special Access Rules

This object is available when Subscription Management is enabled.

Fields

Field	Details
Amount	Type currency Properties Filter, Sort Description Price for the billing period item. Used to calculate the invoice line's Amount field.
BillingPeriodEndDate	Type date Properties Filter, Group, Nillable, Sort Description Used to calculate the invoice line's end date.
BillingPeriodItemNumber	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description System-defined number that refers to the billing period item.
BillingPeriodStartDate	Type date Properties Filter, Group, Nillable, Sort Description Used to calculate the invoice line's start date.
BillingScheduleId	Type reference Properties Filter, Group, Sort Description The parent billing schedule of the billing period item. This field is a relationship field. Relationship Name BillingSchedule Relationship Type Lookup Refers To BillingSchedule
CurrencyIsoCode	Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description Available only for orgs with the multicurrency feature enabled. Contains the ISO code for any currency allowed by the org.
InvoiceBatchRunId	Type reference Properties Filter, Group, Nillable, Sort Description The parent invoice batch run of the billing period item. This field is a relationship field. Relationship Name InvoiceBatchRun Relationship Type Lookup Refers To InvoiceBatchRun
InvoiceLineId	Type reference Properties Filter, Group, Nillable, Sort Description This field looks up to the invoice line that's generated from the billing period item. This field is populated only when a billing period item is generated via an invoice batch run. Otherwise, this field is empty. This field is a relationship field. Relationship Name InvoiceLine Relationship Type Lookup Refers To InvoiceLine
InvoiceStatus	Type picklist Properties Filter, Group, Restricted picklist, Sort Description The status of the invoice that contains the invoice line created from the billing period item. Possible values are: `Canceled`—The invoice for this billing period item was canceled. `InError`—The invoice for this billing period item was generated in error. `NotInvoicedYet`—The invoice for this billing period item hasn't been generated yet. `Pending`—The invoice for this billing period item is being generated. `Posted`—An invoice line based on this billing period has been created and added successfully to the invoice. `WillNotInvoice`—Don't generate an invoice for this billing period item.
Status	Type picklist Properties Filter, Group, Restricted picklist, Sort Description Status of the billing period item. Draft billing period items aren't evaluated for invoice line creation. Possible values are: `Canceled` `Draft` `Reviewed`