Reports
Review Products and Selling Value by Category
Category Based Product is a catalog-composition report. Products is a count of item records and Total Amount sums their stored selling prices; neither value represents stock quantity, inventory cost or realized sales.
- Menu path
- Reports -> Inventory -> Category -> Category Based Product
- Verified from
- Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence
demo.posnic.io Category Based Product summary and Kitchen & Plasticware drill-down captured 2026-09-11, frontend/modules/categoryReport.html Category Based Product tab, frontend/static/script/js/modules/js/report_category.js categoryproductreport and categoryproductdetails, api/src/controllers/items.controller.js categoryItemsReportTable and categoryProductDetails, api/src/services/item.service.js categoryItemsReportTable, api/src/repositories/item.repository.js categoryProductDetails
Run the Product Summary
- Open Category Reports and choose Category Based Product.
- Open Filter and choose the required date range, branches and optional category.
- Apply the filter and review Category Name, Products and Total Amount.
- Move through all result pages; the live demo contains more categories than the first five rows.
- Select a category name to open its product-history drawer.
Interpret the Summary Correctly
| Value | What it shows | What it does not show |
|---|---|---|
| Category Name | Category attached to the returned item records. | It does not guarantee every active item is categorized. |
| Products | Count of item records in the category and report scope. | It is not available quantity, purchased units or units sold. |
| Total Amount | Sum of stored selling_price values for those item records. | It is not inventory valuation, expected revenue or sales received. |
| Date filter | Scope passed to the report endpoints. | Do not assume it behaves like a stock-at-date snapshot. |
| Branch filter | One or more selected shop branches. | It does not merge branch-specific catalog differences into one item. |
Use the Product-History Drawer
- Select the linked category name.
- Confirm Total Selling Amount and Total Products against the summary row.
- Review product Name, Date and Selling Amount.
- Move through every detail page when the category has more than five products.
- Use Export All To CSV inside the drawer when item-level evidence is required.
- Close the drawer and repeat for another category.
Understand Both Exports
- Both CSV actions request all matching rows rather than only the visible page.
- Inspect the generated file before sharing because category names become part of the detail filename.
- Use an inventory cost or quantity report when the question is stock valuation.
| Export | Filename | Fields |
|---|---|---|
| Category summary | category-product-reports | CategoryName, NoofProduct, TotalAmount |
| Selected category detail | <category>-category-based-product-reports | ProductName, Date, Amount |
Troubleshooting
| Problem | Check | Action |
|---|---|---|
| Product is in the wrong category | Category on the item record | Correct the catalog item and rerun the report. |
| Count differs from stock | Products counts records, not units | Use Stock Report for quantities. |
| Total seems too low | Stored selling prices and zero-priced items | Correct the item price; do not substitute purchase cost. |
| Category link opens no rows | Current category id, branch and date scope | Refresh and verify the item-category association. |
| Summary and drawer differ | Filter state and pagination | Reapply one scope and export both datasets for comparison. |