Catalog

Publish, Test and Remove Items from the Kiosk Catalog

An item reaches a configured kiosk only when it belongs to the resolved branch and license, is not an instant item, and has both Kiosk eligibility and availability enabled. The Item List Kiosk checkbox changes both kiosk flags together.

Menu path
Inventory -> Items -> New -> Standard item -> More, or Inventory -> Items -> Kiosk column
Verified from
Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence

Live demo Inventory -> Items and Add Item -> More audited and captured 2026-09-04, frontend/modules/items_write.html item_ecommerce control, frontend/modules/items.html item list and New menu, frontend/static/script/js/modules/js/items.js shared save fields list kiosk column and updateItemAvailability, api/src/repositories/item.repository.js create isAvailable default updateKioskStatus accessKiosk and accessQr filters, api/src/models/sale.model.js kioskOrderModel server-side item price discount and tax recalculation

Set Kiosk while creating an itemLive Posnic demo captured 2026-09-04. In Add Item, open More and select Kiosk only for products that are ready for customer ordering.
Publish or withdraw existing itemsLive Posnic demo captured 2026-09-04 after configuring a temporary demo Store ID. The Kiosk column appears when the branch has kiosk configuration and provides the fastest visibility control.
Prove the published item with an orderA visible catalog tile is only the first check. Complete a controlled order and reconcile its item, quantity, price, tax and total in Detailed Kiosk Reports.

Understand the Two Kiosk Flags

ActionStored resultWhat the operator should expect
Select Kiosk when saving a new itemecommerce and isAvailable are both set from the Kiosk choice.The item is eligible and initially available to the kiosk after the item save succeeds.
Select the Item List Kiosk checkboxBoth ecommerce and isAvailable become true.The item can enter the configured branch kiosk catalog.
Clear the Item List Kiosk checkboxBoth ecommerce and isAvailable become false.The item is withdrawn from the kiosk without deleting it from the POS catalog.
Change Tracking inventoryThis is a separate item flag.Do not use inventory tracking as a substitute for kiosk visibility control.
Change Sales channelThis is separate from the Kiosk flags in the audited kiosk catalog filter.Set each channel according to its own rollout; do not infer kiosk state from this checkbox.

Check the Item Before Publishing

  • Confirm the active branch; kiosk catalog lookup resolves the branch from its Store ID.
  • Use a normal saved item. Instant or quick-sale items are excluded from the kiosk catalog.
  • Set a customer-readable name, category, selling price, tax type, tax rate and current discount.
  • Add a useful product image and description where the deployed customer channel displays them.
  • Confirm branch access for the item and verify that the item belongs to the same license as the kiosk branch.
  • Decide how the shop will handle zero stock. Current catalog filtering does not itself require a positive available quantity.

Publish a New Item

  1. Open Inventory -> Items and click New -> Standard item.
  2. Complete the Item and Details tabs, including selling price, tax, category and customer-facing content.
  3. Open the More tab and find Channels & extras.
  4. Select Kiosk. Keep Tracking inventory and Negative stock aligned with the shop's stock policy.
  5. Click Save and wait for the item success response.
  6. Return to Item List and confirm the new row has its Kiosk checkbox selected.
  7. Open the customer-facing kiosk for the same Store ID in a fresh session and find the item in its category.

Publish or Remove an Existing Item Quickly

  1. Configure and save a kiosk Store ID for the active branch; otherwise the Item List Kiosk column remains hidden.
  2. Open Inventory -> Items and locate the exact item by name, SKU, category or filter.
  3. Select its Kiosk checkbox to publish it, or clear the checkbox to withdraw it.
  4. Wait for the update request to finish. If an error appears, treat the old state as authoritative and retry after correcting it.
  5. Reload Item List and verify the checkbox retained the intended state.
  6. Refresh the customer-facing kiosk and verify the item appears or disappears as intended.

Verify Customer Price and Tax

