Option Price Catalogs
Option price catalogs pre-calculate the authoritative price for each configurable product choice. Once a catalog is published, Smart Quote and STORE can display option prices immediately without running the configurator every time a user changes a selection.
Catalog administration is initially available to ROOT users. Open ADMIN > Option Price Catalogs.
Why catalogs are useful
A catalog provides a stable commercial answer for each choice while retaining the evidence behind it:
- Salespeople and storefront customers see an immediate option adjustment, such as Included, +$125.00, -$10.00, or Call for price.
- The displayed amount can include both material and assembly/process value without exposing BOM or router details.
- Material cost and process cost remain separately attributed for margin review.
- A product change creates a new calculation revision instead of silently changing published or previously quoted prices.
- FORGE can explain which items, tasks, rules, and mappings contributed to an amount when an authorized user requests the detail.
The same compilation pass calculates cost and price attribution. This keeps the product version, selected choice, source evidence, and calculated amounts consistent.
Relationship to product design versions
An option price catalog is the commercial result of one specific, immutable product design version. The design version answers what the product is—its attributes, choices, rules, item mappings, tasks, and resources. The catalog answers what choices cost and what approved price should be shown for that design in a particular currency, price-list, quantity, and effective-date scope.
Only a released product design should become the source for a publishable catalog. Draft, proposed, validated, and approved designs may be reviewed, but they must not silently change the catalog currently used by salespeople or STORE.
When a successor design version is released:
- The prior published catalog and historical quotes remain unchanged.
- The monitor marks the prior catalog Stale because its design-version ID no longer matches the released design.
- An authorized user calculates a catalog revision from the new immutable design.
- Cost, proposed price, findings, and differences are reviewed.
- The new catalog is published explicitly and supersedes the prior commercial revision.
This creates two related audit trails: product-design revisions explain configuration behavior, while catalog revisions explain commercial amounts. A quote or order retains both identifiers so its configuration and price can be reproduced later.
Monitor products
The product monitor shows every configurable product and its latest catalog information:
- Status — whether the product has been calculated and whether its catalog is usable.
- Revision — the latest catalog calculation revision.
- Currency — the currency used during calculation.
- Calculated — when the latest revision was calculated.
- Published — when the current catalog was published, if applicable.
- Blocking findings — problems that must be resolved before publication.
Common statuses include:
| Status | Meaning | Recommended action |
|---|---|---|
| NeverCalculated | No catalog has been created for the product. | Select Calculate. |
| Ready or Validated | Calculation completed and is ready for review or publication. | Review prices, costs, margins, and findings. |
| Published | The catalog is the current commercial price source for its scope. | Recalculate after relevant product or cost changes. |
| Stale | The product's released design version differs from the version used by the catalog. | Select Recalculate and review the new revision. |
| Blocked or Failed | Calculation or validation found a problem. | Open the catalog, review findings, and correct the product setup. |
Use Refresh to reload the current status from the API.
Calculate or recalculate
Select Calculate when a product has no catalog. FORGE uses the product's canonical/default configuration and the organization's default currency, then evaluates every publishable choice outside the interactive sales workflow.
Select Recalculate when a catalog already exists. Recalculation creates a new revision. It does not rewrite an existing published revision or historical quote/order pricing.
Calculation may take time for a large product because each publishable choice must be evaluated. The action button displays Calculating… and is disabled while the request is running.
Recalculate when any commercially relevant input changes, including:
- the released product design version;
- valid choices or choice mappings;
- material prices or purchasing cost;
- router tasks, times, rates, or assembly requirements;
- pricing rules, markup, rounding, or approved overrides;
- currency, price list, quantity scope, or effective dates.
Review a catalog
Select View to inspect the latest catalog for a product. The summary shows its status, revision, currency, base price, option count, finding count, and product-design version.
The Published choices table separates:
- Material — attributed purchased or manufactured material cost.
- Process — attributed labor, router, or assembly cost.
- Proposed — the price calculated from the product's pricing logic.
- Published — the approved commercial amount presented for the choice.
- Margin — published price less attributed material and process cost.
These internal cost and margin fields are for authorized review. They are not returned as storefront presentation fields and should not appear in the normal salesperson selection flow.
Inspect attribution details
Select a choice's details button to expand its contribution evidence. The drill-down can identify the pricing source, component, rule or item mapping, material amount, process amount, and published contribution.
This information is collapsed by default because most sales users do not need BOM, router, rule, or item-mapping detail. Use it when investigating an unexpected cost, validating a margin, or confirming that assembly work was assigned to the correct choice.
Review findings
The Calculation findings section reports validation and publication issues. Review severity, code, message, affected choice, and resolution status.
Blocking findings must be corrected or explicitly resolved before publication. Typical causes include missing attribution, ambiguous ownership, missing item pricing, price below cost, missing currency, duplicate pricing scope, or a non-deterministic result.
After correcting the product setup, return to the monitor and select Recalculate. Confirm that the finding is gone and that material cost, process cost, proposed price, published price, and margin remain reasonable.
Salesperson and storefront behavior
The normal selling experience uses only the applicable published catalog's base price and signed option adjustments. The browser performs simple addition; it does not derive commercial prices from BOM items or router tasks.
If no applicable published catalog exists, the existing configurator pricing behavior remains available. When catalog pricing is used, FORGE verifies the catalog revision and total before a configuration is added to a quote or order.