---
id: CON-COM-CAT-004
name: Price
feature: FEAT-COM-CAT-03
product_area: commerce
module: catalog
revision: 1
status: draft
product_intent: confirmed
implementation_evidence: partially-observed
source_sha:
  services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
definition: >-
  A price is the calculated amount for a buyer, item, currency and instant under
  the customer’s audience, period and purchasing configuration.
owned_by: MOD-COM-CAT
synonyms:
  - Quote (a price asked for without buying)
  - Price grid (the product’s prices by audience and period)
not_to_be_confused_with:
  - 'A promotion, which discounts a price after it is calculated'
  - Tax calculated using the net discounted amount
  - The recorded price input separate from buyer qualification
facets:
  - name: Pricing audience
    meaning: Named qualifying groups have ranks used during price selection.
    used_for: Deciding which price row applies to a purchaser.
  - name: Price schedule and periods
    meaning: Schedules coordinate dated pricing boundaries and preserve used periods.
    used_for: Prices that edit on fixed dates.
  - name: Purchasing settings
    meaning: >-
      Product settings choose selection strategy, priced subject and
      qualification timing.
    used_for: Applying product price selection context.
  - name: Pricing function
    meaning: Registered handlers contribute product-specific adjustments.
    used_for: Running the customer’s registered adjustment logic.
  - name: Public display
    meaning: >-
      Audience display selections make additional prices visible without
      granting eligibility.
    used_for: Presenting audience amounts to visitors.
  - name: Quote
    meaning: >-
      Read-only calculation requests support preview, browsing, composing orders
      and offers.
    used_for: Supporting previews and selling-surface calculations.
relationships:
  - to: CON-COM-CAT-003
    statement: >-
      A price is calculated for a catalog product, and the public may not price
      one that is not for sale in the store.
    provenance: test
    source: >-
      services-commerce:modules/pricing/tests/e2e/price-quote-public-sale.e2e.spec.js#refuses
      a draft product to an anonymous caller: 400 product_not_published, naming
      the store
  - to: CON-COM-CAT-005
    statement: >-
      A promotion discounts the purchaser’s audience price, or the Standard
      price when it does not combine with audience prices.
    provenance: documented
    source: >-
      services-commerce:docs/milestones/decisions/COMM-M1-D12-andrew-2026-10-19.md
  - to: CON-COM-CAT-001
    statement: >-
      A price is calculated in the currency of the sale’s checkout policy,
      converted from the base currency when needed.
    provenance: test
    source: >-
      services-commerce:modules/pricing/tests/unit/engine/step-3-base-price.spec.js#converts
      a calculate cell from the base cell at the rate of the day, rounded half
      away from zero, and freezes the conversion
acted_on_by:
  - CAP-COM-CAT-010
  - CAP-COM-CAT-011
  - CAP-COM-CAT-012
  - CAP-COM-CAT-013
  - CAP-COM-CAT-008
visible_to:
  - ACT-COM-001
  - ACT-COM-003
  - ACT-COM-004
  - ACT-COM-005
  - ACT-COM-006
evidence:
  - >-
    Pinned service inputs: modules/pricing (audiences, schedules, settings,
    extensions, engine, quotes, eligibility, placement), COMM-M1 D1, D4 to D7,
    D10, D14
  - >-
    Pinned console inputs:
    components/commerce/{audiences,pricing,pricing-schedules}/**
supersedes: []
---

# Price

## What It Is

A price answers what this buyer pays for this item in this selling situation. Staff can begin with a familiar Standard amount, but the payable result depends on more than a single label beside a product. The buyer’s audiences, applicable period, quantity and configured adjustments contribute to the calculation, and the explanation preserves how the result was reached.

Accounting holds the product’s price rows. Commerce holds audience and purchasing configuration and applies the pricing calculation. The product’s grid lets staff see these inputs together: an audience can have different amounts across periods and currencies, while an Always row provides continuing coverage when a dated cell is absent.

A quote is one way to request the calculated result before buying. The storefront, staff preview and recommendations can also ask for prices in their respective contexts. These requests help people understand likely payment without creating an order. Placement performs its own calculation and qualification checks, so staff must distinguish a useful preview from a commitment to an earlier amount.

## What It Is Not

Price is distinct from a payment, invoice balance or marketing discount. A price schedule organizes dates rather than owning the event that may eventually supply them. Audience qualification concerns pricing eligibility, while permission concerns who may inspect or change configuration. Publicly displaying Member pricing does not qualify every visitor for it.

## How It Is Used

Administrators define audiences and product purchasing choices, edit the grid and inspect Preview As. Staff can explore an assumed audience or date when explaining a potential sale. Buyers use the results appropriate to their own identity. Calculation can refuse a prohibited currency, a missing conversion or a product unavailable for public purchase. Extension warnings explain calculations that continue without optional customer logic.

## Its Facets

**Audiences.** Named qualifying groups have ranks used during price selection.

**Periods.** Schedules coordinate dated pricing boundaries and preserve used periods.

**Purchasing choices.** Product settings choose selection strategy, priced subject and qualification timing.

**Customer functions.** Registered handlers contribute product-specific adjustments.

**Public display.** Audience display selections make additional prices visible without granting eligibility.

**Quotes.** Read-only calculation requests support preview, browsing, composing orders and offers.

## How It Relates

The checkout policy supplies financial context and Accounting supplies base products, price rows and conversion data. Eligibility supplies qualification decisions. Promotions compare permitted discounted outcomes against pricing, while orders retain the selected result when a sale proceeds. Stores contribute their own pricing extension context.

## What It Could Become

The product should settle the transition to owner-managed schedules and complete live membership qualification. It should preserve the distinction between displayed estimates and bound order prices when designing previews, particularly for recommendations whose expiry currently limits response rather than freezing a price.