πŸ“
Incidences
β†’
πŸ”’
Calculate
β†’
πŸ“œ
Stamp CFDI
β†’
πŸ“„
Payslips
β†’
πŸ’Έ
Disburse

Overview

As an HRA (Human Resources Administrator), you need to process all incidences (PTOs, leaves, absences, extra hours, reimbursements, etc.) to calculate payroll, stamp CFDIs, generate payslips, and disburse payments. This flow guides you through the complete payroll cycle using the Worky APIs.

Payroll Cycle Stages

πŸ“ 1. Collect Incidences

Gather all HR incidences for the payroll period: PTOs, leaves, absences, overtime, reimbursements, bonuses, and deductions.

GET/api/v1/incidences/eventsList all incidences
GET/api/v1/time-off/eventsGet time-off events
GET/api/v1/time-off/balancesCheck PTO balances
PUT/api/v1/incidences/requests/approve/{id}Approve incidence
Learn more β†’

πŸ”’ 2. Calculate Payroll

Run the payroll engine to compute salaries, taxes, and deductions for all employees.

GET/api/v1/payroll/calendarGet payroll calendar
POST/api/v1/payroll/calculationRun calculation
GET/api/v1/payroll/employee-summary/{id}View summary
GET/api/v1/payroll/conceptList payroll concepts
Learn more β†’

πŸ“œ 3. Stamp CFDI

Generate and stamp the official CFDI (Comprobante Fiscal Digital por Internet) for each employee's payslip as required by Mexican tax law.

POST/api/v1/payroll/engine/do-calculationRun processing
GET/api/v1/payroll/{payrollId}Check status
Swagger update: Dedicated payroll stamping endpoints are not exposed in current OpenAPI. Confirm stamping integration endpoints with backend.
Learn more β†’

πŸ“„ 4. Generate Payslips

Create and distribute payslips to all employees.

GET/api/v1/payroll/{payrollId}Get payroll record
POST/api/v1/payroll/querySearch payroll records
Swagger update: Payslip-specific endpoints are not exposed in current OpenAPI. Confirm payslip distribution endpoints with backend.

πŸ’Έ 5. Disburse Payroll

Process bank transfers to pay employees.

POST/api/v1/payroll/period/closeClose payroll period
GET/api/v1/payroll/{payrollId}Check status
Swagger update: Disbursement-specific endpoints are not exposed in current OpenAPI. Confirm bank transfer endpoints with backend.
Learn more β†’
⚠️ Mexico Compliance: Payroll in Mexico requires CFDI stamping with a certified PAC (Proveedor Autorizado de Certificación). Ensure your Worky account is configured with valid SAT credentials.

Related APIs

Payroll APIIncidences APITime Off APIDirectory API