Skip to main content

Earnings and Deductions Model

Summary​

Employee outcomes compose base earnings, overtime, salary components, approved reimbursements, adjustments, shortfall, statutory deductions, and advance recovery.

Audience​

Backend and frontend developers, QA and DevOps engineers, support and security engineers, and solution architects.

Overview​

Employee outcomes compose base earnings, overtime, salary components, approved reimbursements, adjustments, shortfall, statutory deductions, and advance recovery.

Technical Detail​

Earning sources​

Confirmed earning categories include earned base, overtime, earning-classified components, positive earning adjustments, and approved Expense reimbursements as a one-time line. Fixed and variable results arise from salary mode and component basis.

Deduction sources​

Confirmed deductions include shortfall, deduction-classified components, deduction adjustments, enabled settings-based employee deductions, and planned advance recovery. Paid/unpaid Leave and Attendance paid units influence the base result.

Gross and net​

The engine persists gross, total deductions, and net outcome. Internal formulas, rates, thresholds, and customer-specific values are intentionally excluded. Negative net is not explicitly rejected by the calculation path and requires governance confirmation.

Rounding​

The implementation rounds several intermediate monetary results to currency precision, but a comprehensive cross-service rounding policy is not confirmed.

Source References​

  • microservices/src/payroll-service/Domain/PayrollEntities.cs
  • microservices/src/payroll-service/Application/PayrollCalculationService.cs
  • microservices/src/payroll-service/Application/PayrollOutputsService.cs

See Also​

Keywords​

  • Payroll Service
  • Earnings and Deductions Model
  • Technical architecture

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-15
  • Review cycle: Quarterly