payroll

Create Payroll Benefit

Create a benefit row (a company_car always emits 1900 — server-side).

post/companies/{company_id}/payroll/employees/{employee_id}/benefits

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/employees/{employee_id}/benefits
  • Auth: none declared

Path parameters

company_idstring required
employee_idstring required

Headers

authorizationstring nullable

Cookies

access_tokenstring nullable

Request body

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).

valid_fromstring date required
valid_tostring date nullable
fixed_asset_idstring nullable
wage_type_codestring nullable
contribution_method'external' | 'payroll_deduction'

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
private_use_excluded_reasonstring nullable
employee_bears_operating_costsboolean
notestring nullable

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.