Payroll

atlas_payroll_compensation_revisions_hr_approve

HR-approve a MANAGER_APPROVED comp revision. Creates new EmployeeSalary atomically.

Scope

payroll:write

Calls

PATCH /v1/hr/payroll/compensation-revisions/{id}/hr-approve

Example prompt

HR-approve rev_xyz.

Arguments

atlas_payroll_compensation_revisions_list

List compensation revision requests. Filter by employee or status.

Scope

payroll:read

Calls

GET /v1/hr/payroll/compensation-revisions

Example prompt

Show me PENDING comp revisions.

Arguments

atlas_payroll_compensation_revisions_manager_approve

Manager-approve a PENDING comp revision (requester cannot self-approve).

Scope

payroll:write

Calls

PATCH /v1/hr/payroll/compensation-revisions/{id}/manager-approve

Example prompt

Manager-approve rev_xyz.

Arguments

atlas_payroll_compensation_revisions_reject

HR: reject a compensation revision with a reason.

Scope

payroll:write

Calls

PATCH /v1/hr/payroll/compensation-revisions/{id}/reject

Example prompt

Reject rev_xyz: out of band.

Arguments

atlas_payroll_compensation_revisions_request

File a new compensation revision for an employee (lands in PENDING).

Scope

payroll:write

Calls

POST /v1/hr/payroll/compensation-revisions

Example prompt

Request a 12L revision for emp_xyz effective 1 Jul.

Arguments

atlas_payroll_employee_loans_approve

HR: approve a pending employee loan or advance request.

Scope

payroll:write

Calls

PATCH /v1/hr/payroll/loans/{id}/approve

Example prompt

Approve loan loan_xyz.

Arguments

atlas_payroll_employee_loans_close

HR: close an employee loan or advance (early settlement).

Scope

payroll:write

Calls

PATCH /v1/hr/payroll/loans/{id}/close

Example prompt

Close loan loan_xyz.

Arguments

atlas_payroll_employee_loans_disburse

HR: disburse an approved loan (move to ACTIVE and seed the running balance).

Scope

payroll:write

Calls

PATCH /v1/hr/payroll/loans/{id}/disburse

Example prompt

Disburse loan loan_xyz.

Arguments

atlas_payroll_employee_loans_list

List employee loans and salary advances. Filter by employee or status.

Scope

payroll:read

Calls

GET /v1/hr/payroll/loans

Example prompt

Show me all ACTIVE loans.

Arguments

atlas_payroll_employee_loans_reject

HR: reject a pending employee loan or advance request with a reason.

Scope

payroll:write

Calls

PATCH /v1/hr/payroll/loans/{id}/reject

Example prompt

Reject loan loan_xyz: budget freeze.

Arguments

atlas_payroll_employee_loans_request

File a new employee loan or salary advance request (HR or self-service).

Scope

payroll:write

Calls

POST /v1/hr/payroll/loans

Example prompt

File a loan request for emp_xyz: 60000 over 12 months.

Arguments

atlas_payroll_employee_salaries_assign

Assign a salary structure and monthly basic pay to an employee with an effective-from date.

Scope

payroll:write

Calls

POST /v1/hr/payroll/employee-salaries

Example prompt

Set emp_abc on a 20 lakh CTC starting next month.

Arguments

atlas_payroll_employee_salaries_list

List per-employee salary assignments. Filter by employee.

Scope

payroll:read

Calls

GET /v1/hr/payroll/employee-salaries

Example prompt

What salary is emp_abc on?

Arguments

atlas_payroll_full_and_final_settlements_approve

HR: approve a CALCULATED Full and Final settlement so it can be marked paid.

Scope

payroll:write

Calls

POST /v1/hr/payroll/full-and-final/{id}/approve

Example prompt

Approve F+F ff_xyz.

Arguments

atlas_payroll_full_and_final_settlements_calculate

HR: compute pro-rated salary + leave encashment + gratuity + bonus minus loan + advance + notice shortfall for a F+F settlement.

Scope

payroll:write

Calls

POST /v1/hr/payroll/full-and-final/{id}/calculate

Example prompt

Calculate F+F ff_xyz.

Arguments

atlas_payroll_full_and_final_settlements_cancel

HR: cancel a Full and Final settlement (cannot cancel a PAID record).

Scope

payroll:write

Calls

POST /v1/hr/payroll/full-and-final/{id}/cancel

Example prompt

Cancel F+F ff_xyz: termination reversed.

