---
title: "Update fiscalization tax for a property"
method: PUT
path: "/fiscal-document/v1/fiscalization/tax"
tags: ["Fiscalization"]
---

# Update fiscalization tax for a property

`PUT /fiscal-document/v1/fiscalization/tax`

Creates or updates the fiscalization tax configuration for the given property

## Headers

- `X-Property-ID` integer, required

## Request body

- FiscalizationTaxRequest
  - `partnerId` integer — Optional scope to a specific partner instance on a multi-partner property. Omit on single-partner properties (legacy behavior).
  - `taxes` TaxMapping[]
    - `taxId` integer, required — Tax ID from the accounting system
    - `category` string, required — Tax category code (e.g., VAT, ISR)
    - `key` string, required — Tax key describing the tax situation (e.g., standard, exempt)
    - `rate` string, required — Rate within the category and key (e.g., general, reduced)
    - `description` string, nullable — Exemption reason text (e.g. VAT Act article reference). Required when key=exempt.

## Response `200`

Fiscalization tax config saved successfully

- FiscalizationTaxResponse
  - `taxes` TaxMapping[]
    - `taxId` integer, required — Tax ID from the accounting system
    - `category` string, required — Tax category code (e.g., VAT, ISR)
    - `key` string, required — Tax key describing the tax situation (e.g., standard, exempt)
    - `rate` string, required — Rate within the category and key (e.g., general, reduced)
    - `description` string, nullable — Exemption reason text (e.g. VAT Act article reference). Required when key=exempt.

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)