Why Received quantities may have changed
Luminous recently updated how the Received quantity is calculated on every purchase order line. If you notice a number that looks different from before, this article explains why and what the new figure represents.
What changed
Previously, Luminous read the Received figure from a stored running total on each PO line. That total was updated by several different processes and could fall out of sync — most commonly showing 0 on a line that had one or more completed receiving reports behind it.
Now, Luminous sums the Received quantity directly from the individual receiving-report lines linked to each PO line. Because each receipt line records the unit it was received in and stores the quantity already converted to the base unit, the total is reliable regardless of how the goods were entered.
When will I see a different number?
| Situation | Old behavior | New behavior |
|---|---|---|
| Receipts exist but the running total was never updated | Showed 0 or an outdated figure | Shows the correct received total |
| All receipts for a line were voided | May have retained a non-zero figure | Shows 0 (voided receipts no longer count) |
| No receipts have been posted | Shows the stored total (may be non-zero from legacy data) | Shows the stored total (unchanged — fallback is preserved) |
What about lines with no receipts at all?
For PO lines that have never had a receiving report, Luminous falls back to the stored value rather than replacing it with zero. This protects historical data on lines that may have been received outside the current receiving workflow.
How does this affect Line Status?
The Line Status filter (Partially Received, Fully Received, etc.) and the Received column sort now resolve against the same derived figure the grid displays. If you previously saw lines missing from a 'Partially Received' or 'Fully Received' filter, re-applying the filter will now return the correct results.
External API
The quantity_received field on the External V1 Purchase Order Items API now returns the same receipt-derived total. The field name and unit (base UOM) are unchanged. The legacy alias received_quantity continues to emit the same value.
What should I do?
No action is required. Received figures, line statuses, and sort order now reflect your posted receiving reports automatically. If a line is showing a Received quantity you believe is incorrect, check that the relevant receiving report is posted (not voided or in draft) under Inventory → Receiving.