beherbergungssteuer.monat
The report for one month, by date of overnight stay. Basis for the monthly filing to the city. Read-only query.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
monat | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
monat | string | yes | |
einstellung | object · nullable | yes | |
einstellung.aktiv | boolean | yes | |
einstellung.bezeichnung | string | yes | |
einstellung.methode | string | yes | |
einstellung.satzCents | number | yes | |
einstellung.maxNaechte | number · nullable | yes | |
einstellung.nurErwachsene | boolean | yes | |
einstellung.jeNacht | boolean | yes | |
summe | object | yes | |
summe.aufenthalte | number | yes | |
summe.personenNaechte | number | yes | |
summe.cents | number | yes | |
zeilen | array of object | yes | |
zeilen.stayId | string | yes | |
zeilen.anreise | string | yes | |
zeilen.abreise | string | yes | |
zeilen.zimmer | string · nullable | yes | |
zeilen.kanal | string · nullable | yes | |
zeilen.buchungsnummer | string · nullable | yes | |
zeilen.personen | number | yes | |
zeilen.naechteGesamt | number | yes | |
zeilen.naechteBezahlt | number | yes | |
zeilen.naechteImMonat | number | yes | |
zeilen.personenNaechte | number | yes | |
zeilen.cents | number | yes | |
zeilen.naechteUnentgeltlichImMonat | number | yes | |
zeilen.unentgeltlichAb | string · nullable | yes | |
zeilen.unentgeltlichAbAusserhalb | boolean | yes | |
zeilen.mitPreis | boolean | yes | |
zeilen.gedeckelt | boolean | yes | |
zeilen.sollAufenthaltCents | number | yes | |
zeilen.folioCents | number · nullable | yes | |
zeilen.folioWeichtAb | boolean | yes | |
ohnePreis | array of object | yes | |
ohnePreis.stayId | string | yes | |
ohnePreis.anreise | string | yes | |
ohnePreis.abreise | string | yes | |
ohnePreis.zimmer | string · nullable | yes | |
ohnePreis.kanal | string · nullable | yes | |
ohnePreis.buchungsnummer | string · nullable | yes | |
ohnePreis.personen | number | yes | |
ohnePreis.naechteGesamt | number | yes | |
ohnePreis.naechteBezahlt | number | yes | |
ohnePreis.naechteImMonat | number | yes | |
ohnePreis.personenNaechte | number | yes | |
ohnePreis.cents | number | yes | |
ohnePreis.naechteUnentgeltlichImMonat | number | yes | |
ohnePreis.unentgeltlichAb | string · nullable | yes | |
ohnePreis.unentgeltlichAbAusserhalb | boolean | yes | |
ohnePreis.mitPreis | boolean | yes | |
ohnePreis.gedeckelt | boolean | yes | |
ohnePreis.sollAufenthaltCents | number | yes | |
ohnePreis.folioCents | number · nullable | yes | |
ohnePreis.folioWeichtAb | boolean | yes | |
unentgeltlich | array of object | yes | |
unentgeltlich.stayId | string | yes | |
unentgeltlich.anreise | string | yes | |
unentgeltlich.abreise | string | yes | |
unentgeltlich.zimmer | string · nullable | yes | |
unentgeltlich.kanal | string · nullable | yes | |
unentgeltlich.buchungsnummer | string · nullable | yes | |
unentgeltlich.personen | number | yes | |
unentgeltlich.naechteGesamt | number | yes | |
unentgeltlich.naechteBezahlt | number | yes | |
unentgeltlich.naechteImMonat | number | yes | |
unentgeltlich.personenNaechte | number | yes | |
unentgeltlich.cents | number | yes | |
unentgeltlich.naechteUnentgeltlichImMonat | number | yes | |
unentgeltlich.unentgeltlichAb | string · nullable | yes | |
unentgeltlich.unentgeltlichAbAusserhalb | boolean | yes | |
unentgeltlich.mitPreis | boolean | yes | |
unentgeltlich.gedeckelt | boolean | yes | |
unentgeltlich.sollAufenthaltCents | number | yes | |
unentgeltlich.folioCents | number · nullable | yes | |
unentgeltlich.folioWeichtAb | boolean | yes |
beherbergungssteuer.setzeUnentgeltlich
Mark a stay WITHOUT a price as free of charge (unentgeltlich, e.g. owner use or friends) so it is excluded from the monthly city-tax (Beherbergungssteuer) return — or undo that mark. Rejected for stays that have a price. Tax-relevant; the operator decides. Requires confirmation.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | yes | |
unentgeltlich | boolean | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | yes | |
unentgeltlich | boolean | yes | |
geaendert | boolean | yes |
beherbergungssteuer.setzeUnentgeltlichAb
Set — or clear with null — the date from which a PAID stay was free of charge (unentgeltlich ab, e.g. staff or owner use after the paid nights). Nights starting on or after that calendar day are excluded from the monthly city-tax (Beherbergungssteuer) return at once. The mutation itself does not touch the folio: its tax line follows on the next head-count heal or folio reset. The date must lie after the check-in day and at the latest on the check-out day; stays without a price are rejected, and stays without check-in/check-out cannot get a date (clearing it always works). Tax-relevant; the operator decides. Requires confirmation.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | yes | |
unentgeltlichAb | string · nullable | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | yes | |
unentgeltlichAb | string · nullable | yes | |
geaendert | boolean | yes | |
naechte | object | yes | |
naechte.gesamt | number | yes | |
naechte.bezahlt | number | yes | |
naechte.unentgeltlich | number | yes |