Setup & Configuration

The Setup section contains all the configuration pages for your restaurant — business details, printers, tables, void reasons, and tax rules.

Business Settings

Configure your restaurant's identity and operational settings.

Basic Information

Field	Description
Business Name	Restaurant name (appears on receipts and reports)
Telephone	Contact phone number
Physical Address	Street address
P.O. Box Address	Postal address
Email	Business email
Website	Restaurant website URL

Tax Configuration

Field	Description
Tax PIN	Your tax authority PIN — e.g., KRA PIN (Kenya), TIN (Uganda) — required for fiscal receipts
VAT Rate (%)	Value Added Tax rate (Kenya standard: 0.16)
CTL Rate (%)	Catering Levy rate (Kenya: 0.02)
Enable Tax Calculation	Toggle to enable/disable tax on receipts

Printer Settings

Setting	Description
Receipt Footer Message	Custom text printed at the bottom of every receipt. Common uses: M-PESA till number, feedback phone number, promotions
Print Website QR Code	Add a QR code linking to your website on receipts
Print Barcode	Print a barcode on receipts
Split/Merge Kitchen Tickets	Control whether multi-item orders print as one ticket or split by category

Business Options

Option	Description
Enable Credit Accounts	Allow customers to run tabs / unpaid bills

Printers

Manage thermal printers connected to the POS system. Printers connect via TCP/IP over your local network.

Printer List

Column	Description
Name	Friendly name (e.g., "Control", "Kitchen")
Host	Printer's IP address on your network
Port	TCP port (standard: 9100 for ESC/POS)
Type	Receipt (customer-facing) or Kitchen (order tickets)
POS Hosts	Which POS terminals use this printer (e.g., "pos1, pos2, *" for all)
Status	Enabled or Disabled
Actions	Edit or Delete

Adding a Printer

Click + Add Printer and configure:

• Name — descriptive name for identification
• Host — the printer's IP address (e.g., 192.168.1.60)
• Port — TCP port, typically 9100
• Type — choose Receipt for customer receipts or Kitchen for order tickets
• POS Hosts — which POS terminals should use this printer. Use * for all terminals, or list specific hostnames separated by commas

Printer Types

Type	Purpose	Typical Location
Receipt	Customer payment receipts with totals, tax, and footer	Front counter / cashier station
Kitchen	Order tickets with item names, quantities, and table number	Kitchen pass, bar, grill station

Multiple Kitchen Printers

Assign different menu categories to different kitchen printers. For example, drink orders go to the bar printer while food orders go to the main kitchen printer. Configure this via Categories.

Tables

Manage the table layout for your restaurant. Tables are used to associate orders with physical seating locations.

Tables are displayed as a grid of numbered cards. Each table shows its number and internal ID.

Managing Tables

• + Add Table — create a new table with the next available number
• Tables can be searched by number
• Table numbers are used by waiters when placing orders in the POS client

Table Numbering

Use a numbering scheme that matches your physical layout. Some restaurants use zones: 1-20 for indoor, 21-40 for outdoor, 41-50 for VIP. This helps waiters quickly identify tables without looking at a floor plan.

Void Reasons

Define the reasons staff can select when voiding an order. These reasons appear in void reports for analysis.

Reason List

Column	Description
ID	Unique identifier
Name	Reason text shown to staff
Status	Enabled or Disabled
Actions	Edit

Default Reasons

Common void reasons to configure:

Reason	When to Use
Customer Changed Order	Customer requested a different item after printing
Waiter Error	Wrong item entered by the waiter
Cashier Error	Billing mistake by the cashier
Double Order	Same order entered twice by mistake
Out of Stock (Hakuna)	Item unavailable after it was ordered

Click + Add Reason to create custom reasons. Disable reasons you don't need — they won't appear in the void workflow but historical data is preserved.

Tax Rules

Configure tax and surcharge rules applied to receipts. Rules are country-specific and typically configured during installation.

Country Context

The header shows your tax configuration:

• Country — e.g., Kenya (KE)
• Currency — e.g., KES
• Pricing — Inclusive (prices include tax) or Exclusive
• Fiscal — eTIMS (Kenya), URA (Uganda), or None

Rule List

Column	Description
Name	Rule name (e.g., VAT, Catering Levy)
Code	Short code used in calculations (e.g., VAT, CTL, SC, TIP)
Rate	Percentage rate
Priority	Calculation order (lower = applied first)
Categories	Which item categories this rule applies to (standard, exempt)
Inclusive	Whether the rate is already included in the menu price
Enabled	Whether the rule is active
Type	Default (system) or Custom
Actions	Override to customize

Kenya Tax Rules (Default)

Rule	Code	Rate	Inclusive	Description
VAT	VAT	16.00%	Yes	Value Added Tax — mandatory for registered businesses
Catering Levy	CTL	2.00%	Yes	Catering Training Levy — mandatory for food service
Service Charge	SC	10.00%	No	Optional service charge added to bills
Tip	TIP	10.00%	No	Optional tip/gratuity line on bills

How Tax Rules Work

Rules are applied in priority order (lowest number first):

1. Priority 1 rules (VAT, CTL) are applied to the base price
2. Priority 2 rules (Service Charge, Tip) are applied after

Inclusive rules mean the tax is already baked into the menu price — the receipt shows the breakdown but the total doesn't change. Non-inclusive rules add to the total.

Categories control which items the rule applies to:

• Standard — regular menu items (food, drinks)
• Exempt — items exempt from this tax (e.g., some raw produce is VAT-exempt)

Customizing Rules

Click Override on any rule to customize it for your business. Common customizations:

• Enable/disable Service Charge — some restaurants add a 10% service charge, others don't
• Enable/disable Tip line — adds a tip suggestion to the receipt
• Adjust CTL rate — if your business has a different catering levy arrangement
• Add custom surcharges — click + Add Rule for business-specific charges