merit-palk-settings

Merit Palk — Settings & Dimensions

Per-employee setting writes plus dimension creation. Endpoints: palk tax-free set (sendtaxfree), palk vacation set-liability (sendvacoblig), palk reduced-capacity set (sendincapacitypension), palk dimensions set (senddimensions). All POST. No API delete/update — corrections are manual in Merit Palk. For the per-employee setting rows (tax-free, vacation liability, reduced capacity) a new row with a later StartDate supersedes the previous one — existing rows are never rewritten. (Dimensions are the exception: re-sending an existing Code edits it — see below.)

Basic exemption / tax-free income (sendtaxfree)

elnora-merit palk tax-free set --data '{
  "PersonalCode": "39001011234",
  "StartDate": "2026-01-01",
  "TaxFreeUsageOption": 1
}'

• Required: PersonalCode, StartDate, TaxFreeUsageOption (1 maximum allowable rate · 2 limited amount → also set MaxSum · 3 no usage). Optional SurName, FirstName.
• A new StartDate row closes the previous setting. If payouts already exist after the given StartDate, the setting is not imported (to avoid tax recalculation). With no setting at all, Merit treats the employee as option 3 (no basic exemption).

Vacation liability rate (sendvacoblig)

elnora-merit palk vacation set-liability --data '{
  "ContractCode": "39001011234",
  "StartDate": "2026-01-01",
  "Days": 28,
  "InitBalance": 5.00
}'

• ContractCode = contract import code or Personal ID code. Days = vacation days/year. InitBalance = opening unused-days balance. ReservePercent = the employee's personal vacation-reserve % (omit to use the company-wide setting from Merit Palk → Settings → Chart of accounts). StartDate must not equal any existing setting's start date.

Reduced work capacity (sendincapacitypension)

elnora-merit palk reduced-capacity set --data '{
  "PersonalCode": "39001011234",
  "StartDate": "2026-01-01", "EndDate": "2026-12-31",
  "DecreaseSocTax": true,
  "InitBalance": 0.00
}'