---
id: JNY-COM-CAT-002
title: An administrator configures audience prices and checks a preview
feature: FEAT-COM-CAT-03
product_area: commerce
module: catalog
revision: 1
status: draft
product_intent: confirmed
implementation_evidence: partially-observed
supersedes: []
source_sha:
  services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
actor: ACT-COM-001
goal: Understand the prices different buyers receive across the configured periods.
capabilities:
  - CAP-COM-CAT-010
  - CAP-COM-CAT-011
  - CAP-COM-CAT-012
  - CAP-COM-CAT-013
screens:
  - '/console/{tenantId}/configuration/orders/pricingAudiences'
  - '/console/{tenantId}/configuration/accounting/products/{productId}/pricing'
steps:
  - 'n': 1
    surface: '/console/{tenantId}/configuration/orders/pricingAudiences'
    action: Inspect built-in ranks and add the Student audience
    capability: CAP-COM-CAT-010
    expected: The audience list includes Student in rank order
    provenance: documented
    source: >-
      services-commerce:docs/milestones/plans/COMM-M1-plan.md#3. How it works
      for the user
  - 'n': 2
    surface: createPricingSchedule
    action: Prepare adjacent Early Bird and Regular periods through the schedule API
    capability: CAP-COM-CAT-011
    expected: The saved periods share the Early Bird end boundary
    provenance: test
    source: >-
      services-commerce:modules/pricing/tests/e2e/pricing-schedules.e2e.spec.js#answers
      200, the id its name suggests, in the tenant of the path, at version 1,
      with the periods in the order given, their ids derived
  - 'n': 3
    surface: '/console/{tenantId}/configuration/accounting/products/{productId}/pricing'
    action: Enter audience prices and choose lowest-price selection
    capability: CAP-COM-CAT-012
    expected: The saved grid includes the required Standard coverage
    provenance: documented
    source: >-
      services-commerce:docs/milestones/plans/COMM-M1-plan.md#3. How it works
      for the user
  - 'n': 4
    surface: '/console/{tenantId}/configuration/accounting/products/{productId}/pricing'
    action: Preview Student pricing before and after the configured boundary
    capability: CAP-COM-CAT-013
    expected: The response explains the selected audience and period
    provenance: documented
    source: >-
      services-commerce:docs/milestones/plans/COMM-M1-plan.md#3. How it works
      for the user
alternates:
  - from_step: 3
    condition: Rank-based audience selection is configured
    path: The first qualifying audience by rank supplies Member pricing
    outcome: Restoring cheapest-price selection restores Student pricing
    provenance: test
    source: >-
      services-commerce:modules/pricing/tests/e2e/product-purchasing-settings.e2e.spec.js#prices
      the same buyer at the member price under rank, Member coming before
      Student members
  - from_step: 2
    condition: Early Bird has already priced a purchase and must run a week longer
    path: Customer customer staff move its end later; Regular starts a week later
    outcome: The original sale retains its earlier period association
    provenance: test
    source: >-
      services-commerce:modules/pricing/tests/e2e/pricing-schedules.e2e.spec.js#extends
      the sold-in Early Bird by a week, Regular starting where it now ends, its
      first sale untouched
failures:
  - from_step: 1
    condition: Staff request audience removal while product price references remain
    path: >-
      The delete fails validation with the count of products; Deactivate is
      offered
    outcome: Student prices stay retained and unused until reactivated
    provenance: test
    source: >-
      services-commerce:modules/pricing/tests/e2e/pricing-audiences.e2e.spec.js#refuses
      the delete 409 audience_in_use with the sentence and the details
  - from_step: 2
    condition: Standalone schedule administration is absent after the ownership decision
    path: An API client prepares the period configuration
    outcome: The grid presents its periods as columns
    provenance: documented
    source: 'services-commerce:docs/debt/pricing-schedules-owned-by-event.md'
rules_in_play:
  - BR-CAP-COM-CAT-010-02
  - BR-CAP-COM-CAT-010-05
  - BR-CAP-COM-CAT-011-02
  - BR-CAP-COM-CAT-011-05
  - BR-CAP-COM-CAT-012-03
  - BR-CAP-COM-CAT-012-08
  - BR-CAP-COM-CAT-013-01
  - BR-CAP-COM-CAT-013-03
  - BR-CAP-COM-CAT-013-11
assertions:
  - id: AS-JNY-COM-CAT-002-01
    statement: Product price references prevent audience deletion but allow deactivation.
    provenance: test
    source: >-
      services-commerce:modules/pricing/tests/e2e/pricing-audiences.e2e.spec.js#still
      deactivates the audience
  - id: AS-JNY-COM-CAT-002-02
    statement: Saving an audience edit returns the console to its revised view.
    provenance: test
    source: >-
      react-console:e2e/mock/commerce-view-edit.mock.spec.ts#open an audience on
      a full-width view, edit it and save back to the view
  - id: AS-JNY-COM-CAT-002-03
    statement: >-
      Current-end adjustment changes later period selection while retaining
      earlier sale history.
    provenance: test
    source: >-
      services-commerce:modules/pricing/tests/e2e/pricing-schedules.e2e.spec.js#still
      reads a sale made before the change in the same period, and now a day
      after the old end in Early Bird too
  - id: AS-JNY-COM-CAT-002-04
    statement: >-
      Changing selection strategy changes the price chosen for the same
      qualifying buyer.
    provenance: test
    source: >-
      services-commerce:modules/pricing/tests/e2e/product-purchasing-settings.e2e.spec.js#prices
      the buyer at the student price again once the selection is put back to
      lowest
  - id: AS-JNY-COM-CAT-002-05
    statement: >-
      Hypothetical audience qualification is identified as an assumption in
      preview.
    provenance: test
    source: >-
      services-commerce:modules/pricing/tests/e2e/price-quote-staff-form.e2e.spec.js#answers
      200 priced at the member cell, the audience marked assumed in the
      provenance, the response saying what it assumed
e2e_policy: required
e2e_reason: >-
  Prices are what buyers pay; the grid, the settings panel and Preview As are
  console-exclusively and their combined effect is the milestone’s central
  walkthrough step.
evidence:
  - 'Pinned service inputs: the COMM-M1 plan walkthrough, pricing tests'
  - >-
    Pinned console inputs: the Pricing Audiences screens and the product Pricing
    page
proved_by: []
---

# An administrator configures audience prices and checks a preview

## Story

The administrator reviews audiences and the product’s existing schedule context before editing its grid. They provide Standard coverage and inspect the selected audience strategy. Preview As lets them explore buyer qualification and dates without creating a sale. The schedule step describes API preparation rather than an available standalone console editor. Changes to an audience or period must retain the history on which earlier sales depend.
