No matching settings. Try “printer”, “tip”, “cash”, or “order”.
POS Setup Guide
Set up your station, understand each setting, and see how your choices affect orders, payments, and receipts.
Screenshots show the actual application UI in an isolated local session with demo values. Some conditional settings are enabled to expose their controls. Receipt images are rendered examples from the desktop templates, not photographs or proof of successful physical printing. Screenshots show the top of each section; scroll in the app for additional controls.
Save frequently used settings with the Save button on any setting card. Your saved list stays in this browser when storage is available.
Choose a topic. Each page includes the original explanations and relevant screenshots.
Merchant guide / 01
| Equipment | Configure | Expected route |
|---|---|---|
| Drawer connected to LAN printer | Desktop connection Network; Cash Drawer Printer IP 192.168.1.100; Printing IP blank | Drawer pulse and receipts use that printer. |
| USB trigger plus LAN printer | Desktop connection Serial; actual COM port such as COM3; Printing IP 192.168.1.101 | Drawer uses COM; receipts use the network printer. |
| USB trigger plus USB printer | Serial; actual COM port; Printing IP blank; select Windows Receipt Printer | Drawer uses COM; receipts use the Windows driver. |
| Browser or mobile local printing | Payment Setup printer-server host and SSL port | Print API receives the payload; local server routes physical printers. |
Example IP addresses are placeholders. Use the addresses and ports configured on the customer’s own network.
Merchant guide / 02
| Control | Purpose | Effect |
|---|---|---|
| Save and Close | Validates desktop printer settings and the local printer and offline host addresses, writes station settings to local storage, builds the settings JSON, and calls the staff and general settings-save APIs. | Applies colour variables, updates tip presets and closes Settings. API errors are not surfaced by these save subscriptions, so closing is not proof that the cloud save succeeded. |
| Save Previous Settings | Shows a Sync Settings confirmation. Sync Now calls getPosSetting and loads returned settings into the current screen. | This restores saved settings; it does not upload the current changes. Review the loaded values and use Save and Close to persist them locally. |
| Save and Test buttons | Save the desktop printer settings, then run the named hardware test. | These tests can print paper or open the drawer. They are not previews. |
Station scope. Many values are held in global memory while editing and saved to browser local storage on Save and Close. Backend settings APIs provide a separate saved configuration. Another browser profile, another device or a cleared browser storage area can have different values. Desktop printer settings are also included in settings JSON synchronization.
Conditional visibility. Desktop Printer Setting requires the desktop runtime. Dine In Section requires table-access permission. Terminal Id requires an enabled payment integration. COM Port, Windows Receipt Printer, ID Capture Limit and Inactivity Timeout appear only when their controlling settings are active.
Permission scope. A settings toggle that shows a button does not override manager approval, staff permission, offline restrictions or an order’s eligibility.
Merchant guide / 03
Choose colours with enough contrast for the cashier. Individual button colours and the catalog dark-mode switch are separate controls.
See the affected screen or receipt example.
Colour picker
Choose the app theme color using the colour picker. Applies the primary theme colour used by the app. Save and Close applies the theme variables. This changes appearance only.
App theme
Colour picker
Choose the text color using the colour picker. Applies the secondary text colour used by the theme. Save and Close applies the theme variables. This changes appearance only.
App theme
Colour picker
Choose the send button color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the send text color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the pay button color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the pay text color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the refund button color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the refund text color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the cancel button color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the cancel text color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the tax exempt button color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Stores Tax Exempt Text Color as taxExamptTextColor. The cart template reads taxExemptTextColor instead, so this field may not affect the Tax Exempt button text in this version.
Tax Exempt text colour mismatch
Colour picker
Choose the g card button color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the g card text color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the reward button color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the reward text color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the points button color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the points text color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the no sale button color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Colour picker
Choose the no sale text color using the colour picker. Changes the corresponding action background or text where that colour is bound. Save and Close applies the theme variables. This changes appearance only.
POS action buttons
Toggle
On uses the dark catalog theme; off uses the light variant. Appearance changes do not change orders or prices.
POS catalog appearance
Merchant guide / 04
These switches expose actions or alter action prompts. They do not grant staff permissions; a visible action may still be unavailable to the signed-in employee.
See the affected screen or receipt example.
Toggle
On shows the clock-in control in the POS navigation bar. Off hides that entry point; staff attendance records remain.
POS toolbar
Toggle
On shows the Tax Exempt action in the cart controls. Off hides that action. Despite the label, this is not the global switch that turns every item tax to zero.
Cart Tax Exempt button
Toggle
On exposes the modifier button in product details. Off hides that shortcut; product modifier rules still depend on the menu configuration.
Product details
Toggle
Allows the Force Finalize button on Payment when the order is eligible for force completion. Refunds and other eligibility checks still apply; turning it on does not force-complete an order.
Payment page
Toggle
On shows the Send or hold-order button in the cart. Off hides it. The internal variable ends in disable, but true is used to show this button.
Cart actions
Toggle
On enables the Pay Out entry point. Off removes or disables that feature in the corresponding POS controls. Payout permission still applies.
Payout workflow
Toggle
On enables the normal Pay or Finalize button when the staff member has permission. Off disables that button. Other busy-state and permission guards can still disable it.
Cart Pay button
Toggle
Marks the station for demo or test transactions where the order flow supports that flag. Do not assume this disables all payment-terminal or hardware activity.
Order creation and demo mode
Toggle
On shows the register control for demo mode. Off hides that control; the underlying Demo Mode setting is separate.
POS demo-mode control
Toggle
On shows the transaction-history toolbar button. Off hides that shortcut, not the saved transaction history.
POS toolbar and transaction history
Toggle
On shows the Online Orders button. Off hides the shortcut. Enable Online Orders and automatic printing are separate settings.
POS toolbar
Toggle
On exposes membership actions and associated eligible payment-link controls. Off hides those entries. Business configuration and payment provider support still apply.
Cart membership and payment
Toggle
On shows appointment entry points and appointment history. Off hides those controls. Table or order state can still prevent opening appointments.
POS appointments and customer profile
Toggle
On exposes the item-level Comp control in product details. Off hides it. Approval and permissions can still be required.
Product details
Toggle
On requests a vendor payout reason in the applicable payout or tip-payout flow. Off skips that setting-controlled reason request.
Payout reason prompt
Toggle
On requests ID capture in eligible non-cash checkout flows when the total exceeds ID Capture Limit. It is not an unconditional request for every order.
Payment and authorization
Input
Enter the order-value threshold for ID capture. The code compares total greater than this value. Appears when Verify ID at Checkout is on.
Payment ID capture threshold
Toggle
On opens the Select Print Type or Thank You modal after a successful payment. Off uses the direct completion and regular-print path, with drawer behavior depending on the tender. It does not manage invoice numbers.
Post-payment receipt selection
Toggle
On requests the configured action or reason popup when cancelling an order. Off skips that setting-controlled popup; other approval checks still apply.
Cancel-order action
Toggle
On requests the action or reason popup when deleting an item. Off skips that popup; it does not restore removed items.
Cart delete-item action
Toggle
On requests the action or reason popup for a complimentary item. Off skips that popup; item comp permission still applies.
Item Comp action
Toggle
On requests the action or reason popup for tax exemption. Off skips that popup. The Tax Exempt button must also be accessible.
Tax Exempt action
Toggle
On requests the action or reason popup for a complimentary order. Off skips that popup, without granting permission to comp orders.
Order Comp action
Toggle
On requests the action or reason popup for voiding an order. Off skips that popup; void permissions and order eligibility remain.
Void-order action
Dropdown
Choose tax on subtotal before discount or after discount. The stored values are manufacturer and in_store. This changes the discount-versus-tax calculation order, not item tax eligibility.
Cart discount and tax calculation
Toggle
On adds tax on a positive service charge in the eat-in calculation path. Off skips that extra tax calculation. The current condition is specifically eat-in.
Cart service-charge tax
Dropdown
Select how long the Thank You popup stays visible. Values 5 to 60 are seconds; 2, 5 and 10 minutes correspond to 120, 300 and 600 seconds.
Post-payment Thank You popup
Toggle
Opens a protected developer-mode verification flow when enabled. This is a technical-support setting, not a cashier sales option. The verification result determines whether it remains enabled.
Developer and support controls
Toggle
On enables the customer-facing screen polling and interaction paths. Off stops those setting-controlled customer-screen flows. It does not by itself configure a second display or disable every customer field.
Customer display and customer-app interaction
Merchant guide / 05
These fields rename visible labels. They do not change stored order types, printer routes or business calculations.
See the affected screen or receipt example.
Input
Changes the displayed Kitchen button caption. It does not change which printer receives the job.
POS kitchen action label
Input
Changes the title used for the temporary-ticket or held-order section.
Held-order section title
Input
Changes the complimentary-action caption. It does not change permissions or the comp amount.
Comp action label
Input
Changes the Pickup label shown in order-type and related controls. The stored order type remains pickup.
Order-type labels
Input
Changes the Delivery display label. The underlying delivery workflow remains unchanged.
Order-type labels
Input
Changes the ToGo display label. The underlying order-type value remains unchanged.
Order-type labels
Input
Changes the Send or hold-ticket action text wherever HoldOrderButtonLabel is used.
Cart temporary-ticket action
Input
Changes the Dine In or table display label. It does not create tables or rooms.
Dine-in labels
Input
Changes the product-instructions or product-information action caption.
Product information controls
Input
Changes the visible service-fee caption. It does not change the fee amount or calculation.
Cart service-fee label
Merchant guide / 06
Controls catalog availability and presentation. Menu content, prices and timing data are supplied separately by the business catalog.
See the affected screen or receipt example.
Toggle
On checks configured category timing and availability. Off does not apply this setting-controlled timing check. Availability still depends on the supplied catalog.
POS category availability
Toggle
On shows the manual catalog refresh or sync control. Off hides that control. Automatic login sync is separate.
POS catalog refresh
Toggle
On requests catalog synchronization during login. Off uses the existing catalog until another sync path runs.
Login catalog loading
Dropdown
Priority uses the configured ordering priority; Alphabetic sorts by name. This affects catalog presentation rather than changing product data.
Catalog order
Dropdown
Choose Grid or List for the category display. This affects which layout and related row controls are used.
POS catalog
Dropdown
Choose 3, 4, 5, 6 or 8 product columns. More columns produce narrower product buttons.
POS product grid
Dropdown
Choose the configured product-row count from 2 to 5. This affects product area sizing and paging.
POS product grid
Dropdown
Choose 3, 4, 5, 6 or 8 category columns. This affects category layout width.
POS category grid
Dropdown
Choose 3, 4 or 5 category rows. This affects the category area layout.
POS category grid
Toggle
Changes the quantity-oriented catalog layout. Some compact quantity and category-switch controls are shown only when this is off; it is not simply a master quantity-entry enable switch.
Catalog quantity controls
Toggle
On shows the category section used by the catalog layout. Off hides that section; product data is not removed.
POS category area
Dropdown
Choose Grid or List for extras and modifier selection.
Product extras selection
Dropdown
Choose how many extras appear per row: 3, 4, 5, 6 or 8. This is a layout setting.
Product extras grid
Dropdown
Choose how many extra options appear per row: 3, 4, 5, 6 or 8.
Product option grid
Merchant guide / 07
Controls which order types and associated entry prompts are available. A reopened order can restore its previously saved order type.
See the affected screen or receipt example.
Toggle
On makes Eat In an available order-type choice. Off hides that choice. Dine-in management and table permissions are separate.
Order-type selection
Toggle
On makes Pickup or Takeaway available. Off hides that order-type choice.
Order-type selection
Toggle
On makes ToGo available. Off hides that order-type choice.
Order-type selection
Dropdown
Choose the preferred initial order type from ToGo, Pickup or Dine In. Enable the corresponding order-type option as well; a restored order can bring its own type.
New-order default
Toggle
On enables delivery or phone-order entry points. Off hides those setting-controlled entries. It does not configure a delivery fee.
Delivery order workflow
Toggle
On permits the order-level special-instructions UI. Off hides the setting-controlled entry point. Item instructions have their own controls.
Cart order notes
Toggle
On enables scheduled-order controls. Off hides the schedule entry point. Existing scheduled orders retain their saved data.
Scheduled orders
Toggle
On requests a phone number in the pickup-order flow. Off skips that setting-controlled pickup phone prompt.
Pickup customer details
Merchant guide / 08
Temporary tickets are held or open orders. These controls affect entry points, filters, grouping and completion behavior.
Toggle
On shows the Eat-In filter in held orders when compatible with the dine-in grouping mode. Off hides that filter.
Temporary-ticket filters
Toggle
On shows the Pickup held-order filter. Off hides it; the underlying orders are not deleted.
Temporary-ticket filters
Toggle
On shows the Delivery held-order filter. Off hides it; the underlying orders are not deleted.
Temporary-ticket filters
Toggle
On exposes the temporary-ticket or held-order section. Off hides that entry point.
Held orders
Toggle
On shows the combine or merge control for held orders. Off hides it. Order eligibility still determines whether a merge can proceed.
Held-order merge
Toggle
Allows force-completion treatment for all eligible held orders. The Payment page Force Complete control must also be enabled, and refund guards still apply.
Held orders and payment
Toggle
On groups temporary tickets in the held-order UI. Off uses the ungrouped presentation.
Held-order list
Merchant guide / 09
Controls product-entry, inventory UI, price display and SKU behavior. Display settings do not automatically change the underlying product price.
See the affected screen or receipt example.
Toggle
On exposes the Stock control in product details. Off hides it. It does not automatically alter stock quantities.
Product stock controls
Toggle
On exposes Quick Sale or custom-item entry. Off hides that entry point.
POS custom item
Toggle
On shows item-instruction controls for cart products. Off hides those controls; existing notes remain in order data.
Cart item notes
Dropdown
Choose Popup or In-built custom-product entry for unit-based items. This changes the entry UI rather than product pricing rules.
Custom product entry
Dropdown
Exact Match uses strict SKU matching; Flexible Search uses the flexible lookup path. Use the mode that matches the catalog and scanner workflow.
SKU lookup
Toggle
On shows recorded item add or remove times in cart details and quick-order views. Off hides those timestamps.
Cart and order quick view
Toggle
On shows base-price information in cart product rows. Off uses the normal cart presentation; charged totals are still calculated separately.
Cart product prices
Toggle
On shows card pricing in supported POS price displays. Off hides the extra card-price display. It does not switch payment processors.
POS price display
Toggle
On opens custom-price entry for a selected zero-price item without extras. Off skips this specific prompt. It is separate from Enable Zero Price Popup.
Product selection
Toggle
On shows the catalog calculator area. Off hides it.
POS catalog calculator
Toggle
On allows the zero-price prompt in matching SKU and option-selection paths. This is a separate code path from the zero-price item-without-extras setting.
SKU and product price entry
Merchant guide / 10
Configure this station and its local service addresses. Printer IP Address here means the local print-server host. The actual desktop receipt-printer address belongs in Desktop Printer Setting.
See the affected screen or receipt example.
Input
Enter the configured terminal or register identifier. It appears for enabled payment integrations and is read-only until Edit is selected. Use the provider-configured identifier; this is not an IP address or auth key.
Payment terminal routing
Action
Edit unlocks Terminal Id; Save locks the field again. Use Save and Close to persist the overall settings.
Terminal identifier editing
Input
Enter a descriptive name for this POS station. It is included in relevant order and print payloads.
Station identification and receipts
Input
Enter the local printing-server IP or hostname. Optional http or https is accepted; omit the port and path because SSL Mode selects the port. This is different from the physical printer IP in Desktop Printer Setting.
Local printing APIs
Dropdown
NO-SSL selects port 8080; SSL selects 8081 for the local printing server. The chosen server must actually listen on that protocol and port.
Local printing connection
Input
Enter the local offline-server IP or hostname, without a port or path. Save and Close normalizes the address. Used by local offline APIs.
Offline POS data connection
Dropdown
NO-SSL selects port 6970; SSL selects 6971 for the offline server. It must match the installed local service.
Offline API connection
Input
Enter the scale service base URL, including the protocol, port and trailing slash, for example http://192.168.1.10:6965/. The weight request appends weight_api to this value. This does not configure or calibrate the scale.
Scale integration
Dropdown
Stores the displayed cart-port selection of 6965 or 6966. However, the active getCartPort helper ignores this field and returns 6967 or 6968 based on the printer SSL selection. The scale request uses its full Scale Device IP URL instead. Do not rely on this dropdown alone to reroute either service.
Stored port preference with active routing mismatch
Input
Enter the local System ID expected by the local integration. This is an identifier, not the business login password.
Local system identification
Input
Stores the payment-method percentage fee value. No active consumer of surchargePercentage was found outside settings and initialization in this version; do not rely on it alone to change checkout totals.
Saved setting with no confirmed active pricing effect
Input
Stores the payment-method fixed fee value. No active consumer of surchargeCents was found outside settings and initialization in this version; do not assume this field applies a charge.
Saved setting with no confirmed active pricing effect
Toggle
On enables QR-payment entry points where supported. Off hides or disables them. Payment provider configuration remains necessary.
QR checkout
Toggle
On exposes EBT Cash where the enabled terminal integration supports it. Off hides that tender option.
Payment tender options
Toggle
On exposes EBT Food where supported. Off hides that option. Eligibility and processor behavior remain provider-dependent.
Payment tender options
Toggle
On exposes Debit Card payment where supported. Off hides that tender option.
Payment tender options
Toggle
Enabling requests protected credentials before enabling the local logs state. The additional log UI is implementation-dependent; it is a troubleshooting option rather than a payment setting.
Support and order logs
Toggle
On enables the Manual Payment button in eligible Payment-page states. Off disables it. Manager approval and payout or refund restrictions still apply.
Payment manual request
Merchant guide / 11
These settings control when to print and which workflow to use. Local-server templates decide rendering for server-routed jobs. Direct desktop check formatting has a separate settings section.
See the affected screen or receipt example.
Dropdown
ON enables the configured kitchen-print path; ON After Confirmation requests a choice; OFF disables that setting-controlled path. Separate kitchen buttons, send behavior and auto-order settings also affect printing.
Kitchen-print decision
Input
Sets footer text included in standard print payloads. Actual rendering depends on the receipt template and printer route.
Receipt footer
Toggle
On sends the extras-category-title flag to printing. Off stops that general flag; desktop-specific Extras Category Title can still enable headings.
Receipt extra headings
Toggle
On permits tip information in front/check printing paths. Off selects the non-tip variant where used. Tip charging is separate.
Check receipt selection
Toggle
On selects the tip-enabled variant for finalized regular receipts. Off uses the no-tip check variant in the desktop regular-receipt mapping.
Finalized check receipts
Toggle
On saves or holds the order when Check Print is used. It is mutually exclusive with the confirmation version. Off leaves other print and hold rules in control.
Cart check-to-hold workflow
Toggle
On asks before holding the order on Check Print. Enabling it turns the immediate-save version off.
Cart check-print confirmation
Toggle
On routes Send through the kitchen-print workflow in eligible non-fire orders. Off permits the normal hold behavior without this print trigger.
Cart Send action
Toggle
On retains the cart in supported send/kitchen-to-hold paths instead of clearing it. The actual source action and other hold options determine the result.
Cart after kitchen send
Toggle
On runs the automatic receipt-print path after eligible card payment. Off leaves receipt selection or manual printing to the remaining workflow.
Post-card-payment printing
Toggle
On includes kitchen-print handling for voided orders. Off skips that setting-controlled void ticket.
Kitchen void receipts
Toggle
On shows the Check Print action. Off hides the action; reprints elsewhere can have separate controls.
Cart check button
Toggle
On shows the Kitchen print button. Off hides it. This is separate from automatic online and kiosk kitchen printing.
Cart kitchen button
Toggle
On permits the kitchen-print action from order details. Off hides that entry point.
Order Detail kitchen print
Toggle
On allows the configured printing-error notification. Off suppresses that notification, not the underlying printer error.
Printer-error feedback
Toggle
On exposes K-Reprint. Off hides that shortcut. It does not reprint automatically.
Cart kitchen reprint
Input
Sets the configured number of credit-check copies. Enter a sensible positive whole number; desktop printing validates the supported copy range.
Credit receipt copies
Input
Sets the configured number of cash-check copies. Enter a sensible positive whole number.
Cash receipt copies
Toggle
On enables online-order auto-print handling when online orders are enabled and the polling flow is active. Off stops that online auto-print trigger; kiosk printing has its own switch.
Online-order automatic printing
Dropdown
Dual requests check and kitchen output; Kitchen requests kitchen only; Check Print requests a customer check. It applies to online orders, not the kiosk kitchen-only route.
Online-order receipt route
Toggle
Affects the Day Close Print Report button guard. The actual disabled condition is search_disable AND not Print Report; off therefore does not unconditionally disable every report print.
Day Close Print Report button
Toggle
On requests clock-in and clock-out receipts through the checkPrint event flow. Off skips that setting-controlled receipt request.
Attendance receipts
Merchant guide / 12
This tab appears only when runtime_platform is desktop, immediately after Printer Receipt Setting. Choose the cash-drawer route and the receipt-printer route separately when needed. Direct desktop checks use Template 3 only when online is the Boolean true; otherwise they use Template 1.
See the affected screen or receipt example.
Network defaults: port 9100, drawer pin selector value 0 corresponding to pin 2, paper width 80 mm. The TCP-port, drawer-pin and Receipt Footer Text controls are currently commented out; they cannot be changed through the visible tab. COM Port defaults to COM3. Business at Top defaults on; Bottom, Email, Extras Category Title and Split Amount Suggestions default off. Day or Shift Email defaults on; cash and card detail switches default off.
Dropdown
Select how the desktop app opens the drawer. Network sends the drawer pulse through a LAN or Wi-Fi receipt printer. Serial opens the EOM-BT-100U USB trigger through its Windows COM port. This choice also determines the fallback receipt route when Printing IP is empty.
Desktop drawer and receipt routing
Input
Enter the actual Windows port shown in Device Manager, such as COM3. COM3 is the default, not automatic device detection. Only shown for the USB trigger connection; a COM trigger opens the drawer and does not print paper.
Desktop cash drawer
Input
Enter the receipt printer IP when the drawer plugs into that printer. This is the physical printer address, not the POS local server address. Network mode uses the stored TCP port, normally 9100.
Desktop cash drawer and fallback receipt printer
Action
Saves desktop printer settings and sends a real open-drawer command. Use only with the correct connected drawer. A command-sent message is not physical confirmation that the drawer opened.
Desktop drawer test
Input
Optional separate LAN or Wi-Fi receipt-printer IP. It overrides the drawer printer for receipts. With a COM drawer, supply this IP or select a Windows Receipt Printer. Blank in network mode falls back to Cash Drawer Printer IP.
Desktop checks and other supported receipts
Dropdown
Choose an installed Windows printer. Appears for a COM drawer when Printing IP is empty. The USB trigger itself is not a printer. Printer names come from the desktop app and installed Windows drivers.
Windows receipt printing
Action
Reloads installed Windows printers into the selection list. Requires the desktop bridge; it does not install printer drivers.
Windows printer selection
Toggle
On includes the business email in day-close and shift-close printouts when supplied. Off hides it. This is separate from Check Print Business Email.
Desktop close reports
Toggle
On includes individual cash-order detail rows supplied by the report. Off omits those detail rows; report totals remain. Missing order detail data cannot be created by this setting.
Desktop close reports
Toggle
On allows card-order detail rows. The applicable Hide Credit Card Details setting still overrides it. Off omits individual card-order detail rows.
Desktop close reports
Input
Sets the currency text printed beside monetary values, for example $. It changes receipt formatting, not the account currency or exchange rate.
Desktop check templates 1 and 3
Toggle
On prints business details at the top and turns the Bottom setting off. The default position is top. Test both templates after changing this setting.
Desktop check header
Toggle
On prints business details at the bottom and turns the Top setting off. It relocates business details; it does not duplicate them at both ends.
Desktop check footer
Toggle
On prints the supplied business email in the business-information block. Off omits it. An empty email produces no email line.
Desktop check business details
Toggle
On prints the supplied check or invoice number. Off omits the check-number block. It does not generate a new invoice number.
Desktop check identification
Toggle
On allows customer name, phone and supplied address details. Off hides the customer block. Position also depends on Pickup Delivery Details.
Desktop check customer block
Toggle
On prints paid-status wording where the template and order data support it. Online cash orders may show NOT PAID. It changes the receipt label, not the transaction payment state.
Desktop check payment status
Toggle
On prints template separator rules. Off removes the separators controlled by this flag; it does not change totals.
Desktop check layout
Toggle
On prints item price columns. Off hides item prices; totals still use the order amounts.
Desktop check item rows
Toggle
On prints selected item extras and modifiers. Off omits those rows without removing extras from the actual order or total.
Desktop check item extras
Toggle
On includes extras-category headings when extras are printed. The general Extra Category on Receipt setting can also enable headings, so turn both off to suppress them.
Desktop check extras headings
Toggle
On prints item instructions such as No salt. Off hides those instructions on the check; the stored order is unchanged.
Desktop check instructions
Toggle
Controls the additional cash and card amounts block when the payload supplies it. It does not convert prices or replace payment calculations; Template 1 also uses its dual-pricing layout.
Desktop check payment amounts
Toggle
Controls customer and pickup or delivery information placement. In Template 3, on places the customer block after totals; off places it earlier. Customer Information must also be enabled.
Desktop check customer placement
Toggle
On adds Split 2 Guests, Split 3 Guests and Split 4 Guests suggestions. Off removes those suggestions. Default is off. This does not split the real transaction.
Desktop check suggested split amounts
Toggle
Allows the gratuity amount or suggested-tip total supported by the selected template. It changes printed information, not whether the order is charged a tip.
Desktop check tip information
Toggle
On allows suggested-tip lines in POS Template 1. They can still be suppressed by the receipt type or finalization state. Off hides the suggestions.
POS desktop checks
Toggle
On appends supplied payment-terminal receipt text in Template 1. Off omits it. There must be terminal receipt text in the print payload.
POS desktop terminal receipt
Dropdown
Choose 80 mm or 58 mm to match the installed paper. This controls supported receipt rendering width; the Windows driver must also use the matching paper size.
Desktop receipt layout
Action
Saves the settings and sends a sample No Sale receipt to the selected receipt route. This is a real printer test, not an on-screen preview.
Desktop No Sale receipt
Action
Saves settings and sends a sample check to the configured receipt printer. Use it after changing printer routing or check formatting.
Desktop check test
Merchant guide / 13
Controls item grouping and catalog shortcuts. Some legacy catalog shortcut switches are still saved but their buttons are commented out in the current catalog template.
Dropdown
No Categorization disables both grouping actions. Attributes enables Fire; Manual enables Line. This controls order-item grouping and kitchen-send behavior.
Cart grouping and kitchen firing
Toggle
Stores the Today’s Specials switch. Its visible category shortcut is currently commented out; no active shortcut effect is confirmed in this catalog template.
Stored catalog setting
Toggle
Stores the Happy Hour switch. Its visible category shortcut is currently commented out; no active shortcut effect is confirmed in this catalog template.
Stored catalog setting
Toggle
On exposes main-catalog selection and applies configured super-category selection behavior. Off removes that setting-controlled catalog selector.
Side menu and catalog selection
Toggle
On adds matching selections as separate cart rows. Off permits the normal merge logic when item, extras, instructions and other merge conditions match.
Cart line merging
Merchant guide / 14
Controls report data selection and printed detail visibility. The report API must return the requested data. Desktop card-detail printing also depends on the Desktop Printer Setting detail switches.
See the affected screen or receipt example.
Toggle
On asks the backend to include shift summary data in day-close results. Off omits that request flag. Report visibility also depends on returned data.
Day Close data request
Toggle
Controls whether online orders are requested for store day-close and employee shift-close calculations. The backend must honor the request.
Close-report data
Dropdown
Choose no sales grouping, Super Category, Category, Item or Department. None hides the corresponding grouped-sales section; other choices request and display that grouping.
Day Close sales summary
Dropdown
Choose the equivalent grouping for employee shift-close reports. This is independent of the day-close selection.
Shift Close sales summary
Toggle
On hides card transaction details in day-close print output. On desktop it overrides Close Reports Card Order Details. Off merely allows details when the other print flag and report data permit them.
Day Close printed card details
Toggle
Equivalent hide override for shift-close print output. It is separate from the day-close switch.
Shift Close printed card details
Merchant guide / 15
Online-order retrieval, alerts and ringtone behavior are separate from automatic printing. Auto Print Online Orders and Online Order Print Type are in Printer Receipt Setting.
See the affected screen or receipt example.
Toggle
On shows the legacy pending-online-order alert. Off suppresses that popup. Kiosk notifications use their own popup setting.
Online-order popup
Toggle
On permits online-order polling, list updates and related flows. Off ignores online orders in the shared polling response; kiosk handling can remain enabled independently.
Online order retrieval and list
Toggle
On repeats the online-order ringtone in the existing pending-order flow. Off uses the non-continuous behavior. This is not the kiosk ringing switch.
Online-order sound
Merchant guide / 16
Kiosk kitchen printing uses businessAppsOrders.kiosk_order and accepts only status ACCEPTED. Ringing and popup behavior use validateClockIn.kiosk_orders, a count. Kiosk orders are excluded from the online-order list and legacy online popup.
See the affected screen or receipt example.
Toggle
Master switch for kiosk handling. On permits accepted kiosk-order processing and count-based notification handling. Off ignores kiosk orders for these flows. Default is off.
Kiosk processing
Toggle
On rings when validateClockIn reports a kiosk_orders count greater than the previous valid count. The first count establishes a baseline without ringing. Enable Kiosk Orders is also required.
Kiosk notification sound
Toggle
On sends ACCEPTED kiosk orders from businessAppsOrders.kiosk_order to kitchen printing only. Off skips kiosk printing. Online receipt type does not change kiosk tickets.
Kiosk kitchen printing
Toggle
On permits the new-kiosk-order popup when the count increases. Off suppresses that popup. The shared notification list can still show the kiosk count summary; selecting it opens transactions.
Kiosk popup and notification list
Merchant guide / 17
This section is available only with table-access permission. Tables and rooms must already exist; these controls select how the POS uses them.
Toggle
On enables dine-in or table-management entry points. Off hides the setting-controlled entry. The entire settings section also requires table-access permission.
Table management
Toggle
Combines dine-in and eat-in behavior in table selection and held-order filtering. It can hide the separate Eat-In held-order segment and trigger table selection for eat-in orders.
Table selection and held orders
Dropdown
Direct opens the dine-in page; Alert uses the table alert; None skips the normal setting-driven prompt. The combined dine-in/eat-in mode can still trigger table selection.
Catalog-to-table selection
Toggle
Stores the cash service-charge discount preference, but the matching payment subtraction is commented out in this version. Do not expect it to remove a service charge.
No confirmed active cash-discount effect
Toggle
On permits opening an occupied table order into the cart. Off prevents that action and displays feedback.
Occupied-table action
Merchant guide / 18
Controls tip entry, customer-facing tip flows, guest-count rules and service fees. Tip presets are also reused on the service-charge keypad. Review amounts on a sample order before using new rules.
See the affected screen or receipt example.
Dropdown
Sets the working tip method to a currency amount or percentage. Other automatic or guest-count rules can change the selected method.
Tip entry
Dropdown
Controls the available tip choices: Cash, Percentage or both. It is separate from the current Tip Method.
Tip-entry method options
Toggle
On requests tip entry before eligible credit payment when tip collection is not delegated to the customer app. Off skips that POS-side setting-controlled prompt.
Credit-payment tip prompt
Toggle
On enables the Tip control when the cart is eligible. Off disables it. Automatic tips and an empty cart can still disable manual tip entry.
POS Tip button
Toggle
On sends tip-selection interaction to the customer app. Off uses the POS-side workflow where configured. A functioning customer-screen integration is required.
Customer tip screen
Toggle
On enables the post-credit-payment Thank You tip flow and polling in the print-selection stage. Off skips that feature.
Customer Thank You tip flow
Toggle
Sends the signature-on-tip preference to the customer-app payload. The customer app must implement the signature screen.
Customer app signature
Toggle
On applies a positive automatic tip percentage during cart total calculation. Off stops that automatic rule. Manual tip controls are disabled while this rule is active.
Cart tip calculation
Toggle
On sets a tip when guest count meets or exceeds the configured threshold. Off skips the guest-count rule.
Dine-in tip calculation
Toggle
On asks for guest count in the table-booking flow. Off skips that prompt; guest-count fee rules still need a supplied count.
Dine-in guest-count prompt
Input
Enter the percentage applied when the tip guest-count rule matches, for example 18 for 18 percent.
Guest-count tip rate
Input
Enter the minimum guest count that activates the automatic tip, for example 6.
Guest-count tip threshold
Input
Despite the Amount label, this value is applied as a percentage by the automatic-tip path. Enter 10 for a 10 percent automatic tip.
Automatic tip rate
Input
Sets cash tip preset 1. The cash preset values are also reused by the service-charge keypad.
Tip and service-charge quick buttons
Input
Sets cash tip preset 2. The same preset is also used by the service-charge keypad.
Tip and service-charge quick buttons
Input
Sets cash tip preset 3. The same preset is also used by the service-charge keypad.
Tip and service-charge quick buttons
Input
Sets cash tip preset 4. The same preset is also used by the service-charge keypad.
Tip and service-charge quick buttons
Input
Sets cash tip preset 5. The same preset is also used by the service-charge keypad.
Tip and service-charge quick buttons
Input
Sets cash tip preset 6. The same preset is also used by the service-charge keypad.
Tip and service-charge quick buttons
Input
Sets percentage preset 1. Enter 10 for 10 percent. Percentage presets are also reused by the service-charge keypad.
Tip and service-charge quick buttons
Input
Sets percentage preset 2. Enter a percentage, not a currency amount.
Tip and service-charge quick buttons
Input
Sets percentage preset 3. Enter a percentage, not a currency amount.
Tip and service-charge quick buttons
Input
Sets percentage preset 4. Enter a percentage, not a currency amount.
Tip and service-charge quick buttons
Toggle
On applies the guest-count service-fee rule. Off skips that rule. Item eligibility and other service-fee calculation controls still apply.
Dine-in service-fee calculation
Input
Enter the service-fee percentage used when the guest-count rule matches.
Guest-count service-fee rate
Input
Enter the guest-count threshold for the service fee. In the current rule, zero or an empty threshold also satisfies the threshold condition; use an explicit positive value when needed.
Guest-count service-fee threshold
Toggle
On enables the Service Fee control for a nonempty cart. Off disables manual access to that control. Existing or automatically applied fee data must be considered separately.
POS Service Fee button
Dropdown
Cash means a fixed charge; Percentage means a percentage charge. The current item-level fee logic applies only to eligible items, with a fixed charge per eligible unit.
Service-fee calculation
Toggle
On includes the service fee in the eligible card calculation. Off excludes the setting-controlled card service fee while the cash calculation follows its own rules.
Card service-fee amount
Merchant guide / 19
Separates cash counting, physical drawer opening, cash-entry validation, scanning and cash-discount configuration. A cash-drawer-management toggle is not a printer connection setting.
See the affected screen or receipt example.
Toggle
On invokes cash-drawer counting or management during eligible shift flows. Off skips that management step. This is different from sending an electrical open-drawer pulse. Enabling it turns Day Close drawer management off.
Shift cash reconciliation
Toggle
On prompts for cash-drawer management during day close. Off skips that step. Enabling it turns Shift drawer management off.
Day Close cash reconciliation
Input
Enter the opening cash float in currency units. The cash-drawer screen uses it to calculate net cash relative to the opening amount.
Cash-drawer reconciliation
Toggle
On allows opening the drawer for credit payments in supported completion and print paths. Off prevents that credit-only setting trigger; cash and some split paths may still open it.
Payment cash-drawer behavior
Dropdown
Choose the default transaction search field: Check number, Amount, Order ID, Customer Name or Employee ID. It changes search interpretation, not transaction data.
Transaction History search
Toggle
On enforces the calculated upper cash-entry limit in eligible cash checkout. Off uses a very large maximum. Required-cash and other validation still apply.
Cash received validation
Dropdown
Choose the embedded scale-barcode price digit format shown in the labels. The stored values 6 and 7 are slice positions, not the displayed digit count. Match the barcode format produced by the scale.
Scale barcode decoding
Dropdown
Active enables automatic SKU keyboard scanning on the active POS catalog. InActive disables that listener path. Scanning is paused when the POS is inactive or a modal, alert or popover is open.
Catalog barcode and SKU scanning
Toggle
On requires a valid cash-received amount in eligible cash checkout. Off can default an empty value to the amount due. Refunds, payouts and cash-discount paths have additional rules.
Cash payment validation
Toggle
On continues checkout automatically after a sufficient cash amount is entered through the applicable denomination flow. Off leaves the final action to the cashier.
Cash denomination checkout
Toggle
Stores the debit pricing-adjustment preference. Matching adjustment code is commented out in this version; do not assume it changes debit totals.
No confirmed active debit adjustment
Input
Despite Amount in the label, this value is used as a cash-discount percentage. Enter 3 for 3 percent. Apply Cash Discount and the pricing workflow determine when it is used.
Cash discount calculation
Input
Enter the fixed cash-discount component in cents. The calculation divides it by 100, so 50 means 0.50 in currency units.
Cash discount fixed component
Toggle
On enables the cash-discount calculation paths using the configured percentage and cents. Off uses the normal price path. Check both cash and card totals after changing it.
Item pricing and payment totals
Toggle
On uses the POS catalog SKU retrieval path. Off uses the alternative lookup path. Exact or Flexible SKU Lookup Mode is a separate control.
SKU search source
Merchant guide / 20
External Gift Card belongs to the Payment page. Physical and Virtual actions belong to the cart gift-card workflow. Those paths use different controls and should be tested separately.
See the affected screen or receipt example.
Toggle
On shows External Gift Card on the Payment page. Off hides that tender control. This differs from the cart Physical and Virtual gift-card selection.
Payment gift-card tender
Toggle
Stores the virtual gift-card preference, but the current gift-card action alert does not read this flag. Turning it off alone is not confirmed to hide Virtual.
Stored gift-card setting with no confirmed alert effect
Toggle
Stores the physical gift-card preference, but the current gift-card action alert does not read this flag. Turning it off alone is not confirmed to hide Physical.
Stored gift-card setting with no confirmed alert effect
Dropdown
Manual requests code entry; Scan starts scanning on supported mobile paths; Both offers the available choice. Browser keyboard scanning follows separate focus and listener rules.
Physical gift-card identification
Merchant guide / 21
Controls when the employee session ends or switches. The business login and saved station configuration are separate from employee logout.
Toggle
On logs out after eligible order finalization. Off keeps the staff session. Split-order and other workflow conditions can defer logout.
After-payment session
Toggle
On logs out after eligible Send or hold actions. Off retains the session. Send and Stay and source-specific hold behavior can affect this.
After-send session
Toggle
On combines check-print holding with logout in the applicable cart path. Off skips this setting-controlled behavior.
Check-print hold and session
Toggle
On starts inactivity monitoring on the POS page. Off disables that automatic timeout path.
POS session timeout
Input
Enter inactivity duration in seconds. It is multiplied by 1000 for the timer. Use a positive value; visible when Auto Logout on Inactivity is enabled.
POS inactivity timer
Toggle
On uses the account-switch action from the toolbar. Off uses the normal logout behavior.
POS toolbar account action
Merchant guide / 22
Controls employee selection and attribution. Staff permissions are configured separately and still restrict actions.
Toggle
On requests staff selection for service-category items and exposes associated staff details. Off uses the ordinary service-item flow.
Service item staff assignment
Toggle
Stores the Switch Employee preference. The matching cart condition is commented out; no active setting-driven switch behavior was confirmed. The separate switchStaff method logs out.
Stored employee setting
Toggle
On attaches or uses staff attribution in the relevant order and split-order paths. Off uses their normal staff attribution behavior.
Order staff attribution
Merchant guide / 23
Displays application and desktop version information. Desktop updating requires an available newer version and a functioning desktop update bridge.
App Version, Build Version and Release Date are read-only values. In desktop mode, Desktop Version is the installed EXE version, Available Desktop Version comes from update metadata, and Desktop Update shows update status or an error. The available version is compared with the installed desktop version, not the browser POS display version.
Action
Shown when the desktop app reports an available newer version. Clicking requests the update flow; it is disabled during updates or without an update action. Save settings first. Desktop updates install only after the customer chooses Update.
Desktop application update
Merchant guide / 24
These examples show where settings take effect. Demo values are for orientation and are not a recommended business configuration. In the HTML guide, click an image to enlarge it.
Action Panel, UI Tag, Catalog Configuration and Product Display affect this register screen. Clock In, transaction history, online orders, Send, Pay and Tax Exempt are controlled separately. The blank demo cart is intentional; no sale was created.
Dark Mode off selects the light catalog variant. It does not recolour every application panel. Action button colours and labels are configured separately.
Enable Kiosk Orders plus Show Popup on New Kiosk Order allows this popup when the reported count increases. Ringing is independent. The first count is a baseline. Notification-list kiosk entries open Transaction History.
Left: top business details, email, extras headings and split suggestions enabled. Right: business details moved to the bottom, customer and extras hidden, and split suggestions disabled. The data is the same. These are Template 3 renderer previews.
Template 1 with suggested tips enabled versus disabled. The receipt type, finalization state and supplied payment-terminal text also influence the printed sections. These are renderer previews.
Left: business email and cash/card order details enabled. Right: email hidden and shift-close card details hidden. The Hide Credit Card Details switch overrides the enabled desktop card-detail switch. These are renderer previews.
Merchant guide / 25
| Goal | Required combination | Important limit |
|---|---|---|
| Only online automatic printing | Enable Online Orders on; Auto Print Online Orders on; choose Online Order Print Type; kiosk master off. | Processing also depends on online status and polling guards. |
| Only kiosk kitchen printing | Enable Kiosk Orders on; Print Kiosk Orders in Kitchen on; online master off. | Only ACCEPTED kiosk orders are selected. Online auto-print off does not disable kiosk printing. |
| Both sources | Enable both masters and their separate print switches. | New-order print calls share a per-station queue. Other stations and a server that acknowledges before spooling still need server-side coordination. |
| Kiosk sound without popup | Kiosk master and ringing on; popup off. | Only a count increase triggers sound. A replacement order with unchanged total count cannot be detected from the count alone. |
| Card detail on close report | Desktop Card Order Details on; corresponding day or shift Hide Credit Card Details off. | The report must include card-order rows. |
| Business details at bottom only | Check Business Name at Bottom on. | Top is switched off. These settings affect desktop checks, not every report. |
| Hold on check with confirmation | Save Order on Check Print After Confirmation on. | The immediate hold setting is switched off. Logout and other hold rules may also apply. |
| Cash count by shift | Cash Drawer Management For Shift on. | Day Close management is switched off by this change, and vice versa. |
| Automatic tip | Auto Apply Tip on; positive Tip Amount value. | That value is treated as a percentage. Guest-count rules are separate and should be tested together. |
| Reliable SKU scan | Auto SKU Scanning Active; appropriate lookup mode and source; active POS catalog. | Modal, alert and popover visibility pauses the catalog listener. Gift-card entry is a different workflow. |
Merchant guide / 26
The following differences matter when training staff. A stored preference is not proof that an active workflow reads it.
These are observations of this project version, not recommendations to change the source while performing setup.
Merchant guide / 27
Merchant guide / 28
This reference maps the guide to the current project. Setting descriptions use active consumers where available; externally implemented printer and customer-app behavior is identified as dependent on that service.
| Area | Project file | What it establishes |
|---|---|---|
| Visible settings | src/pages/desktop-printers/desktop-printers.html | Labels, controls, dropdown options, conditions and commented-out fields. |
| Save and restore | src/pages/desktop-printers/desktop-printers.ts | updatePrinterSettings, posSettingJson, setSettingData, desktop validation and mutually exclusive toggles. |
| Defaults and initialization | src/app/globalPos.ts; src/app/app.component.ts | Global values, runtime platform, startup restoration and update metadata. |
| Cart and catalog | src/components/category; src/components/view-cart; src/components/cart-buttons | Visibility, SKU scanning, totals, labels, gift-card actions and print or hold behavior. |
| Payment | src/pages/payment; src/pages/payment-express; src/pages/select-print-type | Tender visibility, cash input, tip prompts and payment completion. |
| Online and kiosk | src/pages/home/home.ts; src/pages/pos/pos.ts; src/pages/pos/pos.html | Polling, kiosk accepted-order filter, count-based notifications and popup UI. |
| Print routing | src/providers/server/serverPos.ts; src/providers/server/server.ts | Local API payloads, desktop bridge routing and new-order queue. |
| Desktop rendering | desktop/check-receipt.js; desktop/check-template-1.js; desktop/day-close-template.js; desktop/day-close.js; desktop/no-sale.js; desktop/cash-drawer.js | Receipt sections, report detail overrides, printer transports and COM drawer validation. |
| Other affected screens | src/pages/hold-orders; src/pages/order-listing; src/pages/tables-booking; src/pages/day-close; src/providers/idle | Held-order filters, search options, table access, close reports and inactivity timer. |
Prepared for the project in /Users/apple/Projects/NFC/pos-nfc. Review date 10 November 2026. No live sale, payment, print job, drawer command or settings-save request was performed to create this guide.