Arguments

atlas_payroll_full_and_final_settlements_create

HR: initiate a Full and Final settlement for a terminated employee (creates a DRAFT record).

Scope

payroll:write

Calls

POST /v1/hr/payroll/full-and-final

Example prompt

Start a F+F for emp_xyz terminated 30 Jun.

Arguments

atlas_payroll_full_and_final_settlements_get

HR: fetch a single Full and Final settlement by id (all line items + status).

Scope

payroll:read

Calls

GET /v1/hr/payroll/full-and-final/{id}

Example prompt

Show me F+F ff_xyz.

Arguments

atlas_payroll_full_and_final_settlements_payment_record

HR: mark an APPROVED Full and Final settlement as paid out (optionally linked to a payslip).

Scope

payroll:write

Calls

POST /v1/hr/payroll/full-and-final/{id}/mark-paid

Example prompt

Mark F+F ff_xyz as paid.

Arguments

atlas_payroll_pay_runs_approve

Approve a calculated pay-run so it can be marked paid.

Scope

payroll:write

Calls

POST /v1/hr/payroll/pay-runs/{id}/approve

Example prompt

Approve the May pay-run.

Arguments

atlas_payroll_pay_runs_calculate

Calculate (or recalculate) lines for a DRAFT pay-run. Idempotent per call.

Scope

payroll:write

Calls

POST /v1/hr/payroll/pay-runs/{id}/calculate

Example prompt

Calculate the May pay-run.

Arguments

atlas_payroll_pay_runs_create

Create a new pay-run with a name, period start and end, pay date and currency (default status DRAFT).

Scope

payroll:write

Calls

POST /v1/hr/payroll/pay-runs

Example prompt

Spin up a pay-run for May 2026.

Arguments

atlas_payroll_pay_runs_get

Fetch a single pay-run by id, including its computed lines if calculated.

Scope

payroll:read

Calls

GET /v1/hr/payroll/pay-runs/{id}

Example prompt

Show me the May pay-run.

Arguments

atlas_payroll_pay_runs_list

List pay-runs in the tenant. Filter by status or period.

Scope

payroll:read

Calls

GET /v1/hr/payroll/pay-runs

Example prompt

What pay-runs are still in DRAFT?

Arguments

atlas_payroll_pay_runs_payment_record

Mark an approved pay-run as paid out.

Scope

payroll:write

Calls

POST /v1/hr/payroll/pay-runs/{id}/mark-paid

Example prompt

Mark the May pay-run as paid.

Arguments

atlas_payroll_payslips_form1099nec_url_get

Return the URL for a US Form 1099-NEC (non-employee compensation) PDF.

Scope

payroll:read

Calls

GET /v1/hr/payroll/payslips/{id}/1099-nec

Example prompt

Get the 1099-NEC URL for payslip pys_xyz.

Arguments

atlas_payroll_payslips_form16_url_get

Return the URL for an India Form 16 (annual TDS certificate) PDF for one payslip.

Scope

payroll:read

Calls

GET /v1/hr/payroll/payslips/{id}/form16

Example prompt

Get the Form 16 URL for payslip pys_xyz.

Arguments

atlas_payroll_payslips_form16a_url_get

Return the URL for an India Form 16A (non-salary TDS) PDF for one payslip.

Scope

payroll:read

Calls

GET /v1/hr/payroll/payslips/{id}/form16a

Example prompt

Get the Form 16A URL for payslip pys_xyz.

Arguments

atlas_payroll_payslips_form940_url_get

Return the URL for a US Form 940 (annual FUTA) PDF for one payslip.

Scope

payroll:read

Calls

GET /v1/hr/payroll/payslips/{id}/form940

Example prompt

Get the Form 940 URL for payslip pys_xyz.

Arguments

atlas_payroll_payslips_form941_url_get

Return the URL for a US Form 941 (quarterly federal tax return) PDF.

Scope

hr:read

Example prompt

Get the Form 941 URL for payslip pys_xyz.

Arguments

atlas_payroll_payslips_get

Fetch a single payslip with earning, deduction, and net amount lines.

Scope

payroll:read

Calls

GET /v1/hr/payroll/payslips/{id}

Example prompt

Show me payslip pys_xyz.

Arguments

atlas_payroll_payslips_list

List payslips. Filter by employee, pay-run, or period.

Scope

payroll:read

Calls

GET /v1/hr/payroll/payslips

Example prompt