The kiosk catalog returns calculated display values, but order submission reads the current item records again and recalculates selling price, discount and tax on the server. A stale customer screen is therefore not proof of the accepted total.

  1. Open a fresh kiosk session and record the displayed base price, discount, tax treatment and final price.
  2. Add a distinctive quantity and review the cart total before payment.
  3. Complete the approved payment path and retain the order or token reference.
  4. Compare the confirmation or printout with the current POS item price and tax settings.
  5. Find the order in Detailed Kiosk Reports and compare item, quantity, discount, tax, payment mode and total.
  6. Resolve every mismatch before publishing the kiosk link or QR code to customers.

Handle Stock and Temporary Unavailability

SituationOperator actionReason
Item is sold outClear the Item List Kiosk checkbox and verify removal in a fresh customer session.The audited kiosk catalog filter checks kiosk flags, not positive stock quantity.
Item will return laterWithdraw it with the Kiosk checkbox rather than deleting the item.Sales history and the reusable POS record remain intact.
Price or tax is changingWithdraw, update and independently review the item, then republish and place a test order.Order submission recalculates from current server-side item data.
Item should remain cashier-onlyLeave Kiosk clear while retaining the normal POS item.Kiosk eligibility is independent of keeping the product in inventory.
Many items must changeUse the approved bulk kiosk control when available, then sample-check both included and excluded products.Bulk completion messages do not replace customer-side verification.

Troubleshooting

SymptomLikely checkCorrective action
Kiosk column is missingThe active branch has no configured kiosk Store ID.Configure the correct branch kiosk account, reload Items and confirm the branch context.
Checkbox is selected but item is absentWrong Store ID, wrong branch access, instant item, stale customer session or failed update.Verify branch and item type, reload Item List, then open a fresh kiosk session.
Item appears in the wrong shopThe customer link resolves another branch or item branch access is broader than intended.Stop rollout, verify Store ID mapping and review item branch access.
Sold-out item is still visibleKiosk eligibility remains enabled; quantity alone is not filtered by the audited catalog query.Clear Kiosk, reload the customer channel and confirm removal.
Customer price differs from expectationDiscount or inclusive/exclusive tax configuration changed or the session is stale.Review the current item, refresh the kiosk and complete a controlled order before reopening sales.
Item disappears after being enabledThe update failed, another operator changed it, or the public demo reset.Reload Item List, review the response and save the intended state again in the correct environment.
Removed item remains in an open cartThe customer session may hold stale catalog or cart data.Do not accept the order until the deployed kiosk behavior is tested; start a fresh session and escalate stale-cart acceptance as a product issue.

Catalog Go-Live Record

  • Branch name, Store ID and tested customer URL or QR route.
  • Included categories and named excluded products.
  • Price, discount, tax and zero-stock checks for representative items.
  • One successful publish and one successful withdrawal observed customer-side.
  • Controlled order ID with receipt or printer and Kiosk Report reconciliation.
  • Named operator responsible for withdrawing sold-out or recalled items.

Related Manual Pages

Settings Kiosk Store ID The Kiosk Account tab stores one 3-6 character alphanumeric Store ID for the current branch. That identifier is used to resolve the branch for kiosk catalog and order requests. Catalog Create Item Use the full Add Item form when the product must be searchable, scannable, stocked, reported and controlled correctly. Catalog SKU and Barcodes Make products scannable by giving each item a clean SKU/barcode setup, then print labels with the right label size and fields. Settings Kiosk Payment The Kiosk Payment tab stores three branch-level switches: customer-detail page visibility, Cash on Delivery, and Razorpay. Razorpay remains disabled until the current branch has a payment gateway key. Settings Kiosk Printers The Kiosk Print tab accepts one or more printer-name rows for the active branch. Names are trimmed and duplicates are removed when saved, but current kiosk and QR catalog responses expose only the first saved name as printer_name. Reports KOT and Kiosk Reports KOT and Kiosk reports are channel reports. They help restaurant and self-order operators separate table activity, kitchen tickets, cancellations, discounts and kiosk totals from normal counter sales.