my_payslipsreads only
My payslips
The signed-in person's released payslips: period, pay date, gross, deductions and net. With a payslipPublicId, one payslip in full — days and hours, every earning and deduction line. Only ever the person's own.
Someone asks: “How much was my last payslip?”
Input
{
"from": "2026-09-01"
}
What comes back
2 payslips:
2026-09-16 → 2026-09-30 · paid 2026-10-05 · gross 14250.00 · deductions 1893.75 · net 12356.25 · PR-2026-0930-01 · id a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d
2026-09-01 → 2026-09-15 · paid 2026-09-20 · gross 13500.00 · deductions 1793.75 · net 11706.25 · PR-2026-0915-01 · id b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e
Structured content
Show the structured answer
{
"payslips": [
{
"publicId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"referenceNo": "PR-2026-0930-01",
"periodLabel": "2026-09-16 → 2026-09-30",
"payDate": "2026-10-05",
"grossPay": "14250.00",
"totalDeductions": "1893.75",
"netPay": "12356.25"
}
]
}
payroll_runsreads only
Payroll runs
Payroll runs, newest first: period, type, status, pay date and totals. Simulations are left out unless asked for.
Someone asks: “List this year's payroll runs.”
Input
{
"year": 2026,
"limit": 2
}
What comes back
2 of 19 runs:
PR-2026-0930-01 · 2026-09-16 → 2026-09-30 (Semi-monthly) · regular · paid · pays 2026-10-05 · gross 812450.00 · net 701233.10 · id d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7a
PR-2026-0915-01 · 2026-09-01 → 2026-09-15 (Semi-monthly) · regular · paid · pays 2026-09-20 · gross 798120.00 · net 689410.55 · id e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b
Structured content
Show the structured answer
{
"runs": [
{
"publicId": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7a",
"referenceNo": "PR-2026-0930-01",
"periodStart": "2026-09-16",
"periodEnd": "2026-09-30",
"scheduleName": "Semi-monthly",
"runType": "regular",
"status": "paid",
"payDate": "2026-10-05",
"totalGross": "812450.00",
"totalNet": "701233.10"
}
],
"total": 19
}
simulate_payrollchanges data
Simulate payroll
Runs the payroll engine for one pay period as a simulation: the payslips can be read, but nothing is paid, no balance, accrual or grant moves, and a simulation can never be approved. Name the period by id, or give any date inside it. Reports totals, who could not be paid and why.
Someone asks: “Simulate payroll for the first half of October.”
Input
{
"date": "2026-10-10"
}
What comes back
Simulation SIM-2026-1015-03 for 2026-10-01 → 2026-10-15 (Semi-monthly), regular: calculated.
Gross 804310.00 = basic 702000.00 + overtime 41310.00 + holiday 0.00 + incentives 61000.00; deductions 109870.20; net 694439.80.
1 person could not be paid:
Villanueva, Rico (EMP-031): no salary rate on 2026-10-01.
This is a simulation: nothing was paid and no balance moved. The payslips are under Payroll › Simulations in the suite.
Structured content
Show the structured answer
{
"run": {
"referenceNo": "SIM-2026-1015-03",
"status": "calculated",
"isSimulation": true,
"totalGross": "804310.00",
"totalNet": "694439.80"
},
"skipped": [
{
"employeePublicId": "f6a7b8c9-d0e1-4f2a-9b3c-4d5e6f7a8b9c",
"employeeName": "Villanueva, Rico",
"employeeNumber": "EMP-031",
"reason": "no salary rate on 2026-10-01."
}
],
"notes": []
}
job_costsreads only
Labor cost by project or cost center
What each project or cost center cost in labor over a span, from approved payroll: basic, overtime, holiday, incentives, employer contributions and the total. Highest first.
Someone asks: “What did each project cost us in labor last month?”
Input
{
"from": "2026-09-01",
"to": "2026-09-30",
"by": "project"
}
What comes back
Labor cost 2026-09-01 to 2026-09-30, by project:
Acme Steel - Bridge retrofit · total 412330.50 · basic 350000.00 · overtime 22330.50 · holiday 0.00 · incentives 15000.00 · employer 25000.00
Acme Steel - Warehouse fit-out · total 198745.00 · basic 170000.00 · overtime 8745.00 · holiday 0.00 · incentives 5000.00 · employer 15000.00
No project · total 61200.00 · basic 52000.00 · overtime 0.00 · holiday 0.00 · incentives 4200.00 · employer 5000.00
Structured content
Show the structured answer
{
"from": "2026-09-01",
"to": "2026-09-30",
"by": "project",
"rows": [
{
"publicId": "0c9d8e7f-6a5b-4c3d-9e2f-1a0b9c8d7e6f",
"code": "ALPHA",
"name": "Acme Steel - Bridge retrofit",
"totals": {
"basic": "350000.00",
"holiday": "0.00",
"overtime": "22330.50",
"holidayOvertime": "0.00",
"incentive": "15000.00",
"employer": "25000.00",
"payroll": "387330.50",
"total": "412330.50"
}
}
]
}
deduction_requestsreads only
Deduction requests and advances
Deduction requests: the kind, the amount, how many instalments, which period it starts in and its status. `includeCompleted` adds the ones already paid off.
Someone asks: “Are there advances waiting for approval?”
Input
{
"status": "pending"
}
What comes back
1 of 1 deduction request:
2026-10-14 · Dela Cruz, Juan (EMP-001) · Cash advance · 6000.00 over 3 instalments · from 2026-10-16 → 2026-10-31 · pending · id 3b4c5d6e-7f8a-4b9c-8d0e-1f2a3b4c5d6e
Structured content
Show the structured answer
{
"requests": [
{
"publicId": "3b4c5d6e-7f8a-4b9c-8d0e-1f2a3b4c5d6e",
"employeePublicId": "5f1c2a9e-3b7d-4c21-9e4a-1d2f3c4b5a60",
"employeeName": "Dela Cruz, Juan",
"employeeNumber": "EMP-001",
"requestDate": "2026-10-14",
"deductionTypeName": "Cash advance",
"amount": "6000.00",
"instalments": 3,
"startDate": "2026-10-16",
"endDate": "2026-10-31",
"status": "pending"
}
],
"total": 1
}
incentive_grantsreads only
Incentive grants
Incentive grants: who, which incentive, the value, the period it is paid in, the project or cost center it is charged to where it names one, and its status.
Someone asks: “What incentives are going out this cutoff?”
Input
{
"payPeriodPublicId": "6f7a8b9c-0d1e-4f2a-8b3c-4d5e6f7a8b9c",
"status": "approved"
}
What comes back
1 of 1 incentive grant:
2026-10-12 · Santos, Maria (EMP-007) · Site allowance · 1500.00 (Fixed amount) · 2026-10-01 → 2026-10-15 · on Acme Steel - Bridge retrofit · approved · id 4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f
Structured content
Show the structured answer
{
"grants": [
{
"publicId": "5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c",
"employeePublicId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
"employeeName": "Santos, Maria",
"employeeNumber": "EMP-007",
"grantDate": "2026-10-12",
"incentiveTypeName": "Site allowance",
"amount": "1500.00",
"basis": "Fixed amount",
"periodStart": "2026-10-01",
"periodEnd": "2026-10-15",
"targetsLabel": "Acme Steel - Bridge retrofit",
"status": "approved"
}
],
"total": 1
}
owed_balancesreads only
What people still owe
Outstanding deduction balances, largest first: who owes what, broken down by kind of deduction, and over how many schedules.
Someone asks: “Who still owes the company money?”
Input
{
"limit": 2
}
What comes back
2 people with a balance:
Dela Cruz, Juan (EMP-001) · 4000.00 over 1 schedule · Cash advance 4000.00
Villanueva, Rico (EMP-031) · 1250.00 over 2 schedules · Cash advance 1000.00, Uniform 250.00
Structured content
Show the structured answer
{
"rows": []
}