List emp_abc's 2026 payslips.

Arguments

atlas_payroll_payslips_w2_url_get

Return the URL for a US Form W-2 PDF for one payslip.

Scope

payroll:read

Calls

GET /v1/hr/payroll/payslips/{id}/w2

Example prompt

Get the W-2 URL for payslip pys_xyz.

Arguments

atlas_payroll_salary_structures_create

Create a salary structure template with an effective-from date, a currency and its pay components.

Scope

payroll:write

Calls

POST /v1/hr/payroll/salary-structures

Example prompt

Create a standard salary structure with HRA, basic, and TDS components.

Arguments

atlas_payroll_salary_structures_list

List salary structures (component templates) configured for the tenant.

Scope

payroll:read

Calls

GET /v1/hr/payroll/salary-structures

Example prompt

What salary structures do we have?

Arguments

This tool takes no arguments.

atlas_payroll_salary_structures_update

Patch top-level fields on a salary structure template. Components cannot be changed; create a new structure instead.

Scope

payroll:write

Calls

PATCH /v1/hr/payroll/salary-structures/{id}

Example prompt

Tweak the HRA formula on sal_xyz.

Arguments

atlas_payroll_statutory_esic_ecr_generate

Generate the ESIC Electronic Challan-cum-Return (ECR) CSV for a YYYY-MM payroll month.

Scope

hr:read

Calls

GET /v1/hr/statutory/esic-ecr

Example prompt

Generate the ESIC ECR for June 2026.

Arguments

atlas_payroll_statutory_filings_create

Create a new statutory filing record for a period.

Scope

hr:write

Calls

POST /v1/hr/admin/statutory-filings

Example prompt

Open a Q1 PF filing.

Arguments

atlas_payroll_statutory_filings_get

Fetch a single statutory filing by id.

Scope

hr:read

Calls

GET /v1/hr/admin/statutory-filings/{id}

Example prompt

Show me filing fil_xyz.

Arguments

atlas_payroll_statutory_filings_list

List statutory filings (PF, ESI, TDS, 941, etc.). Filter by country or status.

Scope

hr:read

Calls

GET /v1/hr/admin/statutory-filings

Example prompt

What statutory filings are pending?

Arguments

atlas_payroll_statutory_form24q_generate

Generate the Form 24Q TRACES quarterly salary TDS upload file (tab-separated TXT) for the requested quarter + financial year.

Scope

hr:read

Calls

GET /v1/hr/statutory/form24q

Example prompt

Generate Form 24Q for Q1 FY 2026-27.

Arguments

atlas_payroll_statutory_form24q_url_get

Return the API path for the India Form 24Q quarterly salary TDS return, one CSV for the whole workspace, for one financial year and quarter. Compose it with the API base URL and an Authorization header to download. The employer name, TAN, PAN and BSR code must be set in the statutory settings first.

Scope

hr:read

Calls

GET /v1/hr/statutory/form24q

Example prompt

Get the Form 24Q return for the second quarter of 2026-27.

Arguments

atlas_payroll_statutory_form26q_generate

Generate the Form 26Q TRACES quarterly non-salary TDS upload file (tab-separated TXT) covering s.194x deductions.

Scope

hr:read

Calls

GET /v1/hr/statutory/form26q

Example prompt

Generate Form 26Q for Q1 FY 2026-27.

Arguments

atlas_payroll_statutory_pf_ecr_generate

Generate the EPFO PF Electronic Challan-cum-Return (ECR) tilde-separated file for a YYYY-MM payroll month.

Scope

hr:read

Calls

GET /v1/hr/statutory/pf-ecr

Example prompt

Generate the PF ECR for June 2026.

Arguments

atlas_payroll_tax_declarations_approve

HR-admin: approve an employee tax declaration.

Scope

payroll:write

Calls

PATCH /v1/hr/payroll/declarations/{id}/approve

Example prompt

Approve declaration dec_xyz.

Arguments

atlas_payroll_tax_declarations_list

HR-admin: list employee tax declarations. Filter by employee or status.

Scope

payroll:read

Calls

GET /v1/hr/payroll/declarations

Example prompt

Which declarations are pending HR approval?

Arguments

atlas_payroll_tax_declarations_reject

HR-admin: reject an employee tax declaration with a required reason.

Scope

payroll:write

Calls

PATCH /v1/hr/payroll/declarations/{id}/reject

Example prompt

Reject dec_xyz: missing rent receipt.

Arguments