A tiered usage price book for an item. It holds the Item Consumption Rate tiers that would price metered consumption when subscription usage is invoiced. The entity is not reachable in the shipped product: it is in no app and has no seeded layouts or views, and the usage invoicing routine that reads it is not run by any scheduled job, action or screen. When that routine runs, it looks schedules up by item only. Every schedule for the item is included, active ones first and then the most recently updated, and the tiers of all of them are merged into one ladder sorted by lower bound. The customer, customer group, partner, partner group, billing term, billing term unit and unit of measure fields are stored but are not used in pricing.
Fields
| Field | Label | Type | Required | What it does |
BillingTerm | Billing Term | Number | | A billing period length, counted in the Billing Term Unit. It is stored but not used: it does not affect usage pricing or when a usage invoice is raised, which follow the subscription's own billing dates. |
BillingTermUnit | Billing Term Unit | PickList | | The unit the billing term is counted in. It has no seeded picklist values and, like the billing term, is not used by any process. |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created On | DateAndTime | Yes | |
CustomerAccountGroupId | Customer Account Group | Lookup → AccountGroup | | Meant to limit the schedule to a group of customers. It is stored but not used: usage pricing matches on the item alone. |
CustomerAccountId | Customer Account | Lookup → Account | | Meant to limit the schedule to one customer, but usage pricing matches on the item alone, so the schedule applies to every customer of that item. |
Description | Description | Text | | Free-text notes about the schedule. Not used in pricing. |
Id | Id | Guid | Yes | |
IsActive | Is Active | Boolean | | Orders the schedules but does not filter them. When an item has several schedules, active ones are taken first, but the tiers of inactive schedules are still merged into the same ladder, so clearing this does not take a schedule out of use. To retire a schedule, delete it or remove its item. |
ItemId | Item | Lookup → Item | | The item whose metered usage this schedule prices. It is the only field usage pricing matches on, so every subscription for this item uses the schedule, whatever its customer or partner. A schedule with no item is never used. |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Name | Text | Yes | The schedule's name, shown in lookups and in the tier records that belong to it. |
OwnerId | Owner | Lookup → UserAccount | Yes | |
PartnerAccountGroupId | Partner Account Group | Lookup → AccountGroup | | Meant to limit the schedule to a group of companies. It is stored but not used: usage pricing matches on the item alone. |
PartnerAccountId | Partner Account | Lookup → Account | | The company the schedule belongs to. It is stored but not used: usage pricing matches on the item alone. |
RecordTypeId | Record Type | Guid, hidden | | |
SubscriptionKey | Subscription Key | Guid, hidden | Yes | |
UnitOfMeasure | Unit Of Measure | PickList | | Names the unit the tier bounds are expressed in. It is a label only: no conversion is applied between it and the usage quantity being priced. It has no seeded picklist values. |
UpdatedDateTime | Updated On | DateAndTime | Yes | |
Actions
| Action | Label | Type | What it does |
Clone | Clone | ServerAction (Clone) | Create a copy of this record |