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

Catalog Display listThe live catalog shows product search, price range, sort order, product cards and pagination.
Product details modalOpen a product to review image, customer price, stock status, description and branch tab.
Branch details tabUse the Branch tab and branch button to show which outlet carries or owns the product.
Prepare catalog itemsCatalog Display is only as good as item names, images, descriptions, prices and stock settings.

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

  1. Open Customers -> Catalog Display. In the current POS source this opens customersearch.html.
  2. Use All Product when the left menu is shown.
  3. Let the product list load before handing the screen to a shopper.
  4. Use the product cards to review image, category, name and current customer price.
  5. Use the page footer controls when the catalog has more products than the current page.

Search, Price Range and Sort

  1. Open Customers -> Catalog Display.
  2. Use the product search field to find an item by name.
  3. Use the price range slider to narrow visible products by customer price.
  4. Use the sort dropdown for newest, price low to high or price high to low.
  5. Wait for the list to refresh after changing the range or sort.
  6. Click the eye or product image when a customer wants more detail.
  7. 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 partComes fromPrepare it in
Product imageMain item image or default image.Inventory -> Items -> Images.
CategoryItem category name.Inventory -> Categories and item setup.
Product nameItem name, usually with pack size or unit.Inventory -> Items.
Display priceSelling price, discount and tax calculation.Item price, discount and tax fields.
Details buttonitems/{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.

  1. Open a product from Catalog Display.
  2. Click the Branch tab in Product Details.
  3. Click the branch name, such as Posnic Demo Store.
  4. Confirm the branch address, phone and email shown under the button.
  5. 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 inputShown effectWhere to fix it
Selling price onlySelling price becomes the card price.Inventory -> Items -> Price fields.
Amount discountDiscount amount is removed before final display.Item discount settings.
Percentage discountDiscount percentage is calculated before final display.Item discount settings.
Exclusive taxTax is added to the selling/discounted price.Item tax type and tax rate.
Inclusive taxTax 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

ProblemLikely causeFix
Product missing from catalogItem 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 genericItem has the default item.svg image.Upload a real item image in Inventory -> Items.
Price looks wrongSelling price, discount, tax type or tax rate is wrong.Correct item pricing and refresh Catalog Display.
No branch detailsBranch 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 itemAutocomplete selection replaced the list with the selected item card.Clear the search field or reload Catalog Display for the full list.