Skip to main content
Card class: Key Metrics * Category: Margin & Profitability * Chart: gauge

At a glance

SUM(order_details.total_price_tax_excl - product_quantity*original_wholesale_price) / SUM(total_price_tax_excl) for paid-state orders in window.

Calculation

PrestaShop order classification uses the order-state machine: paid = current_state in (2 Payment accepted, 3 Processing, 4 Shipped, 5 Delivered, 9 Backorder paid, 11 Remote payment accepted); shipped/fulfilled = (4, 5); refunded = (7, 15); cancelled = (6); payment error = (8). Read live from the PrestaShop Webservice API and snapshotted nightly into the Nerve Centre KPI store.

Why it matters

Gross Margin % is part of the PrestaShop executive pulse in Vortex IQ Nerve Centre. Vortex Mind investigates automatically when this card breaches its alert band, and Ask Viq can explain the movement in plain English with a citation back to this card.