rateSuggestions.generate
writes
Calculates price suggestions for a rate plan (ratePlanId) and a date range from to to (optionally only one roomType), stores them as suggestions and returns them together with the number of skipped days and the reasons. Does not set any prices itself. Owner only, with the revenue_ai feature package; a rate plan belonging to another property returns NOT_FOUND. Mutation — changes data.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
ratePlanId | string | yes | |
roomType | string | no | |
from | string | yes | |
to | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
vorschlaege | array of object | yes | |
vorschlaege.date | string | yes | |
vorschlaege.roomType | string | yes | |
vorschlaege.suggestedCents | integer | yes | |
vorschlaege.currentCents | integer · nullable | yes | |
vorschlaege.rationale | string | yes | |
vorschlaege.source | string | yes | |
vorschlaege.losHint | object · nullable | yes | |
uebersprungen | integer | yes | |
uebersprungenJeZimmertyp | array of object | yes | |
uebersprungenJeZimmertyp.roomType | string | yes | |
uebersprungenJeZimmertyp.anzahl | integer | yes | |
uebersprungenJeGrund | array of object | yes | Dasselbe Schweigen nach Ursache. `ohne-basis`: weder eigener Preis noch Marktbild. `ohne-umrechnung`: ein Marktbild liegt vor, aber es gibt kein gemessenes Verhältnis zwischen Sammler- und Kalenderpreis — eine Eigenschaft des Hauses, nicht des Tages. Ohne diese Trennung meldet ein Haus ohne eigene Sammlerzeile fast das ganze Fenster stumm und zeigt auf die falsche Ursache. Gründe ohne Vorkommen fehlen. |
uebersprungenJeGrund.grund | enum | yes | One of: ohne-basis, ohne-umrechnung |
uebersprungenJeGrund.anzahl | integer | yes | |
ohneNachfrage | integer | yes | Entstandene Vorschläge ohne Nachfragesignal: keine Prognose für die Kombination, also kein Auslastungsfaktor (R2). Gemessen betrifft das rund ein Drittel der Kombinationen im 30-Tage-Fenster. |
ohneNachfrageJeGrund | array of object | yes | Dieselbe Zahl nach Ursache. `keine-prognose`: für die Kombination liegt keine Zeile in demand_forecasts vor. `prognose-ohne-streuung`: Zeilen liegen vor, tragen über den ganzen Lauf aber EINEN Wert — gemessen am 2026-09-09 gegen prod: 532 Zeilen, ein Wert (0,200). Eine Konstante ist keine Aussage über einen Tag, der Auslastungsfaktor bleibt dann aus. Gründe ohne Vorkommen fehlen in der Liste. |
ohneNachfrageJeGrund.grund | enum | yes | One of: keine-prognose, prognose-ohne-streuung, faktor-angehalten |
ohneNachfrageJeGrund.anzahl | integer | yes |