Customers
Use Catalog Display for Shopper Product Browsing
Catalog Display is a customer-facing product browser. It shows item cards, images, categories, current calculated prices, stock status and branch details without giving the shopper cashier controls.
- Menu path
- Customers -> Catalog Display
- Verified from
- Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence
frontend/layouts/sidebar.html Catalog Display link, frontend/customersearch.html, frontend/static/script/js/modules/js/customer_search.js productListFunction viewCustomerViewItem getBranchDetails, items/itemSearchTable, items/getCustomerSearchItemsAjaxList, items/{id} detail modal, branches/{id} branch detail lookup
What Catalog Display Is For
Catalog Display lets shoppers or staff browse products without using the cashier sale screen. It is useful on a customer-facing tablet, showroom monitor or counter screen where the customer can inspect products before staff create the sale.
- It shows product cards rather than sale controls.
- It is read-only for shoppers. It does not replace New Sale.
- It uses item data already stored in the POS catalog.
- It helps customers inspect price and availability before asking staff to bill.
- It is separate from Customer Display: Catalog Display is for browsing products; Customer Display mirrors an active bill.
Open and Browse
- Open Customers -> Catalog Display. In the current POS source this opens customersearch.html.
- Use All Product when the left menu is shown.
- Let the product list load before handing the screen to a shopper.
- Use the product cards to review image, category, name and current customer price.
- Use the page footer controls when the catalog has more products than the current page.
Search, Price Range and Sort
- Open Customers -> Catalog Display.
- Use the product search field to find an item by name.
- Use the price range slider to narrow visible products by customer price.
- Use the sort dropdown for newest, price low to high or price high to low.
- Wait for the list to refresh after changing the range or sort.
- Click the eye or product image when a customer wants more detail.
- Return the search field to blank when staff need the full catalog again.
Understand the Product Card
Each card is calculated from item price, discount and tax settings. If the final price is different from the saved selling price, Catalog Display can show the original as struck-through and the final customer price as the main value.
| Card part | Comes from | Prepare it in |
|---|---|---|
| Product image | Main item image or default image. | Inventory -> Items -> Images. |
| Category | Item category name. | Inventory -> Categories and item setup. |
| Product name | Item name, usually with pack size or unit. | Inventory -> Items. |
| Display price | Selling price, discount and tax calculation. | Item price, discount and tax fields. |
| Details button | items/{id} detail view. | Item description, branch access and stock fields. |
Use the Product Detail Modal
The modal gives more context than the card. In the live demo it shows the product image, category, final price, stock badge, Description tab and Branch tab.
- Use the Description tab to show customer-friendly product details.
- Use the Branch tab when the business has more than one outlet.
- In Stock means the item has available quantity.
- No Stock means staff should not promise immediate pickup without checking.
- If images or descriptions look poor here, fix the item record before using the catalog with customers.
Check Branch Details
The Branch tab is a separate lookup. The product detail modal first lists branch buttons, then the selected branch loads address and contact details.
- Open a product from Catalog Display.
- Click the Branch tab in Product Details.
- Click the branch name, such as Posnic Demo Store.
- Confirm the branch address, phone and email shown under the button.
- If branch information is blank or wrong, fix the branch/outlet record before relying on the catalog with customers.
Price Calculation Rules
Catalog Display calculates the shown customer price from the item selling price, discount and tax fields. The source supports amount discount, percentage discount, inclusive tax and exclusive tax; if the calculated price differs from the saved selling price, the original price can be shown as struck-through.
| Price input | Shown effect | Where to fix it |
|---|---|---|
| Selling price only | Selling price becomes the card price. | Inventory -> Items -> Price fields. |
| Amount discount | Discount amount is removed before final display. | Item discount settings. |
| Percentage discount | Discount percentage is calculated before final display. | Item discount settings. |
| Exclusive tax | Tax is added to the selling/discounted price. | Item tax type and tax rate. |
| Inclusive tax | Tax is backed out and reapplied for display. | Item tax type and tax rate. |
Keep Catalog Data Clean
Catalog Display exposes catalog problems directly to customers, so item maintenance matters.
- Use clear item names with pack size, color, weight or unit when needed.
- Upload real product images for items customers inspect visually.
- Set category names customers understand.
- Check inclusive versus exclusive tax before publishing prices.
- Use SKU and barcode discipline even though the catalog is not the scanner workflow.
Troubleshooting
| Problem | Likely cause | Fix |
|---|---|---|
| Product missing from catalog | Item is not returned by the catalog item endpoint or is outside the active filter. | Clear search/range filters, then check the item record and branch access. |
| Image is generic | Item has the default item.svg image. | Upload a real item image in Inventory -> Items. |
| Price looks wrong | Selling price, discount, tax type or tax rate is wrong. | Correct item pricing and refresh Catalog Display. |
| No branch details | Branch tab was not selected or branch record is incomplete. | Open the Branch tab, click the branch button, then update branch details if blank. |
| Search shows only one item | Autocomplete selection replaced the list with the selected item card. | Clear the search field or reload Catalog Display for the full list. |