Back to Playbook
Act 2: Setting Up the Kingdom

11. Money Setup (Salary, Tax, Contributions)

Story

With attendance and employee structures now configured, Sarah moves on to setting up salary structures, tax rules, and statutory contributions so payroll calculations remain accurate and compliant.

She carefully defines payroll components and deduction policies because even small mistakes could affect employee trust, compliance reporting, taxes, employer liabilities, and monthly payroll accuracy across the organization.

Happy Path

Salary structures, tax policies, and contribution rules are configured successfully so payroll calculations can run accurately and consistently across the organization.

  • Define salary structures with Basic, Allowance, Deduction, Bonus, Tax, and Provident Fund components
  • Configure salary effective dates and payroll applicability
  • Set up tax rules using slab-based or flat-rate calculations
  • Configure tax thresholds, exemption limits, and percentages
  • Create statutory contribution rules with employer and employee shares
  • Apply contribution caps and payroll deduction policies automatically

Benefits: Provident Fund & Gratuity

Beyond month-to-month pay, Sarah sets up the long-term benefits that follow an employee through their tenure. Provident Fund and Gratuity are configured once as policies, then accrued and tracked automatically by every payroll run.

These are not just line items — they carry balances over time, and the system reconciles them at withdrawal and at separation so the final number is never guesswork.

  • Define a PF scheme: contribution basis, employer/employee rates, vesting (immediate, cliff, or graded), and interest posting
  • Define a gratuity policy: basis, proration, and any cap
  • Each payroll run accrues PF contributions and updates the employee passbook (including the vested balance)
  • Employees view their own PF passbook and request advance or partial withdrawals, capped at their available balance
  • Admins clear withdrawal requests through an approval queue before any payout
  • At separation, accrued PF and gratuity flow into the final settlement automatically

Failure Modes

FailureWhat the user seesWhat happens next
Salary components do not equal total salary amountValidation rejects salary breakdownAdjust component totals to match overall salary
Negative salary component amount configuredValidation rejection shownEnter valid positive component values
Percentage-based salary component produces fractional valuesRounding rules automatically appliedReview generated rounded values if necessary
Overlapping salary structure effective dates for the same employeeConflict validation shownEnd previous structure or adjust effective dates
Salary structure updated after payroll already processedChange scheduled for next payroll cycleReview next payroll run for updated calculations
Overlapping tax slab thresholds configuredValidation rejects tax slab configurationAdjust slab threshold ranges
Negative tax rate configuredValidation rejection shownEnter a valid positive tax percentage
Contribution cap configured below minimum allowed valueSystem warning displayedReview statutory minimum contribution requirements

Edge Cases

ScenarioBehaviorWhy
Employee salary changes during the middle of a monthPayroll applies prorated salary calculation automaticallyEnsures accurate partial-month compensation
Tax exemption threshold configuredFirst portion of income remains tax-free before calculations applySupports legal tax compliance requirements
Statutory contribution percentages change during the yearRemaining payroll cycles apply prorated contribution calculationsMaintains fair and compliant contribution adjustments