DomendraPOS Documentation

Getting Started

Set up your workspace, log in, and navigate the main layout.

1. Create a workspace

On the login screen, click “New to DomendraPOS? Create a workspace”. Fill in the workspace name, your admin email, currency (e.g. KSh for Kenya Shilling), and timezone. After you submit, you receive a confirmation email and your tenant (workspace) is provisioned.

2. Log in

Fig 1. The login screen

View full screen

3. Navigate the dashboard

Fig 2. The dashboard

View full screen

The main layout has three regions:

4. Select a branch

Use the branch selector in the top app bar (top right). The default is “All Branches”. When you select a specific branch, all subsequent transactions, stock views, and reports are scoped to that branch.

Point of Sale (POS)

Make sales fast — scan, tap, accept payments, and issue receipts.

Fig 3. The POS terminal

View full screen

Payment methods

POS features

Inventory

Track stock-on-hand across branches, adjust quantities, transfer stock, and get low-stock alerts.

Fig 4. The inventory stock-on-hand page

View full screen

Core concepts

Stock movements

Sample stock data (exportable)

sku,product,category,on_hand,unit,reorder_point,value,status
SKU-001,Coca-Cola 500ml,Beverages,240,bottle,50,14400,In Stock
SKU-002,Bread Loaf,Bakery,42,loaf,20,2310,In Stock
SKU-003,Milk 1L,Dairy,18,carton,25,2160,Low Stock
SKU-004,Sugar 1kg,Groceries,87,bag,30,18270,In Stock
SKU-005,Eggs (tray),Dairy,0,tray,10,0,Out of Stock
SKU-006,Rice 2kg,Groceries,56,bag,20,19040,In Stock
SKU-007,Cooking Oil 1L,Groceries,73,bottle,25,18980,In Stock
SKU-008,Tea Bags 100pk,Beverages,8,box,15,1440,Low Stock

Products

Define the catalog: products, brands, categories, units of measure, variants, and bulk import.

Sample product catalog data (exportable):

sku,name,category,brand,unit,cost_price,selling_price,tax_rate,is_active
SKU-001,Coca-Cola 500ml,Beverages,Coca-Cola,bottle,45,60,16,true
SKU-002,Bread Loaf,Bakery,Prima,loaf,40,55,0,true
SKU-003,Milk 1L,Dairy,Brookside,carton,105,120,0,true
SKU-004,Sugar 1kg,Groceries,Mumias,bag,190,210,16,true
SKU-005,Eggs (tray),Dairy,Kenchic,tray,420,450,0,false
SKU-006,Rice 2kg,Groceries,Pishori,bag,300,340,0,true

Customers

Build a customer CRM — loyalty points, store credit, purchase history, and outstanding balances.

Customer balances export

name,phone,email,loyalty_points,credit_balance,total_spent
John Ade,+254712345678,john@example.com,340,1200,38400
Sarah Kamau,+254722334455,sarah@example.com,1280,0,124500
Moses Otieno,+254733445566,moses@example.com,75,450,7300
Mary Wanjiru,+254700112233,mary@example.com,850,0,56700
David Kiptoo,+254711998877,david@example.com,12,2100,1800

Suppliers and Purchasing

Manage suppliers, raise purchase orders (POs), receive goods into stock, and track payables.

Sample purchase order data (exportable):

po_number,supplier,branch,status,order_date,total
PO-2026-001,Coca-Cola Ltd,City,Approved,2026-01-04,48000
PO-2026-002,Prima Bakeries,Town,Received,2026-01-05,12000
PO-2026-003,Brookside Dairy,City,Pending,2026-01-06,38500
PO-2026-004,Mumias Sugar,Town,Draft,2026-01-06,24000
PO-2026-005,Kenchic Ltd,Highway,Received,2026-01-03,16800

Reports

Generate sales summaries, profit and loss, VAT returns, and stock valuation for any period and branch.

Fig 5. Sales summary report

View full screen

Interactive sample — Sales by day

Analytics

Interactive dashboards: ABC analysis, revenue trends, top products, staff performance, peak hours.

Accounts and Finance

Chart of accounts, journal entries, ledgers, VAT, and financial statements.

Sample journal entries (exportable):

entry_no,date,account,description,debit,credit
JE-1001,2026-01-06,Cash,Cash sale #1024,1250,0
JE-1001,2026-01-06,Sales Revenue,Cash sale #1024,0,1078
JE-1001,2026-01-06,VAT Output,VAT on sale #1024,0,172
JE-1002,2026-01-06,M-Pesa,M-Pesa sale #1025,821,0
JE-1002,2026-01-06,Sales Revenue,M-Pesa sale #1025,0,708
JE-1002,2026-01-06,VAT Output,VAT on sale #1025,0,113

All Modules at a Glance

A quick reference table of every module and its main capabilities.

Roles, Permissions, and Audit

Fine-grained Role-Based Access Control (RBAC) with audit logging. Every action is recorded.

Fig 6. The IAM page

View full screen

Default roles

Audit logs

Every login, create, update, delete, permission change, and export is recorded with user, IP, module, action, and timestamp. Tenant admins and auditors can filter and export the audit trail.

Fig 7. The audit log

View full screen

timestamp,user,action,module,ip_address,status
2026-01-06 14:32:18,John Ade,LOGIN,Auth,41.90.1.12,Success
2026-01-06 14:30:02,Sarah Kamau,CREATE,Products,41.90.1.15,Success
2026-01-06 14:25:44,Moses Otieno,SALE,POS,41.90.1.18,Success
2026-01-06 14:20:11,John Ade,DELETE,Inventory,41.90.1.12,Denied
2026-01-06 14:15:33,Mary Wanjiru,UPDATE,Accounting,41.90.1.20,Success
2026-01-06 14:10:09,David Kiptoo,LOGIN_FAILED,Auth,41.90.1.25,Failed

API and Exports

All list pages expose a REST API at /api and support CSV export. Here is how.

Authentication

The frontend uses JWT access and refresh tokens. The token is sent as Authorization: Bearer <access_token>. Access tokens expire every 15 minutes and are refreshed automatically on 401 responses.

POST /api/auth/login/
Content-Type: application/json

{
  "email": "you@example.com",
  "password": "your-password"
}

Refreshing the token

POST /api/auth/refresh/
Authorization: Bearer <refresh_token>

Listing resources

GET /api/products/?search=bread&category=groceries&ordering=-created_at
Authorization: Bearer <access_token>

# Response shape:
{
  "count": 128,
  "next": "https://…/api/products/?page=2",
  "previous": null,
  "results": [ {…}, {…}, … ]
}

Audit trail / Logs

Frequently Asked Questions