Skip to content

Settings & Configuration

Configure your organization, users, permissions, taxes, accounts, numbering, vendors, notifications, and email templates.

Organization Settings

Manage your property's core information under Settings → Organization.

SettingDescription
Organization NameYour hotel or property name (displayed on invoices)
AddressFull address including street, city, state, ZIP, country
PhonePrimary contact number
EmailPrimary contact email
WebsiteProperty website URL
LogoUpload your organization logo (used in invoices, PDFs, emails)
Default Check-in TimeStandard check-in time (e.g., 14:00)
Default Check-out TimeStandard check-out time (e.g., 11:00)
CurrencyDefault currency for billing
Financial Year StartStarting month of your financial year
StateOrganization's state (used for GST intra/inter-state determination)
GSTINOrganization's GST Identification Number

TIP

The organization address and GSTIN are printed on all invoices and are required for GST compliance.

Logo Upload

Upload your logo in PNG, JPG, or SVG format. The logo appears on:

  • Invoice PDFs
  • Email headers (when using templates)
  • The application header

Recommended size: 200×60 pixels or similar aspect ratio.

User Management

Manage users under Settings → Users. The system uses an invite-only model — users cannot self-register.

Inviting a User

  1. Click Invite User
  2. Enter the user's email address
  3. Assign a role (which determines their permissions)
  4. Click Send Invite

The user receives an email with a link to set up their password and access the system.

User Operations

ActionDescription
CreateInvite a new user by email with an assigned role
UpdateChange a user's role, name, or contact details
DeactivateDisable a user's access without deleting their account
ReactivateRestore a deactivated user's access
DeletePermanently remove a user from the organization

WARNING

Deactivated users cannot log in but their historical actions (audit logs, bookings created, etc.) are preserved. Deleting a user is permanent.

User List

The user list shows:

  • Name and email
  • Assigned role
  • Status (active / inactive)
  • Last login date
  • Date joined

Roles & Permissions

The system implements Role-Based Access Control (RBAC) with fine-grained permissions across 19 modules.

Permission Levels

Each module supports five permission levels:

PermissionDescription
ViewRead-only access to the module's data
CreateAbility to create new records
UpdateAbility to edit existing records
DeleteAbility to remove records
ManageFull administrative access to the module

RBAC Modules

Permissions can be configured for each of the following 19 modules:

#ModuleControls
1DashboardAccess to the main dashboard and statistics
2BookingsBooking creation, editing, check-in/out
3RoomsRoom configuration and management
4Room TypesRoom type definitions and pricing
5GuestsGuest profiles and history
6InvoicesInvoice creation, sending, payments
7ExpensesExpense recording and management
8AccountsChart of Accounts and journal entries
9Credit NotesCredit note creation and application
10TaxesTax rate and tax group configuration
11VendorsVendor profiles and management
12ReportsAccess to financial and operational reports
13UsersUser management and invitations
14RolesRole creation and permission assignment
15SettingsOrganization settings modification
16Email TemplatesEmail template management
17SeriesAuto-numbering series configuration
18IntegrationsGmail, Google Sheets, and other integrations
19NotificationsNotification configuration

Creating a Role

  1. Navigate to Settings → Roles
  2. Click New Role
  3. Enter a role name (e.g., "Front Desk", "Accountant", "Manager")
  4. Toggle permissions for each module using the permission matrix
  5. Save the role

Default Roles

The system comes with pre-configured roles:

  • Admin — Full access to all modules
  • Manager — Access to most modules excluding system settings
  • Front Desk — Bookings, guests, and invoices
  • Accountant — Invoices, expenses, accounts, and reports

You can customize these or create additional roles as needed.

Tax Configuration

Configure GST rates and tax groups under Settings → Taxes.

Tax Rates

Define individual tax rates:

FieldDescription
Tax NameDisplay name (e.g., "CGST 6%", "SGST 6%")
Rate (%)Percentage rate
Tax TypeCGST, SGST, IGST, or Cess
DescriptionOptional description

Tax Groups

Tax groups combine multiple individual taxes into a single selectable option:

Example: GST 12%

ComponentRate
CGST6%
SGST6%

Example: GST 18%

ComponentRate
CGST9%
SGST9%

When a tax group is applied to a line item, all component taxes are calculated and displayed individually on invoices.

