Overview

The payroll engine takes the base salary, incidences, and tax tables to compute the final net pay for each employee. It handles ISR (Income Tax), IMSS quotas, and other statutory deductions automatically.

1. Get Payroll Cycle

Identify the current open payroll period.

GET/api/v1/payroll/calendars/current

2. Trigger Calculation

Start the async calculation process for a specific payroll ID.

POST/api/v1/payroll/calculate
Request Body
{
  "payrollId": "pay-period-2024-10"
}

3. Review Results

Get a summary of the calculated totals (Total Earnings, Total Deductions, Net Pay).

GET/api/v1/payroll/employee-summary/{payrollId}