Settings

The Settings screen opens by clicking the Settings button (gear icon) on the main screen. Settings are accessible to all signed-in users regardless of role — but the individual tabs inside are still protected by permissions. On the left is a sidebar with six groups: Company, Finance, Venue, Register, System, and My Account. Clicking an item in the sidebar displays the corresponding content on the right. On narrow screens, the sidebar appears as a slide-out drawer.

Keyboard navigation (Tab) is restricted to the content area — it does not jump into the sidebar.

Company

The Company group brings together settings that apply to the entire organization.

Info

The "Company information" section contains a form with the fields:

• Company name — shown on receipts (e.g. "kasyro manual")
• Business ID and Tax ID
• Address
• Phone and Email

Changes are saved automatically (with a short delay after the last edit).

Below the form is a Business type selector (Hospitality / Retail / Services / Other). When Hospitality is selected, a dropdown with a subtype appears (e.g. "Restaurant"). There is also an App language setting (Czech / English).

Users

A table of all users with the columns: Name, Username, Role, Active. At the top is a "Search..." box, a sort icon, and an + Add button.

Each user is assigned a role (Administrator, Manager, Staff, Helper, etc.) and an active/inactive status (green checkmark). For users with customized permissions, the role displays the suffix "(modified)".

Internal tabs

A table of internal tabs with the columns: Name, User, Active. An + Add button creates a new tab. This item requires the Internal tabs module. For details, see chapter 17.

Finance

The Finance group brings together settings for currencies, margins, discounts, taxes, and payment methods.

General

The general finance settings section contains several cards:

Currencies — selection of the default currency (cannot be changed if any tabs exist or a shift is active) and management of alternative currencies. For each alternative currency you set an exchange rate. While a shift is active, currencies cannot be added or deleted.

Loyalty program — settings for the points earning rate (how many points per amount spent) and the value of a point. This card is visible only when the Customers and Loyalty points modules are enabled.

Margins — target margin settings. This card is visible only when the Margins module (moduleMargins) is enabled. It contains:

• VAT payer — a switch indicating whether the company is a VAT payer (affects margin calculation)
• Default target margin — the percentage value of the default margin (used for categories without their own margin)
• Category target margins — a tree list of active categories where you can enter a custom target margin for each. If a category has no value of its own, it inherits the margin from its parent category (or from the default value). Inherited values are shown in a fainter color. The reset button (restart_alt) next to a category deletes its custom value and restores inheritance.

Discount limits — settings for maximum discounts. A switch to activate limits and fields for the maximum discount per item and the maximum discount per receipt.

Tax rates

A table of tax rates with the columns: Name, Type, Rate (%), Default. An + Add button creates a new rate.

Default rates for the Czech Republic:

• Zero 0% — type No VAT
• Reduced 12% — type Standard
• Base 21% — type Standard — marked as default

The default rate is automatically assigned to new products.

Payment methods

A table of payment methods with the columns: Name, Type, Active. An + Add button creates a new method.

Preset methods:

• Cash (type Cash)
• Card (type Card)
• Transfer (type Transfer)
• Meal vouchers (type Meal vouchers)
• Vouchers (type Vouchers)
• Customer credit (type Credit)

Each method can be activated or deactivated.

Fiscalization

A tab for setting fiscal parameters (electronic sales records, certificates). It is shown only when the Fiscalization module is enabled. In the current version, this feature is not yet implemented.

Venue

The Venue group contains settings for a specific location.

Sections

A table of venue sections with the columns: Name, Color, Active, Default. An + Add button. Requires the Sections module. Sections divide the venue into logical parts (e.g. "Main", "Terrace", "Bar"). Each section is assigned a color for visual distinction.

Tables

A table of tables with the columns: Name, Color, Section (shown only with the Sections module), Capacity, Active. A filter icon, a sort icon, and an + Add button. Each table is assigned a section and an optional capacity (number of seats).

Map

The map editor — a graphical grid for visually arranging tables. Requires the Floor plan module. At the top is a chip with the section name (e.g. "Main"). Tables are dragged to the desired positions on the grid. To set up the map, you must first create tables in the Tables tab.

Registers

A table of registered devices with the columns: Name, Type, This device. Requires the Multiple devices module. The + Add device button opens a dialog for selecting the device type:

• Register — a register device
• KDS — kitchen display (shown only when the KDS module is enabled)
• Customer display — a customer-facing display (requires at least one existing register)

Each device shows its type (e.g. "Register (Stationary)"), assigned payment methods, and a "This device" label if it is the current device.

An information banner at the top warns: "The binding cannot be changed during an active shift."

Register

The Register group contains settings for the specific register you are currently working on. If no device is bound, a notice is shown.

Sales

The "Sales options" section:

