---
title: "Put Filing Config"
method: PUT
path: "/companies/{company_id}/payroll/filings/config"
tags: ["payroll"]
---

# Put Filing Config

`PUT /companies/{company_id}/payroll/filings/config`

## 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/filings/config`
- Auth: none declared

Full-replace the provider overrides; responds with the fresh calendar.

## Path parameters

- `company_id` string, required

## Query parameters

- `year` integer, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- PayrollFilingConfigPut
  - `configs` PayrollFilingConfigIn[], required
    - `provider_kind` 'ahv_alv' | 'uvg' | 'ktg' | 'fak' | 'bvg' | 'qst', required: The payroll declaration planes of the filing calendar (gap #12 — H17).
    - `frequency` 'monthly' | 'quarterly' | 'annual', required
    - `due_days` integer
    - `active` boolean

## Response `200`

Successful Response

- FilingCalendarResponse
  - `year` integer, required
  - `providers` FilingProviderOut[]
    - `provider_kind` 'ahv_alv' | 'uvg' | 'ktg' | 'fak' | 'bvg' | 'qst', required: The payroll declaration planes of the filing calendar (gap #12 — H17).
    - `frequency` 'monthly' | 'quarterly' | 'annual', required
    - `due_days` integer, required
    - `active` boolean, required
    - `configured` boolean, required
    - `periods` FilingPeriodOut[]
      - `provider_kind` 'ahv_alv' | 'uvg' | 'ktg' | 'fak' | 'bvg' | 'qst', required: The payroll declaration planes of the filing calendar (gap #12 — H17).
      - `period_start` string, date, required
      - `period_end` string, date, required
      - `due_date` string, date, required
      - `status` string, required
      - `filing_id` string, nullable
      - `document_id` string, nullable
      - `form_document_id` string, nullable
      - `elm_document_id` string, nullable
      - `generated_at` string, date-time, nullable
      - `filed_at` string, date-time, nullable
      - `staleness` PayrollStalenessOut: Why this artefact no longer matches the live master data. Absent (``null``) means "not stale". Never blocks anything: a correction over a locked or filed period is reported here, never refused (refusing would restore the dead end ZET-123 fixed).
        - `reasons` string[]
        - `action` string, nullable
        - `changed_fields` string[]
        - `audit_id` string, nullable
        - `changed_at` string, date-time, nullable
        - `reason` 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)