---
title: "Close Payroll Benefit"
method: POST
path: "/companies/{company_id}/payroll/benefits/{benefit_id}/close"
tags: ["payroll"]
---

# Close Payroll Benefit

`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

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

## Path parameters

- `company_id` string, required
- `benefit_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- PayrollBenefitClose
  - `valid_to` string, date, required

## Response `200`

Successful Response

- PayrollBenefitOut
  - `id` string, required
  - `employee_id` string, 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_id` string, nullable, required
  - `basis_amount` string, nullable, required
  - `monthly_percent` string, required
  - `minimum_monthly` string, required
  - `monthly_amount` string, nullable, required
  - `wage_type_code` string, nullable, required
  - `employee_contribution_monthly` string, 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_excluded` boolean, required
  - `private_use_excluded_reason` string, nullable, required
  - `employee_bears_operating_costs` boolean, required
  - `valid_from` string, date, required
  - `valid_to` string, date, nullable, required
  - `note` string, nullable, required
  - `monthly_computed` string, nullable
  - `monthly_declared` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)