• Sales mode — a dropdown with the options "Hospitality" (for restaurants — orders sent to tables) or "Retail" (for shops — scanning products into a cart). The mode affects the look and behavior of the sales screen.

The "Inventory" section (visible only when the Inventory module is enabled):

• Show stock level — toggle; when enabled, the current quantity in stock is shown on product buttons
• Sales when out of stock — dropdown "Allow" / "Warn" / "Block"

The "Grid display" section:

• Grid rows — dropdown for the number of rows in the product grid (3–10)
• Grid columns — dropdown for the number of columns (3–12)

The "Grid layout management" section (requires the settings_register.grid permission):

• Automatic layout — arranges categories and products into the grid automatically
• Manual grid editor — opens an editor for manually assigning items to specific positions

Peripherals

Settings for external devices connected to the register. Five cards are shown in a fixed order:

Thermal printer — printer selection (connection type: system/bluetooth), paper width (58 mm or 80 mm), prep station filter for kitchen tickets.

A4 printer — selection of a system printer for printing reports and documents.

Payment terminal — payment terminal settings. The available types are: Manual terminal, SumUp (mobile devices only), and Comgate (REST API). For Comgate, you enter API keys (merchant ID and secret) — these credentials are stored locally on the device, not on the server.

Scanner — a "Scanner active" toggle and a scanning mode selection. Camera mode is available on all platforms except Linux.

Cash drawer — an "Open on payment" toggle (automatic opening of the drawer after payment is completed), connected via a thermal printer command.

Printing

Automatic printing settings with three toggle switches:

• Automatic order printing — when an order is saved, a kitchen ticket is printed automatically
• Automatic receipt printing — after payment, a receipt is printed automatically
• Automatic shift report printing — when a shift is closed, a Z-report is printed automatically

In addition:

• Receipt logo — option to upload a logo image that is printed on the receipt (the "Select" button, or "Remove" if a logo exists)
• Receipt footer — a text field for custom text in the receipt footer (max 200 characters)

Appearance

Visual customization of the register:

• Theme — choose from: System (follows OS settings) / Light / Dark
• Accent color — a palette of preset colors. The selected color is applied to buttons, active elements, and highlighted text throughout the app.
• Screen layout — choose from: Automatic (default) / Full (desktop) / Compact (mobile). Automatic mode switches based on screen width (680 px threshold). Full shows the cart and panel side by side; compact switches between the cart and the catalog.
• Control size — choose from: Very small / Small / Normal (default) / Large / Very large. Adjusts the size of text, buttons, and other interface elements.

System

The System group brings together settings for modules, security, subscription, email rules, the AI assistant, and the diagnostic log.

Modules

An overview of all modules that can be turned on or off. Modules are organized into four groups:

Venue — Sections, Floor plan, Tab splitting, Reservations, KDS

Finance — Inventory (when disabled, a confirmation dialog appears and stock tracking is deactivated for all products), Advanced catalog, Sale vouchers, Discount vouchers, Internal tabs, Margins

Customers — Customers (parent module), Loyalty points (requires Customers), Customer credit (requires Customers)

System — Multiple devices, Data, Fiscalization, Email rules, AI Assistant

Submodules (dependent on a parent module) are shown grayed out if the parent module is disabled. Disabling a module never deletes data.

Security

Two settings:

• Require PIN when switching staff — toggle (on/off). When enabled, switching users requires entering a PIN.
• Auto-lock after inactivity — dropdown with options (Off, or a time interval of 1–30 min). When a value is set, the register automatically locks after the inactivity period elapses.

Subscription

The Subscription section replaces the former Cloud tab. It contains:

• Current plan — a Free / Premium / Enterprise badge + expiration date (for paid plans). The cloud status is shown according to the plan:
  • Free: "Cloud sync — available in Premium"
  • Premium/Enterprise: "Cloud sync active"
• Email — the signed-in account (read-only). Used for communication about invoices, activation codes, and support.
• Activation code — a field for entering the code + an Activate button. After a successful activation, the status changes immediately and Premium features are unlocked.
• Buy a license at kasyro.com (Free only) — opens www.kasyro.com/pricing in the browser. After payment, an activation code arrives by email.
• Switch to Free (shown only for expired Premium/Enterprise) — permanently switches the company to the Free tier, disables sync, and locks the other devices. The main register's data remains local.
• Notice for Free — the text "Your data is stored only on this device. Use local backups to protect your data." shown only for Free.

Details of the plans and the activation workflow are described in the separate chapter 22. Subscription.

Danger zone

The Danger zone section (requires the settings_company.data_wipe permission) contains two destructive actions:

• Delete local data — deletes data from this device; data on the server is preserved and is downloaded again after signing in.
• Delete everything — deletes all data from this device and from the server. This action is irreversible.

