Reports
Review Purchases and Their Item-Level Costs
The Purchase report is the operational goods-in register. It answers which completed purchases entered a branch, which supplier supplied them, which item quantities were retained and what those lines cost.
- Menu path
- Reports -> Purchase -> Purchase
- Verified from
- Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence
Live local Posnic Reports -> Purchase -> Purchase audited and captured 2026-09-10, frontend/modules/receivingsReport.html report controls table and plan boundary, frontend/static/script/js/modules/js/report_receivings.js filtering expansion pagination and CSV export, api/src/controllers/receivings.controller.js receivingReportTable permission and response contract, api/src/models/receiving.model.js receivingReportPage date status quantity branch and licence filters
What Enters the Register
The report reads saved receiving documents for the current licence and selected branches. It is designed for stock that actually entered the business, not every draft or supplier conversation.
- The purchase business date must fall inside the selected range; the filter does not use the record's last updated date.
- Open, Cancelled and FullReturn purchases are excluded.
- Received, PartialReturn and compatible completed or imported statuses remain eligible.
- At least one saved item must have item_quantity greater than zero.
- Results are ordered newest purchase date first and paginated independently of the export.
Run the Purchase Report
- Report Read permission is required.
- The Free plan blurs the report panel and disables its item-level CSV export.
- Clear removes the chosen report filters; it does not alter purchase records.
- Open Reports -> Purchase -> Purchase.
- Select the filter icon.
- Choose the purchase date range and one or more branches.
- Select Apply and confirm the displayed filter badges.
- Review every page or increase the rows-per-page control when comparing several purchases.
- Use Refresh after another user receives, edits, returns or cancels a purchase.
Read Each Purchase Row
| Displayed value | Actual meaning | Control check |
|---|---|---|
| Receiving Id | Saved receiving_id such as RID000001. | Match Purchase -> Purchases and the supplier invoice. |
| Date | The purchase business date formatted for the branch. | Use this date when selecting the report range. |
| Supplier | Supplier name retained on the receiving document. | Confirm the correct supplier before reconciling. |
| Phone | Supplier phone retained on the document and exposed as a call link. | A blank value means the purchase carries no usable number. |
| Items | Number of distinct saved item lines, not the sum of their quantities. | Expand the row to see quantity on each line. |
| Total | Saved items_total for the purchase. | Reconcile against item totals and the purchase document. |
Inspect Item-Level Cost
- The expanded table shows every retained item line currently returned with that purchase; it is not separately paginated.
- A missing SKU is source-data evidence. Correct the item record prospectively instead of inventing an identifier in the report.
- Use Purchase -> Purchases for attachments, payment notes, edits, returns, voids and printing. This report is read-only.
- Select the plus control at the beginning of a purchase row.
- Read Item Name and SKU to identify the exact stock record.
- Check Price and Qty against the supplier invoice and physical receipt.
- Review Tax [%]. When tax is inclusive, the report derives the pre-tax price before displaying the calculated tax value.
- Check each line Total and compare the combined lines with the purchase Total.
- Select the minus control to collapse the item table before reviewing the next purchase.
Export the Detailed CSV
The share/export icon inside Purchase Details requests all matching purchases and writes one CSV row per purchase item. It does not export only the visible page.
- The current item export filename is receiving-reports.
- Apply the intended date and branch filters before exporting.
- The top PDF, CSV, Excel and Email toolbar exports the registered report surface; verify the produced document before distributing it.
| CSV field | Source |
|---|---|
| ReceivingId, Date | Receiving document identifier and saved business date. |
| SupplierName, SupplierPhone | Supplier context retained on the purchase. |
| NoOfItems | Number of distinct lines on that purchase, repeated for each exported item row. |
| ItemName, SKU | Saved line description and barcode_id. |
| ItemPrice, ItemQty | Derived pre-tax price when inclusive, otherwise saved item price; plus retained quantity. |
| ItemDiscountAmount, ItemDiscountPercentage | Saved line discount evidence. |
| ItemTax, ItemTotal | Displayed tax percentage/calculated value and saved line total. |
Reconcile Goods In
- Match Receiving Id with the saved purchase and supplier document.
- Compare each expanded item, SKU, quantity, cost, tax and line total.
- Confirm that quantities retained after any PartialReturn agree with physical stock and Inventory Logs.
- Compare the purchase total with the supplier invoice, payment detail and tax reports.
- Record attachments or discrepancies on the source purchase workflow.
- Rerun the same range after a correction and retain the final export required by the business.
Troubleshooting
| Problem | What to check | Action |
|---|---|---|
| Purchase is missing | Purchase business date, selected branch, report permission and receiving status. | Open the source purchase, correct the range or status, then refresh. |
| Draft purchase is missing | Whether its status is Open. | Receive the order only when goods actually arrive; do not change status merely to fill the report. |
| Returned purchase disappeared | Whether it became FullReturn or every retained quantity is zero. | Use Return Purchase and Inventory Logs for the return evidence. |
| Items count looks low | The value counts distinct item lines, not units. | Expand the row and sum Item Qty when unit count is required. |
| Total differs from invoice | Discount, inclusive/exclusive tax, freight, extra charges and saved items_total. | Reconcile the source purchase and invoice mismatch workflow before changing stock. |
| Export is disabled | No matching rows, Free-plan restriction or missing Report Read access. | Check filters and access; do not manufacture a transaction. |
| Receiving Id link does not show more detail | Current report route and expanded item table. | Use the plus control here, then open the matching record from Purchase -> Purchases for full document actions. |
Purchase Register Review Record
- Branch and purchase-date range reviewed.
- Receiving ids and supplier documents matched.
- Item quantities, tax and totals checked.
- Returns and inventory movement reconciled.
- Export filename or retained audit reference.
- Reviewer, review time and unresolved discrepancy owner.