merit-palk-employees

Merit Palk — Employees, Contracts & Agreements

Endpoints: palk employees create (sendemployees), palk base-salary create (sendpayterms), palk contacts add (sendcontacts), palk employees list (getemployees), palk base-salary list (getpayterms). All POST. No API delete/update — corrections are manual in Merit Palk.

If your workspace keeps a company books reference (the GL account, department/cost-centre codes, salary-type import IDs actually configured in Merit Palk), load it from the references dir (MERIT_REFERENCES_DIR) before building a payload. Note: profile sync covers Aktiva reference data only — Palk import IDs are not in company-profile.json.

sendemployees vs sendpayterms — pick the right one

• New person joining → palk employees create (sendemployees). Adds the employee, their first contract, AND their first base salary agreement in one call.
• Changing pay for someone already in Merit → palk base-salary create (sendpayterms). Adds a NEW base salary agreement (new StartDate) to an existing contract.
• You cannot use sendpayterms to add the first agreement at the contract's start date — that one is auto-created with the contract. Two agreements can never share the same StartDate.

Add a new employee (sendemployees)

Required (*): PersonalCode, SurName, FirstName, TypeId, StartDate, SalaryTypeImpCode. SalaryTypeImpCode must already exist on the Base Salary type card in Merit Palk (numeric).

elnora-merit palk employees create --data '{
  "PersonalCode": "39001011234",
  "FirstName": "Mari", "SurName": "Maasikas",
  "TypeId": 1,
  "StartDate": "2026-07-01",
  "SalaryTypeImpCode": 100,
  "Hours": 8.00, "Amount": 12.0000,
  "AutoTimeKeeping": true, "FullWorkingTime": true,
  "GLAccountCode": "5000", "DepartmentCode": "ADMIN"
}'

• TypeId: 1 Employment contract · 2 Board member · 3 Other · 5 Contract of services · 4 No contract.
• Hours = hours/day (8.00 full-time, 4.00 half). Amount = base salary tariff (the rate; e.g. the hourly amount for hourly pay, or the monthly amount for monthly pay).
• AutoTimeKeeping: true lets Merit auto-reduce hours for absences. Set false if you import or hand-enter hours each month.
• GLAccountCode / DepartmentCode / CCCode / ProjectCode are optional but recommended; each must already exist in Merit Palk or it is ignored. (Posted-register fields: NRStartDate, NREndDate, NRState ISO2, NRHasCert — for the TÖR employment registration.)