direktangebot.erneutSenden
Send a direktangebot's payment-link email again after the first send failed or stayed unclear. This sends a REAL email to the guest. Only allowed while the 24-hour hold runs and the mail was not confirmed as sent. Requires confirmation.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
angebotId | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
angebotId | string | yes | |
versand | object | yes | |
versand.stand | enum | yes | One of: versandt, fehlgeschlagen, unklar |
versand.versandtAm | string · nullable | yes | |
versand.fehler | string · nullable | yes | |
versand.gesendet | boolean | yes |
direktangebot.senden
Hold a room for 24 hours and send the guest a payment-link offer. This sends a REAL email to the given address (it cannot be recalled) and blocks the room on all channels until the guest pays or the hold expires. Pass the room, dates, adults, the recipient and the language, plus EITHER the stay the offer is made at (`ursprungStayId`: the guest is that stay's guest) OR, for an offer without a booking, `gastName` (required) and optionally `telefon` and no `ursprungStayId`: the guest is then found in the house by email AND name, or created, and an existing guest is never overwritten. Without a booking, channel forwarding addresses (e.g. …@guest.booking.com) are rejected; use the stay for those guests. Giving both is an error. `betragCents` overrides the proposal (total incl. accommodation tax) and is required when there is no bookable rate. Call `direktangebot_vorschlag` first to see availability and price. Requires confirmation.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
ursprungStayId | string | no | |
gastName | string | no | |
telefon | string | no | |
roomName | string | yes | |
checkIn | string | yes | |
checkOut | string | yes | |
adults | integer | yes | |
betragCents | integer · nullable | no | |
email | string | yes | |
sprache | enum | yes | One of: de, en |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
angebotId | string | yes | |
stayId | string | yes | |
externalCode | string | yes | |
kurzlink | string | yes | |
gueltigBis | string | yes | |
vorschlagCents | number | yes | |
betragCents | number | yes | |
ueberschrieben | boolean | yes | |
versand | object | yes | |
versand.stand | enum | yes | One of: versandt, fehlgeschlagen, unklar |
versand.versandtAm | string · nullable | yes | |
versand.fehler | string · nullable | yes | |
versand.gesendet | boolean | yes |
direktangebot.vorschlag
Proposal for a direct offer: whether the room is free in the period and what it costs (room price per night plus accommodation tax, same as the direct-booking checkout). With `ursprungStayId` (appending a night to a stay) and no further parameters it defaults to the same room, the night after the stay's departure, the stay's adults, the guest's email address and the guest's language. Without `ursprungStayId` (an offer without a booking) `roomName`, `checkIn` and `checkOut` are required (otherwise `angaben_fehlen`). Without a bookable rate `vorschlag.tarif` is empty, and an amount must then be given when sending. Writes nothing.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
ursprungStayId | string | no | |
roomName | string | no | |
checkIn | string | no | |
checkOut | string | no | |
adults | integer | no |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
vorbelegung | object | yes | |
vorbelegung.roomName | string · nullable | yes | |
vorbelegung.checkIn | string | yes | |
vorbelegung.checkOut | string | yes | |
vorbelegung.adults | number | yes | |
vorbelegung.email | string · nullable | yes | |
vorbelegung.sprache | enum | yes | One of: de, en |
vorschlag | object · nullable | yes | |
vorschlag.roomName | string | yes | |
vorschlag.roomType | string | yes | |
vorschlag.frei | boolean | yes | |
vorschlag.grund | string · nullable | yes | |
vorschlag.naechte | number | yes | |
vorschlag.tarif | object · nullable | yes | |
vorschlag.tarifGrund | string · nullable | yes | |
vorschlag.logisCents | number · nullable | yes | |
vorschlag.steuerCents | number | yes | |
vorschlag.gesamtCents | number · nullable | yes | |
vorschlag.waehrung | string | yes | |
zimmer | array of object | yes | |
zimmer.roomName | string | yes | |
zimmer.roomType | string | yes | |
zimmer.frei | boolean | yes | |
zimmer.gesamtCents | number · nullable | yes | |
fehler | string · nullable | yes | |
haltStunden | number | yes |
direktangebot.zuAufenthalt
The direct offers made at a stay OR whose hold stay it is (offers without a booking sit at their hold stay), newest first, each with a state: `offen` (open), `bezahlt` (paid), `abgelaufen` (expired), `versand_fehlgeschlagen` (send failed) or `versand_unklar` (send unclear). `stayId` is the offer's hold stay, `ursprungStayId` the stay the offer was made at (empty without a booking); `kurzlink` is the payment link for offers whose hold is still running. Read-only.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | yes |
Output fields
Returns array of object. Fields of each element:
| Field | Type | Required | Notes |
|---|---|---|---|
angebotId | string | yes | |
stayId | string | yes | |
ursprungStayId | string · nullable | yes | |
externalCode | string · nullable | yes | |
zimmer | string · nullable | yes | |
anreise | string · nullable | yes | |
abreise | string · nullable | yes | |
betragCents | number | yes | |
waehrung | string | yes | |
empfaengerEmail | string | yes | |
zustand | enum | yes | One of: offen, bezahlt, abgelaufen, versand_fehlgeschlagen, versand_unklar |
gueltigBis | string · nullable | yes | |
kurzlink | string · nullable | yes | |
versandtAm | string · nullable | yes | |
versandFehler | string · nullable | yes | |
angelegtAm | string | yes |