GST Compliance

The system supports Indian GST compliance features:

  • Automatic CGST+SGST vs. IGST determination based on state
  • HSN/SAC code support on line items
  • Tax-inclusive and tax-exclusive calculations
  • GST-formatted invoice layout

Chart of Accounts

Configure your accounting structure under Settings → Accounts.

Account Types

The system supports a standard hierarchical account structure:

TypeCategoryExamples
AssetBalance SheetCash, Bank, Accounts Receivable
LiabilityBalance SheetAccounts Payable, Credit Card, Loans
EquityBalance SheetOwner's Equity, Retained Earnings
RevenueIncome StatementRoom Revenue, Food & Beverage
ExpenseIncome StatementUtilities, Salaries, Maintenance

Hierarchical Accounts

Accounts are organized in a parent-child hierarchy:

Assets
├── Current Assets
│   ├── Cash on Hand
│   ├── Petty Cash
│   └── Bank Account
├── Accounts Receivable
│   └── Guest Receivables
└── Fixed Assets
    ├── Furniture & Fixtures
    └── Equipment

Creating an Account

  1. Navigate to Settings → Chart of Accounts
  2. Click New Account
  3. Fill in the details:
FieldDescription
Account NameDisplay name
Account CodeUnique numeric code (e.g., 1001)
Account TypeAsset, Liability, Equity, Revenue, or Expense
Parent AccountParent in hierarchy (optional)
DescriptionPurpose of this account
Is Payment AccountWhether this account can be used in Paid Through dropdowns

Default Accounts

The system creates a set of default accounts on organization setup, covering the most common hotel accounting needs. These can be customized but not deleted if they have transactions.

Series & Auto-Numbering

Configure automatic numbering for invoices, expenses, bookings, and other records under Settings → Series.

Configuration Per Module

Each module that generates numbered records has its own series configuration:

SettingDescriptionExample
PrefixText before the numberINV
SeparatorCharacter between prefix and number-
Next NumberThe next number to be assigned00042
Number PaddingMinimum digits (left-padded with zeros)5

Preview

As you configure, a live preview shows the resulting format:

Prefix: INV
Separator: -
Next Number: 42
Padding: 5

Preview: INV-00042

Supported Modules

Series can be configured for:

  • Invoices (e.g., INV-00001)
  • Bookings (e.g., BK-00001)
  • Expenses (e.g., EXP-00001)
  • Credit Notes (e.g., CN-00001)
  • Quotes (e.g., QT-00001)
  • Payment Receipts (e.g., PR-00001)

WARNING

Changing the next number or prefix won't affect already-generated records. Be careful not to set a next number that conflicts with existing records.

Vendor Management

Manage vendor/supplier profiles under Settings → Vendors.

Vendor Profile

FieldDescription
Vendor NameCompany or individual name
EmailContact email
PhoneContact number
AddressFull address
GSTINVendor's GST number (validated)
PANVendor's PAN number
NotesInternal notes

Vendors are linked to expenses for better tracking and reporting. When creating an expense, you can select a vendor from the dropdown.

Notifications Configuration

Configure notification preferences under Settings → Notifications.

Notification Types

TypeDescription
New BookingWhen a booking is created
Booking UpdateWhen a booking is modified
Check-inWhen a guest checks in
Check-outWhen a guest checks out
Invoice CreatedWhen an invoice is generated
Payment ReceivedWhen a payment is recorded
Booking CancellationWhen a booking is cancelled

Notification Channels

Notifications can be delivered via:

  • In-App — real-time notifications in the application (via WebSocket)
  • Email — email notifications to configured recipients

Configuration Options

For each notification type, you can:

  • Enable or disable the notification
  • Choose which channels are active (in-app, email, or both)
  • Specify additional recipients beyond the defaults

Email Template Customization

Customize the content of outgoing emails under Settings → Email Templates. For detailed documentation, see the dedicated Email Templates guide.

Quick settings:

  • Set default templates for each email type
  • Customize subject lines and body content
  • Include organization branding

Applying Changes

Most settings take effect immediately after saving. Some changes (like logo updates or series changes) may require a page refresh to appear across the application.

Audit Trail

All settings changes are logged in the audit trail, showing who made the change and when.

Released under the MIT License.