RatePlanChargeTier
A rate plan charge tier is part of a subscription or an amendment to a subscription, and it comes from a product rate plan charge tier. A rate plan charge tier holds the prices for a rate plan charge. Each rate plan charge has at least one tier associated with it.
Rate plan charge tiers are sometimes called subscription rate plan charge tiers to distinguish them from product rate plan charge tiers. Rate plan charge tiers that are part of an amendment are sometimes called amendment rate plan charge tiers for the same reason. However, the object name is RatePlanChargeTier, not SubscriptionRatePlanChargeTier nor AmendmentRatePlanChargeTier: these latter two names don't exist.
Don't confuse a rate plan charge tier with tiered pricing. Tiered pricing is a charge model in which you create different charges or tiers for different quantities of an item.
Use the RatePlanChargeTier object to represent a tier of charges in a RatePlanCharge object. The RatePlanChargeTier object exists only within a subscription. You can't create a RatePlanChargeTier directly; you create it when you use a subscribe() call to create a new subscription or an amend() call to add a new product to an existing subscription. You can then update the RatePlanChargeTier object to override some of its settings.
Field Descriptions
All field names are case sensitive. Check enumerated values in descriptions to confirm capitalization and spacing. See Field Types for additional information.
| Name | Required? | Allowed Operations | Description |
|---|---|---|---|
| CreatedById | optional | Query | The ID of the Zuora user who created the RatePlanChargeTier object. Type: zns:ID |
| CreatedDate | optional | Query | The date when the RatePlanChargeTier object was created. Type: dateTime |
| EndingUnit | optional | Query | The end number of a range of units for the tier. Type: decimal |
| Id | optional | Query Filter | The ID of this object. Upon creation, the ID of this object is Type: zns:ID |
| IsOveragePrice | optional | Query | Indicates if the price is an overage price. An overage occurs when usage surpasses the last defined tier. This field is applicable only to tier pricing and volume pricing models. Type: boolean |
| Price | optional | Query | The price of the tier if the charge is a flat fee, or the price of each unit in the tier if the change model is tiered pricing. Type: decimal |
| PriceFormat | optional | Create | Indicates if the price is a flat fee or is per unit. Type: string |
| RatePlanChargeId | required | Create | The ID of the subscription or amendment rate plan charge associated with this tier. You can't create an unassociated tier. Type: zns:ID |
| StartingUnit | optional | Query | The start number of a range of units for the tier. Type: decimal |
| Tier | optional | Query | A unique number that identifies the tier that the price applies to. Type: bigint |
| UpdatedById | optional | Query | The ID of the last user to update the object. Type: zns:ID |
| UpdatedDate | optional | Query | The date when the object was last updated. Type: dateTime |
Additional Field Detail
EndingUnit
The end number of a range of units for the tier. For example, if the tier stipulates 101 - 200 minutes, then the value for the EndingUnit field is 200.
This field is required if RatePlanCharge.ChargeModel is Tiered Pricing or Tiered with Overage Pricing. Use this field only for tiered pricing models.
Id
The ID of this object. Every object has a unique identifier that Zuora automatically assigns upon creation. You use this ID later when you work with the object. For example, if you send an amend() call to modify an existing subscription, then you need to include the specific Subscriptionobject's ID with the call.
The ID for the RatePlanChargeTier object is RatePlanChargeTierId
StartingUnit
The start number of a range of units for the tier. For example, if the tier stipulates 101 - 200 minutes, then the value for the StartingUnit field is 101.
This field is required if RatePlanCharge.ChargeModel is Tiered Pricing or Tiered with Overage Pricing. Use this field only for tiered pricing models.