reports.buchungenPreise
Bookings and prices: per booking and room, nights, booking date, paid average price per night, and the calendar price on the booking date together with the difference. Read-only query.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
anreiseVon | string | yes | |
anreiseBis | string | yes | |
buchungVon | string | no | |
buchungBis | string | no | |
room | string | no |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
anreiseVon | string | yes | |
anreiseBis | string | yes | |
ersterVerlaufstag | string | yes | |
aufenthalte | integer | yes | |
zeilen | array of object | yes | |
zeilen.stayId | string | yes | |
zeilen.buchungsnummer | string · nullable | yes | |
zeilen.kanal | string · nullable | yes | |
zeilen.zimmer | string · nullable | yes | |
zeilen.anreise | string | yes | "YYYY-MM-DD" (UTC-Kalendertag wie die Nächtezählung). |
zeilen.abreise | string | yes | |
zeilen.naechte | integer | yes | |
zeilen.gebuchtAm | string · nullable | yes | Buchungstag "YYYY-MM-DD" in der Hauszone; null = unbekannt. |
zeilen.gebuchtQuelle | enum · nullable | yes | One of: kanal, beds24, foyer |
zeilen.bezahltCents | integer · nullable | yes | |
zeilen.bezahltQuelle | enum · nullable | yes | unterkunft = Unterkunftssumme ohne Gebühren (mit dem Kalenderpreis vergleichbar); gesamt = Gesamtbetrag inkl. Gebühren; zimmerpreis = Beds24-Zimmerpreis inkl. Ortssteuer. — One of: unterkunft, gesamt, zimmerpreis |
zeilen.bezahltAnteilig | boolean | yes | |
zeilen.zimmerUrspruenglich | string · nullable | yes | |
zeilen.bezahltProNachtCents | integer · nullable | yes | Ø je Nacht. |
zeilen.angebotCents | integer · nullable | yes | |
zeilen.naechteMitAngebot | integer | yes | |
zeilen.angebotProNachtCents | integer · nullable | yes | |
zeilen.differenzCents | integer · nullable | yes | |
zeilen.differenzProNachtCents | integer · nullable | yes |
reports.revenue_stats
Revenue + occupancy KPIs over a 7/30/90-day window: occupancy %, ADR, RevPAR, total revenue (cents), a daily revenue series, and a per-room-type breakdown. Read-only. Revenue is sourced from folio_lines (Foyer-native authoritative). stornoErloese = cancellations where the channel kept money (count + cents): the amount the guest paid according to the channel, GROSS like the rest of revenue (Airbnb: Beds24 Channel Collect + channel commission, capped at the reported price; Booking.com: reported payment, else cancellation fee, without commission — Booking.com bills it separately), the fee itself carries 0% VAT (non-taxable damages) — NOT the payout. Assigned by check-in date and NOT included in revenue, ADR, RevPAR or occupancy. stornogebuehrImUmsatzCents = cancellation fees of LIVE stays (one room of a multi-room booking cancelled): included in revenueTotal and the daily series, but subtracted from the ADR/RevPAR numerator (overall and per room type) — a fee is not a sold room.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
windowDays | literal | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
windowDays | number | yes | |
totalRooms | number | yes | |
occupiedNights | number | yes | |
availableNights | number | yes | |
occupancyPct | number | yes | |
revenueTotal | number | yes | |
adr | number | yes | |
revpar | number | yes | |
stornogebuehrImUmsatzCents | number | yes | |
dailySeries | array of object | yes | |
dailySeries.date | string | yes | |
dailySeries.revenueCents | number | yes | |
byRoomType | array of object | yes | |
byRoomType.roomType | string | yes | |
byRoomType.displayName | string | yes | |
byRoomType.roomCount | number | yes | |
byRoomType.occupiedNights | number | yes | |
byRoomType.availableNights | number | yes | |
byRoomType.occupancyPct | number | yes | |
byRoomType.revenueCents | number | yes | |
byRoomType.adr | number | yes | |
byRoomType.revpar | number | yes | |
stornoErloese | object | yes | |
stornoErloese.anzahl | number | yes | |
stornoErloese.summeCents | number | yes |
reports.summary
Report overview of the property: bookings and occupancy per month, booking sources, AI shifts, send counters of the messaging rules, and cleaning tasks (total and completed). Requires the finances module. Read-only.
Input parameters
Returns object.
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
generatedAt | string | yes | |
bookings | array of object | yes | |
bookings.month | string | yes | ISO month start, e.g. "2026-04-01". |
bookings.label | string | yes | Human label, e.g. "Apr 26". |
bookings.count | integer | yes | |
occupancy | array of object | yes | |
occupancy.month | string | yes | ISO month start, e.g. "2026-04-01". |
occupancy.label | string | yes | Human label, e.g. "Apr 26". |
occupancy.occupiedNights | integer | yes | |
occupancy.availableNights | integer | yes | |
occupancy.pct | number | yes | |
sources | array of object | yes | |
sources.source | string | yes | |
sources.count | integer | yes | |
aiLayers | array of object | yes | |
aiLayers.layer | string | yes | |
aiLayers.count | integer | yes | |
autoReplyRate | number | yes | Share (0..1) of inbound guest messages in the last 30 days answered by a rule|llm message within 24 h — the same definition as dashboard.aiAnalytics.autoReplyRate. |
messagingRules | array of object | yes | |
messagingRules.id | string | yes | |
messagingRules.name | string | yes | |
messagingRules.enabled | boolean | yes | |
messagingRules.sentCount | integer | yes | |
messagingRules.lastSentAt | string · nullable | yes | |
cleaning | object | yes | |
cleaning.daysBack | integer | yes | |
cleaning.totalTasks | integer | yes | |
cleaning.completed | integer | yes | |
cleaning.skipped | integer | yes | |
cleaning.pending | integer | yes | |
cleaning.inProgress | integer | yes | |
cleaning.avgDurationMinutes | integer · nullable | yes | |
cleaning.completionPct | number | yes |