BillingScheduleGroup

Represents a consolidated view of all billing schedules related to the order items generated from one asset, including new orders and amendment orders.

When an order is created, a billing schedule is generated for each order item. The billing schedule group summarizes fields from each billing schedule. For example, it summarizes financial fields such as Total Billed Amount and Total Pending Amount and billing fields such as Billing Day of Month and Billing Term.

The billing schedule group includes schedules generated from a new order item and schedules generated from amendment order items. The billing schedule group shows users the summarized financial data that includes any changes, such as new orders or amendments, made to the asset.

Introduced in API version 55.0.

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

  • This object is available with Subscription Management, Commerce Subscriptions, and Billing (Revenue Cloud). If your org has both Subscription Management and Commerce Subscriptions, then Subscription Management takes precedence.
  • For information about this object that’s available with Billing (Revenue Cloud), including its special access rules, see the Revenue Cloud Developer Guide.
  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort

  • Introduced: API version 62.0

  • Relationship name: AnchorProdtBillingSchdGrp

  • Relationship type: relationship

  • Refers to: BillingScheduleGroup

  • Type: int

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The Billing Day of Month for the billing schedules that comprise the billing schedule group.

    Subscription Management uses the order item’s billing day of month to calculate the order item’s next billing date, which the billing schedule then inherits. For example, an order item can be billed on the first day of the month.

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 55.0

  • Description:

    The contact related to the billing schedule group.

    This field can’t be modified when related billing schedules are in processing.

    This field is a relationship field.

  • Relationship name: BillToContact

  • Relationship type: relationship

  • Refers to: Contact

  • Type: reference

  • Properties: Create, Filter, Group, Sort, Update

  • Description:

    The Salesforce account for the billing schedule group.

    This field is a relationship field.

  • Relationship name: BillingAccount

  • Relationship type: relationship

  • Refers to: Account

  • Type: address
  • Properties: Filter, Nillable
  • Introduced: API version 54.0
  • Description: The compound form of the billing address. Read-only. See Address Compound Fields for details on compound address fields.
  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 66.0

  • Relationship name: BillingArrangement

  • Relationship type: relationship

  • Refers to: BillingArrangement

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Details for the billing address of this billing schedule group. Maximum size is 40 characters.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Details for the billing address of this billing schedule group. Maximum size is 80 characters.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: Accuracy level of the geocode for the billing address. See Compound Field Considerations and Limitations for details on geolocation compound fields.
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Used with BillingLongitude to specify the precise geolocation of a billing address. Acceptable values are numbers between –90 and 90 with up to 15 decimal places. See Compound Field Considerations and Limitations for details on geolocation compound fields.
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Used with BillingLatitude to specify the precise geolocation of a billing address. Acceptable values are numbers between –180 and 180 with up to 15 decimal places. See Compound Field Considerations and Limitations for details on geolocation compound fields.
  • Type: picklist
  • Properties: Create, Filter, Group, Restricted picklist, Sort
  • Description: Shows the type of billing used for the source item.
  • Possible values:
    • Evergreen — Evergreen
    • OrderAmount — OrderAmount
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Details for the billing address of this billing schedule group. Maximum size is 20 characters.
  • Type: date
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 63.0
  • Type: string
  • Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort
  • Description: System-generated reference number for the billing schedule group.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Introduced: API version 58.0
  • Description: Read-only field used with annual billing. The field shows the numbers from 1 to 12, which indicate the month when billing begins for an annual subscription. For example, if billing starts in January, the value is 1; if billing starts in June, the value is 6.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Details for the billing address of this billing schedule group. Maximum size is 80 characters.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: textarea
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Street address for the billing address of this billing schedule group.
  • Type: date
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 63.0
  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Description: Used with BillingTermUnit to define a billing cycle. For example, bill every 20 days or every two months. In this example, the BillingTerm is 20 and the BillingTermUnit is days
  • Type: picklist

  • Properties: Create, Filter, Group, Restricted picklist, Sort

  • Description:

    The frequency with which the billing schedule is invoiced.

    Used with BillingTermUnit to define a billing cycle.

  • Possible values:

    • Day — Day
    • Month — Month
    • OneTime — OneTime
    • Quarter — Quarter
    • Semi-Annual — Semi-Annual
    • Year — Year
  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 61.0

  • Relationship name: BillingTreatment

  • Relationship type: relationship

  • Refers to: BillingTreatment

  • Type: picklist
  • Properties: Create, Filter, Group, Restricted picklist, Sort
  • Description: Inherited from the shared value of each billing schedule in the billing schedule group. Defines when Subscription Management bills a product or service relative to when it’s provided to the customer. Advance billing invoices a product or service before you provide it, while arrears billing invoices a product or service after you provide it. Subscription Management evaluates the billing type when it calculates an order’s next billing date.
  • Possible values:
    • Advance — Advance — If the billing schedule is billed in advance, Subscription Management evaluates the order’s billing day of month to choose the nearest date on or before the order product’s start date. For example, if a monthly order product’s start date is January 1, and the order’s billing day of month is 15, the next billing date is December 15.
    • Arrears — Arrears — If the billing schedule is billed in arrears, Subscription Management evaluates the order’s billing day of month to choose the nearest date after the order product’s start date. For example, if a monthly order product’s start date is January 1 and the order’s billing day of month is 15, the order product’s next billing date is January 15.
  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 62.0

  • Relationship name: BindingInstance

  • Relationship type: polymorphic

  • Refers to: Account, Asset, BindingObjectCustomExt, Contract, CustomEntityDefinition

  • Type: date
  • Properties: Filter, Group, Nillable, Sort
  • Description: The date that a cancellation was made against the billing schedule. Subscription Management doesn’t invoice billing schedules past their cancellation date.
  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Introduced: API version 65.0
  • Type: picklist

  • Properties: Filter, Group, Restricted picklist, Sort

  • Introduced: API version 55.0

  • Description:

    During the invoicing process, this field determines which date is used when the billing schedule group and billing schedule have a related field with conflicting values.

    For example, when Controller has a value of BillingScheduleGroup, if the billing schedule’s billing day of month is 5 while the billing schedule group’s billing day of month is 10, the invoice is sent on the 10th day of the month.

  • Possible values:

    • BillingScheduleGroup — BillingScheduleGroup — The date on the billing schedule group controls.
  • Type: date

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 55.0

  • Description:

    The earliest NextBillingDate from all billing schedules in the billing schedule group. This field is a reference field that isn’t used for any features or calculations.

    This field is a calculated field.

  • Type: date
  • Properties: Filter, Group, Nillable, Sort
  • Description: The latest end date from all billing schedules in the billing schedule group.
  • Type: string
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 63.0
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 64.0
  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 61.0

  • Relationship name: LegalEntity

  • Relationship type: relationship

  • Refers to: LegalEntity

  • Type: date
  • Properties: Filter, Group, Nillable, Sort, Update
  • Introduced: API version 63.0
  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 55.0

  • Description:

    The ID of the payment term used in this billing schedule group.

    This field can’t be modified when related billing schedules are in processing.

    This field is a relationship field.

  • Relationship name: PaymentTerm

  • Relationship type: relationship

  • Refers to: PaymentTerm

  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Description: Inherited from the order item’s parent quote line item or sales transaction item. The period boundary helps determine the start and end date of the billing periods.
  • Possible values:
    • AlignToCalendar — AlignToCalendar — the period starts on the first day of the term unit; for example, the first day of the month.
    • Anniversary — Anniversary — The start date determines the boundary. For example, if a monthly subscription starts on September 13, the subscription starts on the 13th day of each month.
    • DayOfPeriod — DayOfPeriod — the period starts on the day indicated by PeriodBoundaryDay.
    • EndOfPeriod — EndOfPeriod — the period starts on the last day of the pricing term unit.
  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort

  • Description:

    The ID of the product for the order item represented by each billing schedule in the billing schedule group.

    This field is a relationship field.

  • Relationship name: Product2

  • Relationship type: relationship

  • Refers to: Product2

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort
  • Introduced: API version 54.0
  • Description: The name of the product for the order item represented by each billing schedule in the billing schedule group.
  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    Refers to the proration policy that applies to this billing schedule group. The proration policy defines how time periods are calculated for subscription orders. For example, whether partial periods are allowed.

    Inherited from the shared proration policy for each billing schedule in the billing schedule group.

    This field is a relationship field.

  • Relationship name: ProrationPolicy

  • Relationship type: relationship

  • Refers to: ProrationPolicy

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    The asset used to create the billing schedules in the billing schedule group.

    This field is a relationship field.

  • Relationship name: ReferenceEntity

  • Relationship type: relationship

  • Refers to: Asset

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 64.0

  • Relationship name: ReferenceRecord

  • Relationship type: polymorphic

  • Refers to: Asset, InsurancePolicy

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort, Update

  • Introduced: API version 63.0

  • Relationship name: SavedPaymentMethod

  • Relationship type: relationship

  • Refers to: SavedPaymentMethod

  • Type: address
  • Properties: Filter, Nillable
  • Introduced: API version 64.0
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: textarea
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: address
  • Properties: Filter, Nillable
  • Introduced: API version 54.0
  • Description: The compound form of the shipping address. Read-only. See Address Compound Fields for details on compound address fields.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Details for the shipping address for this billing schedule group. City maximum size is 40 characters
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Details for the shipping address for this billing schedule group. Country maximum size is 80 characters.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: Accuracy level of the geocode for the shipping address. See Compound Field Considerations and Limitations for details on geolocation compound fields.
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Used with ShippingLongitude to specify the precise geolocation of a shipping address. Acceptable values are numbers between –90 and 90 with up to 15 decimal places. See Compound Field Considerations and Limitations for details on geolocation compound fields.
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Used with ShippingLatitude to specify the precise geolocation of an address. Acceptable values are numbers between –180 and 180 with up to 15 decimal places. See Compound Field Considerations and Limitations for details on geolocation compound fields.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Details for the shipping address for this billing schedule group. Postal code maximum size is 20 characters.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Details for the shipping address for this billing schedule group. State maximum size is 80 characters.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: textarea
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The street address of the shipping address for this billing schedule group. Maximum of 255 characters.
  • Type: date
  • Properties: Filter, Group, Nillable, Sort
  • Description: The earliest start date from all billing schedules in the billing schedule group.
  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 61.0

  • Relationship name: TaxTreatment

  • Relationship type: relationship

  • Refers to: TaxTreatment

  • Type: currency

  • Properties: Filter, Nillable, Sort

  • Introduced: API version 55.0

  • Description:

    The amount that has been invoiced for all billing schedules within the billing schedule group.

    This field is a calculated field.

  • Type: currency

  • Properties: Filter, Nillable, Sort

  • Introduced: API version 55.0

  • Description:

    The amount that hasn’t yet been invoiced for all billing schedules within the billing schedule group.

    This field is a calculated field.

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Introduced: API version 66.0

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.