---
title: "Add Payroll Bvg Plan Version"
method: POST
path: "/companies/{company_id}/payroll/bvg-plans/{plan_id}/versions"
tags: ["payroll-rates"]
---

# Add Payroll Bvg Plan Version

`POST /companies/{company_id}/payroll/bvg-plans/{plan_id}/versions`

## 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/bvg-plans/{plan_id}/versions`
- Auth: none declared

Version create carries overrides + extras + split (close-and-insert).

## Path parameters

- `company_id` string, required
- `plan_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- BvgPlanVersionCreate
  - `entry_threshold_override` union
    - number
    - string
  - `entry_threshold_inclusive` boolean
  - `partial_month_billing` 'full_month' | 'calendar_days'
  - `coordination_deduction_override` union
    - number
    - string
  - `upper_limit_override` union
    - number
    - string
  - `age_tiers_override` BvgAgeTierIn[], nullable
    - `age_min` integer, required
    - `age_max` integer, required
    - `total_bp` number, required
  - `extra_total_bps` number
  - `employee_share_bps` number
  - `valid_from` string, date, required
  - `valid_to` string, date, nullable

## Response `201`

Successful Response

- BvgPlanVersionOut
  - `id` string, required
  - `entry_threshold_override` string, nullable, required
  - `entry_threshold_inclusive` boolean, required
  - `partial_month_billing` 'full_month' | 'calendar_days', required
  - `coordination_deduction_override` string, nullable, required
  - `upper_limit_override` string, nullable, required
  - `age_tiers_override` BvgAgeTierOut[], nullable, required
    - `age_min` integer, required
    - `age_max` integer, required
    - `total_bp` number, required
  - `extra_total_bps` number, required
  - `employee_share_bps` number, required
  - `valid_from` string, date, required
  - `valid_to` string, date, nullable, required

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