payroll

Close Payroll Benefit

Set valid_to — the only mutation of a live row (close-and-insert).

post/companies/{company_id}/payroll/benefits/{benefit_id}/close

Request

  • Base URL: https://app.zeno-works.ch (the document declares no server; this is the origin it was published from)
  • URL: https://app.zeno-works.ch/companies/{company_id}/payroll/benefits/{benefit_id}/close
  • Auth: none declared

Path parameters

company_idstring required
benefit_idstring required

Headers

authorizationstring nullable

Cookies

access_tokenstring nullable

Request body

valid_tostring date required

Response

Successful Response

idstring required
employee_idstring required
benefit_type'company_car' | 'other' required

Benefit kind: company_car = the §6.1 flat 0.9% method; other = a generic fixed-amount manual benefit (the §6.6 phone-exception path A). Designed so a future company_car_logbook value can be added without schema rework (§6.3 is a frozen v1 scope cut).

fixed_asset_idstring nullable required
basis_amountstring nullable required
monthly_percentstring required
minimum_monthlystring required
monthly_amountstring nullable required
wage_type_codestring nullable required
employee_contribution_monthlystring required
contribution_method'external' | 'payroll_deduction' required

How the §6.2 employee contribution is collected: external = paid outside payroll (payroll only reduces the declarable share); payroll_deduction = withheld from net salary via a 5071 line.

private_use_excludedboolean required
private_use_excluded_reasonstring nullable required
employee_bears_operating_costsboolean required
valid_fromstring date required
valid_tostring date nullable required
notestring nullable required
monthly_computedstring nullable
monthly_declaredstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.