Pricing & Promotions Management (PPM)

PPM — Pricing & Promotions Management

Contract-only documentation for Pricing & Promotions Management (PPM).

Status

• Implementation: implemented (core price resolve, policies, promos, dynamic pricing; ongoing refinement)
• OpenAPI: /ppm/openapi.yaml

Scope

• Org-scoped, facility-aware, and channel-aware where applicable.
• No UI; headless API + eventing only.

Clarifications (B10)

• Price resolution: precedence is base price → overrides → promos → customer tier → channel/facility overrides; rounding rules are policy-defined (see service policies).
• Effective dating: all rules are effective-dated in UTC; caller must supply as_of when resolving historical prices.
• Promotions: stacking rules are policy-controlled; coupons validate against channel + customer eligibility.
• Recommendations: recommendation records carry proposed prices; status transitions control when they become active.
• UOM conversion: conversions use canonical units with defined factors; conversions affect cost/price computations.