---
title: "Record Vat Fact"
method: POST
path: "/companies/{company_id}/gl/vat/facts"
tags: ["gl-subledgers"]
---

# Record Vat Fact

`POST /companies/{company_id}/gl/vat/facts`

## 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}/gl/vat/facts`
- Auth: none declared

State one VAT fact with its evidence — accountant (or admin). 422 when the vocabulary
refuses it (unknown kind, a missing date/amount/field, no evidence), or when it contradicts
a standing fact of its kind on the same entry on what decides the regime (e.g.
private_seller_purchase.collectible) — the 422 names every such fact; withdraw them
first.

## Path parameters

- `company_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- VatFactCreate: State one VAT fact with its evidence (F2481 / F2482 — ``vat.facts``). ``kind`` is one of ``GET …/gl/vat/fact-kinds``; ``payload`` carries the kind's typed fields.
  - `kind` string, required
  - `evidence` string, required: What the fact rests on — the document, filing or statement a reviewer can check (e.g. 'Form 764 filed 2026-04-12', 'delivery receipt of 2026-03-05').
  - `journal_entry_id` string, nullable
  - `fact_date` string, date, nullable
  - `amount` union
    - number
    - string
  - `payload` object

## Response `201`

Successful Response

- VatFactOut
  - `id` string, required
  - `kind` string, required
  - `journal_entry_id` string, nullable
  - `fact_date` string, date, nullable
  - `amount` string, nullable
  - `payload` object, required
  - `evidence` string, required
  - `recorded_by` string, nullable
  - `recorded_at` string, date-time, required
  - `withdrawn_at` string, date-time, nullable
  - `withdrawn_by` 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)