Set up

Organization

Set up your own company's structure (vendor companies, branches, departments, service lines and employee grades with their pay currency), which every employee and deployment refers to.

Sidebar → Organization (route /organization). This describes your company, the service provider, not your customers. You set it up once; each list then becomes a dropdown on employees, deployments and payroll.

Who can do this: Admin, Ops Manager (permission master_data.manage).

The five lists

Each list has its own Add button, an Edit and Delete per row, and a Status (active, inactive, archived). Codes are generated automatically from the numbering set in Administration.

Organization: (1) the menu item, (2) Add branch

Vendor companies → Add company

A vendor company is your own legal entity: the company that employs your staff and sends them to customers' sites (in this app you are the vendor, your customers are the clients). Everything you hire and deploy sits under one.

Add company: (1) trading name, (2) name as registered, (3) GSTIN, (4) PAN, (5) Save

FieldRequiredNotes
Company nameYesTrading name, e.g. Paradigm Integrated Facility Management
Legal nameAs registered
GSTIN15 characters
PAN
CodeGenerated (COM-0001) when created; branch, department, service line and grade codes work the same way. Editing a record keeps its code.

Add one per legal entity if your group has several, e.g. a security company and a facility-management company under the same owners. Each has its own GSTIN, PAN and code.

Vendor companies: the new company with its code, GSTIN and PAN; (1) Add company

Edit on a row changes the company; Delete removes it. A company that branches or employees still point to should be set to inactive instead of deleted.

Branches → Add branch

FieldRequiredNotes
CompanyWhich company the branch belongs to
Branch nameYese.g. Bengaluru, Hyderabad, Pune
Regione.g. South

Add branch: (1) name, (2) region, (3) Save

A branch is an office that services a set of sites. A site's Servicing branch and a branch data scope refer to it.

Departments → Add department

Department name (required), e.g. Operations, HR, Finance. The code (DEP-001) is generated.

Add department: (1) the name, (2) Save

Departments: (1) Add department

Service lines → Add service line

Service line (required) and a description: what you sell, e.g. Manned guarding, Housekeeping, Technical (MEP). Deployments can name a service line.

Add service line: (1) what you sell, (2) a short description, (3) Save

Service lines: (1) Add service line

Employee grades → Add grade

FieldRequiredNotes
Grade nameYese.g. Security Guard, Supervisor
Grade codeGenerated (GRD-01) when created
CurrencyThe currency the pay below is in. Default INR (₹); also AED, SAR, QAR, OMR, KWD, BHD, USD, EUR, GBP, SGD and more
Base payMonthly, e.g. 18000
Overtime ratePer hour, e.g. 120
Statusactive / inactive / archived

Add grade: (1) name, (2) currency, (3) monthly pay, (4) overtime per hour, (5) Save

The list shows each grade's pay in its own currency, so a grade for staff posted in Dubai can be set in dirhams next to your rupee grades:

Employee grades: ₹ and AED grades side by side; (1) Add grade

Each employee is given a grade. Grades created before the currency option existed are in INR.

How it connects

Next

Clients and sites.