Skip to main content

Interface: PriceLevel

Represents a price break level based on quantity.

The PriceLevel interface defines a tiered pricing structure where different quantity ranges have different per-unit prices. This enables volume-based discounting where customers receive better prices when ordering larger quantities.

Price levels create a stepped pricing model that incentivizes larger orders while maintaining proper margins at all volume levels. Each level defines a specific quantity range and the pricing that applies within that range.

Price levels are derived from MarketCostPrice entries, which define price points at specific quantity thresholds. For example, if MarketCostPrice entries exist for quantities 1, 5, and 15, they form price levels with ranges 1-4, 5-14, and 15+.

Example​

// Price levels generated from MarketCostPrice entries
const priceLevels = [
  { quantityMin: 1, quantityMax: 4, price: 99.00, pricePart: 0 },
  { quantityMin: 5, quantityMax: 14, price: 89.00, pricePart: 0 },
  { quantityMin: 15, quantityMax: 9999, price: 79.00, pricePart: 0 }
];

Properties​

discount?​

optional discount: number

Optional discount percentage for this level.

This property provides an alternative way to express the price advantage at this quantity level, as a percentage discount from a reference price. This makes the discount more transparent to customers.

Showing the discount percentage can be more motivating for customers than simply showing the reduced price.

price​

price: number

Per-unit price at this quantity level.

This property defines the price for each unit when ordered in quantities within this level's range. This is the component of the price that multiplies by the quantity.

The per-unit price typically decreases as quantity levels increase, creating the volume discount effect.

pricePart​

pricePart: number

One-time price component that doesn't multiply by quantity.

This property defines a fixed price component that is added once to orders in this quantity range, regardless of the exact quantity. This covers fixed costs that don't scale with quantity.

One-time price components are useful for setup fees, processing costs, or other expenses that occur once per order regardless of size.

quantityMax​

quantityMax: string | number

Maximum quantity for this price level.

This property defines the largest quantity that falls within this price level. Orders with quantities above this maximum will qualify for the next higher price level.

The maximum quantity creates the upper boundary of the range where this price level applies.

quantityMin​

quantityMin: string | number

Minimum quantity for this price level.

This property defines the smallest quantity that qualifies for this price level. Orders with quantities below this minimum will fall into a lower price level.

The minimum quantity creates the lower boundary of the range where this price level applies.