---
schema_version: "1"
id: 65c882be078ab6e6f9ad810cb8a789ceebdf50463901eeabcc90e4e412dbd919
title: ExternalPricingKeyValTier
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/industries/penny-perfect-pricing/references/standard-objects/external-pricing-key-val-tier.md
canonical_url: https://developer.salesforce.com/docs/industries/penny-perfect-pricing/references/penny-perfect-pricing-objects/external-pricing-key-val-tier.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 1dea2e01074bea8bcbeac7bcac7abc881d98d0ceaedc94d0c8183289b32c9490
products:
  - Penny Perfect Pricing Developer Guide
  - Industries Developer Documentation
---
# ExternalPricingKeyValTier

Represents a single volume/quantity tier (a threshold and its associated pricing value) within an ExternalPricingKeyValue pricing condition record, used by the Penny Perfect Pricing feature to support tiered/scale pricing. This object is available in API version 68.0 and later.

## Supported Calls

`create()`, `delete()`, `describeLayout()`, `describeSObjects()`, `getDeleted()`, `getUpdated()`, `query()`, `retrieve()`, `undelete()`, `update()`, `upsert()`

## Special Access Rules

Available only in orgs with the Manufacturing Cloud, Automotive Cloud, or Consumer Goods Cloud Penny Perfect Pricing feature enabled.

## Fields

### CurrencyIsoCode

**Type:** picklist

**Properties:** Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update

**Description:** ISO code for the currency of this record. Possible values are: AED (UAE Dirham), USD (U.S. Dollar), and every other active currency ISO code configured for the org. The default value is USD.

### ExternalPricingKeyValueId

**Type:** reference

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

**Description:** The ID of the parent ExternalPricingKeyValue (pricing condition) record this tier belongs to. This field is a relationship field. It's the master in a master-detail relationship.

**Relationship Name:** ExternalPricingKeyValue

**Refers To:** ExternalPricingKeyValue

### FreeProductId

**Type:** reference

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

**Description:** The ID of the Product2 record given for free when this tier's threshold is met (used for free-goods pricing conditions). This field is a relationship field.

**Relationship Name:** FreeProduct

**Refers To:** Product2

### FreeProductUnitofMeasureId

**Type:** reference

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

**Description:** The ID of the UnitOfMeasure record that applies to the free product quantity for this tier. This field is a relationship field.

**Relationship Name:** FreeProductUnitofMeasure

**Refers To:** UnitOfMeasure

### LastReferencedDate

**Type:** dateTime

**Properties:** Filter, Nillable, Sort

**Description:** The timestamp for when the current user last accessed a record related to this tier.

### LastViewedDate

**Type:** dateTime

**Properties:** Filter, Nillable, Sort

**Description:** The timestamp for when the current user last viewed this record.

### Name

**Type:** string

**Properties:** Autonumber, Defaulted on create, Filter, idLookup, Sort

**Description:** An auto-generated name for the tier record.

### PricingValue

**Type:** double

**Properties:** Create, Filter, Sort, Update

**Description:** The price, discount, or surcharge value that applies once this tier's threshold is reached.

### Status

**Type:** picklist

**Properties:** Create, Filter, Group, Nillable, Restricted picklist, Sort, Update

**Description:** The synchronization/lifecycle status of the tier record relative to its source pricing data. Possible values are Deleted, New, and Updated.

### TierThresholdValue

**Type:** double

**Properties:** Create, Filter, Sort, Update

**Description:** The quantity, value, or volume threshold that must be met or exceeded for this tier's pricing to apply.

## Associated Objects

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 and later.

- [ExternalPricingKeyValTierChangeEvent](https://developer.salesforce.com/docs/industries/penny-perfect-pricing/references/associated-objects/change-event.md): Change events are available for the object.
- [ExternalPricingKeyValTierFeed](https://developer.salesforce.com/docs/industries/penny-perfect-pricing/references/associated-objects/feed.md): Feed tracking is available for the object.
- [ExternalPricingKeyValTierHistory](https://developer.salesforce.com/docs/industries/penny-perfect-pricing/references/associated-objects/history.md): History is available for tracked fields of the object.
- [ExternalPricingKeyValTierOwnerSharingRule](https://developer.salesforce.com/docs/industries/penny-perfect-pricing/references/associated-objects/owner-sharing-rule.md): Sharing rules are available for the object.
- [ExternalPricingKeyValTierShare](https://developer.salesforce.com/docs/industries/penny-perfect-pricing/references/associated-objects/share.md): Sharing is available for the object.