One tier of an Item Consumption Schedule: a band of usage quantity and the price charged inside it. Like its schedule, it is in no app, has no seeded layouts, and is read only by the subscription usage invoicing routine, which no scheduled job, action or screen runs. When that routine prices a usage quantity, it merges the tiers of every schedule for the item, sorts them by lower bound and fills them in turn. Each tier takes as much of the remaining quantity as its width allows. A 'Flat Fee' tier charges its price once if any quantity falls in it; any other tier charges price times quantity. Quantity left over after the last tier is charged at the usage summary's unit price, or the subscription's unit price when that is empty.
Fields
| Field | Label | Type | Required | What it does |
|---|
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created On | DateAndTime | Yes | |
Description | Description | Text | | Free-text notes about the tier. Not used in pricing. |
Id | Id | Guid | Yes | |
ItemConsumptionScheduleId | Item Consumption Schedule | Lookup → ItemConsumptionSchedule | | The schedule this tier belongs to. Tiers of every schedule for the same item are merged into one ladder when usage is priced. |
LowerBound | Lower Bound | Number | | Start of the band, and the key tiers are sorted by (empty counts as 0). Bounds only set each tier's width: quantity fills the tiers one after another, so a gap or overlap between two tiers neither skips nor double-counts any quantity. |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Name | Text | Yes | The tier's name, for example a label for the band such as 0-100 units. |
OwnerId | Owner | Lookup → UserAccount | Yes | |
Price | Price | Decimal | | The tier's charge: added once for the band when the pricing method is Flat Fee, otherwise multiplied by the quantity that falls in the band. Stored to seven decimal places for fine-grained metered rates. |
PricingMethod | Pricing Method | PickList | | Flat Fee (matched without regard to capitals) charges the price once for the band; any other value, including empty, charges price times quantity. There are no seeded picklist values. |
RecordTypeId | Record Type | Guid, hidden | | |
SubscriptionKey | Subscription Key | Guid, hidden | Yes | |
UpdatedDateTime | Updated On | DateAndTime | Yes | |
UpperBound | Upper Bound | Number | | Inclusive end of the band: the tier covers upper minus lower plus one units, so a 0 to 100 tier covers 101 units. Leave it empty on the last tier to make it absorb all remaining usage. |
Actions
| Action | Label | Type | What it does |
|---|
Clone | Clone | ServerAction (Clone) | Create a copy of this record |
