Update employee payroll config

PUT/payroll/employees/{id}

Updates an employee's payroll configuration, including basic salary, tax code, allowances, and deduction assignments.

Request

Path parameters

Name	Type	Required	Description
id	integer	Yes	The numeric ID of the employee payroll config record.

Request body

Content type application/json (required).

Field	Type	Required	Description
basic_salary	number (float)	No	Monthly basic salary in the payroll currency.
tax_code	string	No	Tax profile code determining which PAYE band table applies.
allowance_ids	array of integer	No	IDs of allowance types to assign to this employee.
deduction_ids	array of integer	No	IDs of deduction types to assign to this employee.

Example

{
  "basic_salary": 4500.0,
  "tax_code": "GH_RESIDENT_STANDARD",
  "allowance_ids": [
    1,
    3
  ],
  "deduction_ids": [
    2
  ]
}

Responses

200 Employee payroll config updated

404 Employee config not found

Example request

curl -X PUT "https://{tenant}.faciotech.net/api/v1/payroll/employees/{id}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"basic_salary": 4500.0, "tax_code": "GH_RESIDENT_STANDARD", "allowance_ids": [1, 3], "deduction_ids": [2]}'