Get employee
Returns one organization-owned payroll employee, the profile fields required by neighboring payroll operations, and payrollReadiness: what still stops exac from calculating and stamping the employee's ordinary payroll. An employee paid by individual receipts is outside that payroll and reports no issues for it. A last_receipt_deductions_missing issue means the employee's last receipt took deductions (an INFONAVIT credit, for one) of types payroll.fixedDeductions lacks; lastReceiptDeductions lists them per pay period: add them to payroll.fixedDeductions, or send payroll.lastReceiptDeductionsDismissed true to decide against them. A newer receipt asks again.
- Endpoint
GET /v1/employees/{employeeId}- Authorization
- Required permission: `employees:read`.
- Environments
- Production and sandbox
- Idempotency
- Not required.
Create employee POST
Creates an employee record with its identity, employment terms, salary and payroll terms, bank account, and receipt email. An RFC already assigned to an employee in the organization returns 409 conflict; retrieve and update the existing employee by employeeId. Saving never requires payroll readiness; the response reports it.
Update employee PATCH
Updates the supplied editable identity, employment, payroll, bank, and contact fields of one employee. Omitted fields retain their current values; null clears an optional field. Set payrollStatus to inactive with employmentEndedOn to remove the employee from payroll (baja).