Both actions require confirmation in a dialog.

Emails

Management of automatic email rules. Requires the Email rules module. A table with the columns: Name, Trigger, Content, Email, Active. An + Add button creates a new rule.

AI Assistant

Settings for the optional AI assistant. This item is visible only when the AI module is enabled in the Modules section.

• AI Assistant enabled — toggle to activate/deactivate
• Provider — dropdown for selecting the AI service provider (OpenAI, Google, Anthropic, or Off)
• Model — model selection by provider (or free text)
• Request limit — the maximum number of requests per hour

Log

A diagnostic console showing the application's technical logs. Each line contains a timestamp, a level (DEBUG, INFO, ERROR, WARN), a module (SYNC, AUTH, PAIRING, PERMS, INIT, BROADCAST), and a message. Errors are highlighted in red, warnings in orange.

Buttons in the top right corner:

• Auto-scroll (toggle — highlighted when active)
• Copy to clipboard
• Clear log (requires the settings_company.clear_log permission)
• Export logs — share logs for technical support

For managers and administrators

Module system — overview

Modules let you tailor Kasyro precisely to your needs. Module management is available in System > Modules and requires the settings_company.modules permission (Admin only). Modules are organized into four groups:

Venue (5 modules):

Finance (6 modules):

Customers (3 modules):

System (5 modules):

Submodules (e.g. Loyalty points) are dependent on a parent module (Customers) — if the parent module is disabled, the submodule cannot be enabled. Disabling a module never deletes existing data — the data remains in the database and is available again once the module is re-enabled.

Disabling the Inventory module is a special case — the system shows a confirmation dialog and deactivates stock tracking for all products that have it enabled.

Security — in detail

The security settings (System > Security, settings_company.security permission) affect the entire company and all devices:

Require PIN when switching staff — when enabled, every user switch requires entering a PIN. Recommended for operations with multiple employees so that actions are attributed correctly.

Auto-lock after inactivity — the register locks automatically after a set inactivity period (1, 2, 5, 10, 15, or 30 minutes). Unlocking requires selecting a user and entering a PIN. The "Off" setting disables locking.

The system also includes protection against PIN guessing — progressive lockout after repeated incorrect entries (see chapter 2). The lockout is held in the device's memory and resets when the app is restarted.

Subscription and synchronization

The Subscription section (System > Subscription, settings_company.cloud permission) shows the current plan, lets you enter an activation code, and lets you manage data:

• Current plan — Free / Premium / Enterprise with an expiration date for paid plans.
• Email — the signed-in account (read-only).
• Cloud — sync status. Active for Premium/Enterprise, unavailable for Free.
• Activation code — a field for entering the code. After activation, the plan changes immediately.
• Switch to Free — shown for expired Premium/Enterprise. Permanently switches the company to Free and disables sync.

For details, see chapter 22. Subscription.

Danger zone (requires the settings_company.data_wipe permission):

• Delete local data — removes data only from the current device. Data on the server (Premium/Enterprise) is retained and is downloaded again after signing in. For Free, this action is irreversible (the data is local only).
• Delete everything — removes data from the device and from the server. This action is irreversible. The company will be empty as if launched for the first time. Use only as a last resort.

Both actions require confirmation in a security dialog.

Configuring peripherals

Peripheral settings (Register > Peripherals, settings_register.hardware permission) are specific to each device (register):

Thermal printer — for printing receipts, kitchen tickets, and Z-reports. Supported connection types: system printer, Bluetooth. Settings for paper width (58 mm or 80 mm) and the prep station filter for tickets.

A4 printer — for printing reports and documents on standard paper. Uses the system printer.

Payment terminal — three modes:

• Manual terminal — the staff member confirms the payment manually
• SumUp — integration with the SumUp reader (mobile devices only — Android, iOS)
• Comgate — integration via REST API with credentials (merchant ID and secret). The credentials are stored locally on the device, not on the server.

Scanner — a barcode / QR code reader. Camera mode is available on all platforms except Linux.

Cash drawer — connected via the thermal printer. The "Open on payment" option ensures the drawer opens automatically after every cash payment.

Fiscalization

The Fiscalization tab is visible only when the Fiscalization module is enabled. In the current version it is prepared for the future implementation of electronic sales records (eKasa for Slovakia, EET for the Czech Republic). The feature is not yet active.

Settings permissions overview

All company settings (settings_company.*) are exclusively for the Administrator role. The Manager has access only to venue settings and editing the sales grid. The My Account group (see below) is accessible to all signed-in users without any permission.

My Account

The My Account group is accessible to all signed-in users regardless of role. It contains:

Change PIN

This tab lets the signed-in user change their login PIN. The change is made by entering a new PIN and confirming it.

About

This tab shows information about the app version, the device identifier, and other system details.