What this is

The retail operations KPI framework: the performance indicators used to measure the health of merchandising, inventory, vendor, and financial operations — and the benchmarks against which performance is evaluated. This is the input specification for the Operations Agent's monitoring and alerting mandate.

Purpose

KPIs provide the signal that separates normal operations from situations requiring intervention. Without a defined KPI framework, every anomaly requires investigation to determine whether it matters. With one, the Operations Agent can automatically classify performance against established thresholds and surface only the exceptions that require human attention. The framework also provides the accountability structure: a buyer who knows that turnover and gross margin are their KPIs behaves differently than one operating without measurement.

Structure

Merchandising and inventory KPIs:

KPI Definition Benchmark target
Inventory turnover Net sales ÷ average inventory at retail Varies by category; fast-moving consumables: 12–26x annual
Weeks of supply On-hand units ÷ average weekly sales rate 4–8 weeks for most categories
In-stock rate % of store-visits where item is available on shelf 95%+ target
Comp-store sales % Sales growth vs. prior year, same-store base Positive; budget-dependent
Gross margin % Gross profit ÷ net sales Category-dependent; 30–50% typical in specialty retail
Initial markup % (Retail − cost) ÷ retail 45–55% for specialty retail before allowances
Markdown rate Markdown $ ÷ gross sales < 10% for well-managed assortments
Sell-through rate Units sold ÷ units received during a period 85%+ for seasonal items at season end
Forecast accuracy (MAPE) Mean Absolute Percentage Error of demand forecast < 20% MAPE for stable SKUs

Vendor performance KPIs:

KPI Definition Benchmark target
Fill rate Units shipped ÷ units ordered 95%+
On-time delivery % deliveries within agreed window 95%+
ASN accuracy % of ASNs matching physical receipt 98%+
EDI compliance % of EDI transactions correct and on-time 98%+
Invoice accuracy % of invoices matching PO without adjustment 95%+
Chargeback resolution time Days from chargeback issue to vendor credit < 30 days
Vendor scorecard composite Weighted average across all compliance dimensions ≥ 85 (on 100-point scale)

Receiving and inventory accuracy KPIs:

KPI Definition Benchmark target
Shrink rate Shrink $ ÷ sales $ < 1.5% for specialty retail
Perpetual inventory accuracy % of items where book on-hand matches physical count within tolerance 95%+
Three-way match rate % of invoices matched without exception on first pass 90%+
Empty shelf rate % of items with phantom inventory (positive book, empty shelf) < 2%
Receiving discrepancy rate % of receipts with a quantity or quality exception < 5%

Financial operations KPIs:

KPI Definition Benchmark target
Discount capture rate % of available early-payment discounts captured 95%+
Invoice processing cycle time Days from invoice receipt to approval 3–5 days
Invoice exception rate % of invoices requiring manual resolution < 5%
Chargeback $ as % of purchases Total chargeback deductions ÷ total purchase value < 2% (high suggests vendor quality issues; very low suggests under-enforcement)
Co-op utilization rate Co-op funds claimed ÷ co-op funds accrued 95%+

Consumers

The Operations Agent is the primary consumer of this framework — it monitors all KPIs at defined intervals, computes trend lines, and triggers alerts when metrics breach thresholds or show sustained negative trajectory. Buyers use KPIs in planning sessions and vendor negotiations. Finance uses KPIs in period-end reporting. The Platform Ops function uses cross-merchant KPI benchmarks to surface insights about how a given merchant compares to peer retailers.

Invariants

Platform (2030)

Agent mandate: Operations Agent IS the KPI monitoring system. This card is the Operations Agent's monitoring specification. Every KPI in this framework is monitored continuously — not at period end, not in a weekly dashboard meeting. Operations Agent computes leading indicators first (in-stock rate, forecast accuracy, ASN compliance) because they predict lagging indicators (gross margin, shrink, turnover) with sufficient lead time to intervene. The Operations Agent's primary output is exception alerts; normal performance generates no noise.

From batch reporting to continuous exception surfacing. Traditional retail KPI monitoring is a reporting function: an analyst pulls a dashboard weekly, operations leadership reviews it in a meeting, decisions are made two weeks after the data was generated. In Canary Go, every KPI in this framework has a defined threshold and a monitoring rule in Operations Agent. When a KPI breaches threshold — or when its trajectory suggests breach within N periods — an alert surfaces to the merchant dashboard immediately. The merchant sees only the exceptions that require human attention. Operations Agent handles the monitoring; merchants handle the decisions.

L402-gated analytics depth. Operations Agent provides two tiers of KPI access. At baseline, all merchants see threshold alerts and current-period KPI values. At Operations Standard tier, merchants access trend analytics, multi-period comparison, and the inter-KPI correlation surface — how declining forecast accuracy is tracking against in-stock rate degradation, or how fill rate decline is leading chargeback rate growth. At Premium tier, cross-merchant benchmarking compares a given merchant's KPIs against anonymized peer performance, converting a 92% in-stock rate from an ambiguous number into "you're 3 points below comparable merchants in your category."

MCP surface. kpi_dashboard(merchant_id) returns current values for all KPIs against their thresholds in a single call. kpi_trend(kpi_name, period) returns the time series with threshold bands. kpi_alerts(merchant_id) returns active threshold breaches sorted by severity. benchmark(kpi_name, merchant_profile) returns anonymized peer benchmarks for context. All calls return structured data optimized for agent consumption — numbers and classification, not narrative.

RaaS. All KPIs derive from receipt events; KPI integrity is a direct function of receipt event completeness and sequencing. A missing or out-of-order receipt event produces a wrong KPI, and wrong KPIs produce wrong decisions. KPI computation must operate on the audited, sequenced receipt record — not raw POS data; monitoring on unaudited data produces values that diverge from financial actuals once sales audit closes. kpi_dashboard(merchant_id) pre-aggregated and Valkey-cached (sub-200ms full dashboard load). kpi_trend(kpi_name, period) from SQL indexed on (merchant_id, kpi_name, period_date) — rolling N-period queries must not full-scan. KPI aggregates are pre-computed views over the receipt event log, not real-time joins. KPI history exportable for investor reporting and period-end financial review.