📚 Reports

All Reports

All Reports is a searchable directory of every report BazaarPOS offers, grouped into categories — it is the fastest way to find a specific report by name when you do not remember which menu it lives under.

📍 Menu path: Reports → All Reports

👤 Who uses it: Admin, Owner/Manager with Reports permission

🏷️ Plan tier: advanced+

Overview

The page lists categories — Sales, Inventory, Purchase, GST & Tax (India-only), Accounting, Customer, Employee & Cashier, Restaurant POS, Multi-Store, Audit & Security, and Advanced Analytics — each a collapsible card containing individual report links.

Sales, Inventory, Purchase, GST & Tax, Accounting, Customer, Employee & Cashier, Multi-Store and Audit & Security reports are fully wired — clicking one navigates to the relevant category report page with that specific report pre-selected via a query parameter. Restaurant POS reports and most of Advanced Analytics are not wired up yet and show a "coming soon" toast when clicked; the one exception is Sales Forecasting, which does navigate through to the real Sales Forecast page.

The GST & Tax Reports category only appears for India stores — it is filtered out entirely for stores outside India.

Before You Start

Requires the Advanced plan tier or above and a role with Reports permission — the underlying feature key is reports.
No data is fetched on this page itself; it is purely a directory/router into other report pages, so nothing needs to be "loaded" for it to work.

Step-by-Step Guide

1 Find a specific report by name

Type any keyword into the search bar at the top — e.g. "GST", "profit", "customer", "cashier".
The search matches against the report's label, its description, and its category name, and automatically expands every matching category so results are visible.
Click Clear (next to the search box) to reset the search and collapse back to your previous expand/collapse state.

2 Browse by category

Use Collapse all / Expand all at the top-right to toggle every category card at once.
Click any category's header row to expand or collapse just that one category — this only works when search is not active, since search forces all matching categories open.
Click a specific report link inside a category to open it — wired reports navigate straight to the relevant report page (e.g. Sales Reports, GST & Tax Reports) with that specific report pre-selected; unwired ones show a "coming soon" toast instead of navigating anywhere.

Every Field & Button, Explained

Field / Button	What it does
`Search bar`	Live-filters every category's report list by label, description, or category name; automatically expands matching categories.
`Collapse all / Expand all`	Toggles every category card's open/closed state at once.
`Category header (e.g. "01 Sales Reports")`	Click to expand/collapse just that category; shows a numbered badge and a count of how many reports it contains.
`Report row`	One clickable line per report, with a short one-line description; wired reports carry an arrow icon that animates on hover to signal they are clickable.
`Coming-soon banner`	The amber notice near the top listing which categories are fully implemented today.

Tips & Best Practices

Use the search bar instead of scrolling — with dozens of individual reports across all categories, searching by keyword is far faster than hunting through collapsed cards.
If a report you click just shows a toast saying "coming soon", it genuinely is not built yet — it is not a bug, and there is no workaround from this page.
Sales Forecasting under Advanced Analytics is the one Analytics item that actually works today; the rest of that category (Demand Prediction, AI Reorder Suggestions, Seasonal Trend Analysis, Customer Retention Analytics) are placeholders for future releases.

Troubleshooting & FAQ

I do not see a GST & Tax Reports category at all.

That category is hidden entirely for stores outside India — it only appears when your store's country is set to India.

Clicking a report does nothing but shows a small popup message.

That report is listed in the catalogue but not yet built; the toast ("… — coming soon") is expected behaviour for unimplemented reports, mostly under Restaurant POS Reports and Advanced Analytics.

The category I want will not collapse when I click it.

While a search term is active, all matching categories are forced open so results stay visible — clear the search box first, then you can expand/collapse individual categories again.

Search returns no results for a term I expect to match.

Search only matches against the report's visible label, its short description text, and its category name — it does not search report content or historical data.

🧑‍💻 Developer Notes

Source component(s):

frontend-app/packages/pos-react-lib/src/pages/DetailedReports.jsx

Feature flag key: reports (requires advanced plan tier or above)

This page makes no API calls itself — it is a static catalogue (the SECTIONS constant) that routes to other report pages via react-router's navigate(), appending a ?r=<routeId> query parameter that the destination page can read to pre-select a specific report. Items without a routeId fall back to a "coming soon" toast instead of navigating.