city_tax.get
Read the current tenant's accommodation-tax (Beherbergungssteuer / Kurtaxe / city tax) configuration. Fields: enabled, label, method (per_booking | per_night | per_person_booking | per_person_night | percent_total), flatCents (€ amount ×100, for the flat methods), percent (for percent_total), vatRatePct, maxNights (taxable-nights cap, null = none), adultsOnly (children exempt), includedInTotal (carve out of the booking total vs. add on top). Read-only.
Input parameters
Returns object.
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
enabled | boolean | yes | |
label | string | yes | |
method | enum | yes | One of: per_booking, per_night, per_person_booking, per_person_night, percent_total |
flatCents | number | yes | |
percent | string | yes | |
vatRatePct | string | yes | |
maxNights | number · nullable | yes | |
adultsOnly | boolean | yes | |
includedInTotal | boolean | yes |
city_tax.update
Upsert the tenant's accommodation-tax config. `method` selects how the tax is computed: per_booking (flat per booking), per_night (flat × nights), per_person_booking (flat × persons), per_person_night (flat × persons × nights), or percent_total (percent of the booking total). `amountEur` is the € amount for the flat methods; `percent` is used for percent_total. `maxNights` caps taxable nights (null = no cap). `adultsOnly` exempts children. `includedInTotal` carves the tax out of the booking total instead of adding it on top. Owner-only.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
enabled | boolean | yes | |
label | string | yes | |
method | enum | yes | One of: per_booking, per_night, per_person_booking, per_person_night, percent_total |
amountEur | number | yes | € amount for the flat methods. |
percent | number | yes | Percent for method=percent_total. |
vatRatePct | number | yes | |
maxNights | integer · nullable | yes | |
adultsOnly | boolean | yes | |
includedInTotal | boolean | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | boolean | yes |