Offene Schnittstelle
Buchungen
Eine Buchung trägt eine Nummer wie SB-261114-WWNP. Mit ihr sprechen alle Endpunkte dieser Seite eine Buchung an. Welche Zustände sie durchläuft, steht unter Zustände und Begriffe.
Buchungen auflisten
Abschnitt betitelt „Buchungen auflisten“GET/api/ext/v1/bookings
Der Zeitraum bezieht sich auf den Anreisetag und nicht auf das Buchungsdatum. Eine Freitextsuche gibt es hier nicht.
In der Abfrage
| Parameter | Typ | Bedeutung |
|---|---|---|
status | string | Ein Zustand oder mehrere, durch Komma getrennt, etwa confirmed,delivered.max. 200 Zeichen |
from | string | Anreisetag ab diesem Tag.JJJJ-MM-TT |
to | string | Anreisetag bis zu diesem Tag.JJJJ-MM-TT |
accommodation | integer | Nur Buchungen dieser Unterkunft.ab 1 |
page | integer | Seite, gezählt ab 1.1 bis 500 · Vorgabe 1 |
perPage | integer | Einträge je Seite.1 bis 100 · Vorgabe 25 |
Felder der Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
bookings | object[] | Die Buchungen dieser Seite, sortiert nach Anreisetag und Nummer. |
bookings[].ref | string | Buchungsnummer in der Form SB-JJMMTT-XXXX. |
bookings[].status | string | Zustand der Buchung, siehe Zustände. |
bookings[].source | string | Herkunft: web (Website), agent (aus einem Entwurf eines KI-Assistenten), admin (Büro) oder phone (Telefon). |
bookings[].locale | string | Sprache der Buchung. In ihr gehen Mails an den Gast. |
bookings[].guestName | string | Vor- und Nachname der buchenden Person. Nach dem Löschlauf steht hier nur noch die Kurzform, etwa „Martin B.“. |
bookings[].stay | object | Aufenthalt und Lieferadresse. |
bookings[].stay.arrivalOn | string | Anreisetag. |
bookings[].stay.departureOn | string | Abreisetag. |
bookings[].stay.rentalFrom | string | Erster Miettag. |
bookings[].stay.rentalDays | integer | Anzahl der Miettage.ab -9007199254740991 |
bookings[].stay.pickupAtDepot | boolean | true: der Gast holt im Shop ab, es gibt keine Lieferung. |
bookings[].stay.accommodation | object | Unterkunft, wie sie beim Buchen stand. Ändert der Betrieb später die Adresse, bleibt sie hier unverändert. |
bookings[].stay.accommodation.id | integer | null | ab -9007199254740991 |
bookings[].stay.accommodation.name | string | Name der Unterkunft. |
bookings[].stay.accommodation.street | string | Straße und Hausnummer. |
bookings[].stay.accommodation.zip | string | Postleitzahl. |
bookings[].stay.accommodation.city | string | Ort. |
bookings[].stay.rooms | string[] | Zimmernummern. Stehen auf dem Tagesauftrag des Fahrers. |
bookings[].persons | integer | Anzahl der Personen mit Leihausrüstung.ab -9007199254740991 |
bookings[].totals | object | Summen zum Buchungszeitpunkt. Eine spätere Preisänderung ändert sie nicht. |
bookings[].totals.totalCents | integer | Summe ohne Kaution, in Cent.ab -9007199254740991 |
bookings[].totals.depositCents | integer | Kaution, in Cent. Sie geht nach der Rückgabe vollständig zurück.ab -9007199254740991 |
bookings[].totals.vatCents | integer | In der Summe enthaltene Umsatzsteuer, in Cent.ab -9007199254740991 |
bookings[].totals.payableCents | integer | Zahlbetrag: Summe plus Kaution, in Cent.ab -9007199254740991 |
bookings[].totals.currency | string | Währung nach ISO 4217. |
bookings[].createdAt | string | Zeitpunkt des Anlegens. |
bookings[].confirmedAt | string,null | Zeitpunkt der Bestätigung. Ab dann gibt es die Aufträge. |
bookings[].cancelledAt | string,null | Zeitpunkt des Stornos, sonst null. |
bookings[].purged | boolean | true nach dem Löschlauf. Fehlende Gastdaten sind dann kein Fehler, sondern die Löschfrist. |
page | integer | Nummer der Seite, gezählt ab 1.ab -9007199254740991 |
perPage | integer | Einträge je Seite.ab -9007199254740991 |
total | integer | Anzahl aller Treffer.ab -9007199254740991 |
pages | integer | Anzahl der Seiten.ab -9007199254740991 |
curl "https://skirent.sumware.at/api/ext/v1/bookings?from=2026-12-27&to=2026-12-31&status=confirmed,paid&perPage=25" \ -H "Authorization: Bearer $SKI4ME_KEY"const res = await fetch("https://skirent.sumware.at/api/ext/v1/bookings?from=2026-12-27&to=2026-12-31&status=confirmed,paid&perPage=25", { headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, },});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import osimport requests
res = requests.get( "https://skirent.sumware.at/api/ext/v1/bookings", params={ "from": "2026-12-27", "to": "2026-12-31", "status": "confirmed,paid", "perPage": "25", }, headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skirent.sumware.at/api/ext/v1/bookings?from=2026-12-27&to=2026-12-31&status=confirmed,paid&perPage=25');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('SKI4ME_KEY'), ],]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
{ "bookings": [ { "ref": "SB-261114-WWNP", "status": "confirmed", "source": "web", "locale": "de", "guestName": "Martin Berger", "stay": { "arrivalOn": "2026-12-27", "departureOn": "2027-01-01", "rentalFrom": "2026-12-27", "rentalDays": 6, "pickupAtDepot": false, "accommodation": { "id": 2, "name": "Hotel Alpenhof", "street": "Dorfstraße 12", "zip": "5999", "city": "Bergdorf" }, "rooms": [] }, "persons": 3, "totals": { "totalCents": 58500, "depositCents": 0, "vatCents": 6500, "payableCents": 58500, "currency": "EUR" }, "createdAt": "2026-11-14T18:21:08.900Z", "confirmedAt": "2026-11-14T18:22:44.270Z", "cancelledAt": null, "absentAt": null, "purged": false } ], "page": 1, "perPage": 25, "total": 1, "pages": 1}Die Liste trägt je Buchung den Kopf: Zustand, Gast, Aufenthalt, Personenzahl und Summen. Positionen, Aufträge und Zahlungen stehen im Detail.
Sortiert ist nach Anreisetag, dann nach Nummer. Wer die Gäste eines Hauses sucht, filtert mit accommodation:
curl "https://skirent.sumware.at/api/ext/v1/bookings?from=2026-12-27&to=2026-12-27&accommodation=2" \ -H "Authorization: Bearer $SKI4ME_KEY"const res = await fetch("https://skirent.sumware.at/api/ext/v1/bookings?from=2026-12-27&to=2026-12-27&accommodation=2", { headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, },});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import osimport requests
res = requests.get( "https://skirent.sumware.at/api/ext/v1/bookings", params={"from": "2026-12-27", "to": "2026-12-27", "accommodation": "2"}, headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skirent.sumware.at/api/ext/v1/bookings?from=2026-12-27&to=2026-12-27&accommodation=2');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('SKI4ME_KEY'), ],]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Eine Buchung lesen
Abschnitt betitelt „Eine Buchung lesen“GET/api/ext/v1/bookings/{ref}
Nach dem Löschlauf steht customer auf null und purged auf true. Das ist kein Fehler, sondern die Löschfrist.
Im Pfad
| Parameter | Typ | Bedeutung |
|---|---|---|
ref | string | Die Buchungsnummer, etwa SB-261228-K7QA. |
Felder der Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
ref | string | Buchungsnummer in der Form SB-JJMMTT-XXXX. |
status | string | Zustand der Buchung, siehe Zustände. |
source | string | Herkunft: web (Website), agent (aus einem Entwurf eines KI-Assistenten), admin (Büro) oder phone (Telefon). |
locale | string | Sprache der Buchung. In ihr gehen Mails an den Gast. |
guestName | string | Vor- und Nachname der buchenden Person. Nach dem Löschlauf steht hier nur noch die Kurzform, etwa „Martin B.“. |
stay | object | Aufenthalt und Lieferadresse. |
stay.arrivalOn | string | Anreisetag. |
stay.departureOn | string | Abreisetag. |
stay.rentalFrom | string | Erster Miettag. |
stay.rentalDays | integer | Anzahl der Miettage.ab -9007199254740991 |
stay.pickupAtDepot | boolean | true: Abholung im Shop, keine Lieferung. |
stay.accommodation | object | Unterkunft, wie sie beim Buchen stand. Ändert der Betrieb später die Adresse, bleibt sie hier unverändert. |
stay.accommodation.id | integer | null | ab -9007199254740991 |
stay.accommodation.name | string | Name der Unterkunft. |
stay.accommodation.street | string | Straße und Hausnummer. |
stay.accommodation.zip | string | Postleitzahl. |
stay.accommodation.city | string | Ort. |
stay.rooms | string[] | Zimmernummern, falls bekannt. |
persons | integer | Anzahl der Personen mit Leihausrüstung.ab -9007199254740991 |
totals | object | Summen zum Buchungszeitpunkt. Eine spätere Preisänderung ändert sie nicht. |
totals.totalCents | integer | Summe ohne Kaution, in Cent.ab -9007199254740991 |
totals.depositCents | integer | Kaution, in Cent. Sie geht nach der Rückgabe vollständig zurück.ab -9007199254740991 |
totals.vatCents | integer | In der Summe enthaltene Umsatzsteuer, in Cent.ab -9007199254740991 |
totals.payableCents | integer | Zahlbetrag: Summe plus Kaution, in Cent.ab -9007199254740991 |
totals.currency | string | Währung nach ISO 4217. |
createdAt | string | Zeitpunkt des Anlegens. |
confirmedAt | string,null | Zeitpunkt der Bestätigung. Ab dann gibt es die Aufträge. |
cancelledAt | string,null | Zeitpunkt des Stornos, sonst null. |
purged | boolean | true nach dem Löschlauf. Fehlende Gastdaten sind dann kein Fehler, sondern die Löschfrist. |
customer | object | null | Kontaktdaten der buchenden Person. null nach dem Löschlauf. |
customer.firstName | string | Vorname. |
customer.lastName | string | Nachname. |
customer.email | string | E-Mail-Adresse. An sie geht die Bestätigung. |
customer.phone | string | Telefonnummer. |
customer.street | string | Straße und Hausnummer der Wohnadresse. |
customer.zip | string | Postleitzahl der Wohnadresse. |
customer.city | string | Ort der Wohnadresse. |
customer.note | string | Anmerkung des Gastes. |
personDetails | object[] | Je Person mit Leihausrüstung ein Eintrag. |
personDetails[].id | integer | Nummer der Person in dieser Buchung. Positionen verweisen mit personId darauf.ab -9007199254740991 |
personDetails[].sortOrder | integer | Reihenfolge innerhalb der Buchung.ab -9007199254740991 |
personDetails[].displayHint | string,null | Kurzform des Namens, etwa „Martin B.“. |
personDetails[].envelope | any | Angaben der Person wie im Portal: Name, Alter, Größe, Gewicht, Schuhgröße und Fahrertyp, dazu die geschätzte Sohlenlänge und die empfohlenen Z-Werte nach ISO 11088. null nach dem Löschlauf. |
personDetails[].bslSource | string,null | Woher die Sohlenlänge stammt, etwa mietschuh für den Leihschuh. |
personDetails[].bslMeasuredMm | number,null | Vom Monteur gemessene Sohlenlänge in Millimetern. |
personDetails[].zSet | number,null | Der Z-Wert, den der Monteur an der Bindung eingestellt hat. Der Wert im Umschlag ist dagegen eine Schätzung nach Norm. |
personDetails[].zSetBy | string,null | Wer den Z-Wert eingetragen hat. |
personDetails[].zSetAt | string,null | Wann der Z-Wert eingetragen wurde. |
lines | object[] | Positionen der Buchung, so wie sie berechnet wurden. |
lines[].id | integer | Nummer der Position.ab -9007199254740991 |
lines[].personId | integer | null | Person, zu der die Position gehört. null bei Positionen der ganzen Buchung, etwa einem Kurs oder der Lieferung.ab -9007199254740991 |
lines[].kind | string | Art der Position, siehe Arten von Positionen. |
lines[].label | string | Bezeichnung in der Sprache der Buchung. |
lines[].detail | string,null | Zusatz zur Bezeichnung, etwa die Dauer. |
lines[].days | integer | null | Miettage dieser Position.ab -9007199254740991 |
lines[].amountCents | integer | Betrag der Position in Cent. Nachlässe sind negativ.ab -9007199254740991 |
lines[].vatPercent | number,null | Umsatzsteuersatz. null bei durchlaufenden Posten wie einem vermittelten Kurs. |
jobs | object[] | Aufträge: Lieferung und Abholung. |
jobs[].id | integer | Nummer des Auftrags. Mit ihr melden Sie ihn als erledigt.ab -9007199254740991 |
jobs[].kind | string | delivery für die Lieferung, pickup für die Abholung. |
jobs[].onDate | string | Geplanter Tag. |
jobs[].status | string | open, done oder skipped. Ein übersprungener Auftrag gilt nicht als erledigt. |
jobs[].doneAt | string,null | Zeitpunkt, zu dem der Auftrag erledigt oder übersprungen wurde. |
jobs[].doneBy | string,null | Wer ihn gemeldet hat: der Name des Mitarbeiters oder des Schlüssels. |
jobs[].doneOnDate | string,null | Der Tourtag, an dem erledigt wurde. Den setzt der Server. |
jobs[].skipReason | string,null | Grund, wenn der Auftrag übersprungen wurde. |
jobs[].note | string,null | Notiz zum Auftrag. |
payments | object[] | Zahlungen zur Buchung, ohne Angaben zur Person. |
payments[].provider | string | Zahlungsweg. |
payments[].status | string | Zustand der Zahlung, etwa paid. |
payments[].amountCents | integer | Betrag in Cent.ab -9007199254740991 |
payments[].currency | string | Währung nach ISO 4217. |
sealCode | string,null | Prüfcode der Buchung. Mit ihm lässt sich belegen, dass eine Bestätigung zu dieser Buchung gehört, siehe Prüfcode. |
curl "https://skirent.sumware.at/api/ext/v1/bookings/SB-261114-WWNP" \ -H "Authorization: Bearer $SKI4ME_KEY"const res = await fetch("https://skirent.sumware.at/api/ext/v1/bookings/SB-261114-WWNP", { headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, },});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import osimport requests
res = requests.get( "https://skirent.sumware.at/api/ext/v1/bookings/SB-261114-WWNP", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skirent.sumware.at/api/ext/v1/bookings/SB-261114-WWNP');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('SKI4ME_KEY'), ],]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
Antwort anzeigen 325 Zeilen
{ "ref": "SB-261114-WWNP", "status": "confirmed", "source": "web", "locale": "de", "guestName": "Martin Berger", "stay": { "arrivalOn": "2026-12-27", "departureOn": "2027-01-01", "rentalFrom": "2026-12-27", "rentalDays": 6, "pickupAtDepot": false, "accommodation": { "id": 2, "name": "Hotel Alpenhof", "street": "Dorfstraße 12", "zip": "5999", "city": "Bergdorf" }, "rooms": [] }, "persons": 3, "totals": { "totalCents": 58500, "depositCents": 0, "vatCents": 6500, "payableCents": 58500, "currency": "EUR" }, "createdAt": "2026-11-14T18:21:08.900Z", "confirmedAt": "2026-11-14T18:22:44.270Z", "cancelledAt": null, "absentAt": null, "purged": false, "customer": { "firstName": "Martin", "lastName": "Berger", "email": "martin.berger@example.org", "phone": "+49 000 0000002", "street": "Lindenweg 7", "zip": "80331", "city": "München", "note": "Anreise am späten Nachmittag." }, "personDetails": [ { "id": 3, "sortOrder": 0, "displayHint": "Martin B.", "envelope": { "firstName": "Martin", "lastName": "Berger", "age": 41, "ageGroup": null, "heightCm": 182, "weightKg": 84, "shoeSize": "44", "headSize": null, "skierType": "II", "ownBoots": false, "bootSoleMm": null, "wideFeet": false, "bslMm": 330, "skierCode": "M", "zRows": [ { "fromMm": 291, "toMm": 310, "z": 7, "estimated": false }, { "fromMm": 311, "toMm": 330, "z": 6.5, "estimated": true }, { "fromMm": 331, "toMm": 350, "z": 6, "estimated": false } ] }, "bslSource": "mietschuh", "bslMeasuredMm": null, "zSet": null, "zSetBy": null, "zSetAt": null }, { "id": 4, "sortOrder": 1, "displayHint": "Julia B.", "envelope": { "firstName": "Julia", "lastName": "Berger", "age": 38, "ageGroup": null, "heightCm": 168, "weightKg": 62, "shoeSize": "38.5", "headSize": null, "skierType": "II", "ownBoots": false, "bootSoleMm": null, "wideFeet": false, "bslMm": 293, "skierCode": "K", "zRows": [ { "fromMm": 271, "toMm": 290, "z": 5.5, "estimated": false }, { "fromMm": 291, "toMm": 310, "z": 5, "estimated": true }, { "fromMm": 311, "toMm": 330, "z": 4.5, "estimated": false } ] }, "bslSource": "mietschuh", "bslMeasuredMm": null, "zSet": null, "zSetBy": null, "zSetAt": null }, { "id": 5, "sortOrder": 2, "displayHint": "Leon B.", "envelope": { "firstName": "Leon", "lastName": "Berger", "age": 11, "ageGroup": null, "heightCm": 146, "weightKg": 38, "shoeSize": "36", "headSize": "54", "skierType": "I", "ownBoots": false, "bootSoleMm": null, "wideFeet": false, "bslMm": 277, "skierCode": "G", "zRows": [ { "fromMm": 251, "toMm": 270, "z": 3, "estimated": false }, { "fromMm": 271, "toMm": 290, "z": 2.75, "estimated": true }, { "fromMm": 291, "toMm": 310, "z": 2.5, "estimated": false } ] }, "bslSource": "mietschuh", "bslMeasuredMm": null, "zSet": null, "zSetBy": null, "zSetAt": null } ], "lines": [ { "id": 5, "personId": 3, "kind": "equipment", "label": "Ski Comfort", "detail": "6 Tage", "days": 6, "amountCents": 11400, "vatPercent": 20 }, { "id": 6, "personId": 3, "kind": "equipment", "label": "Skischuhe Comfort", "detail": "6 Tage", "days": 6, "amountCents": 4500, "vatPercent": 20 }, { "id": 7, "personId": 3, "kind": "poles", "label": "Skistöcke", "detail": "inklusive", "days": 6, "amountCents": 0, "vatPercent": 20 }, { "id": 8, "personId": 4, "kind": "equipment", "label": "Ski Comfort", "detail": "6 Tage", "days": 6, "amountCents": 11400, "vatPercent": 20 }, { "id": 9, "personId": 4, "kind": "equipment", "label": "Skischuhe Comfort", "detail": "6 Tage", "days": 6, "amountCents": 4500, "vatPercent": 20 }, { "id": 10, "personId": 4, "kind": "poles", "label": "Skistöcke", "detail": "inklusive", "days": 6, "amountCents": 0, "vatPercent": 20 }, { "id": 11, "personId": 5, "kind": "equipment", "label": "Ski Comfort", "detail": "6 Tage", "days": 6, "amountCents": 5200, "vatPercent": 20 }, { "id": 12, "personId": 5, "kind": "equipment", "label": "Skischuhe Comfort", "detail": "6 Tage", "days": 6, "amountCents": 2000, "vatPercent": 20 }, { "id": 13, "personId": 5, "kind": "equipment", "label": "Helm", "detail": "6 Tage · Kinder bis 12 gratis", "days": 6, "amountCents": 0, "vatPercent": 20 }, { "id": 14, "personId": null, "kind": "course", "label": "Kinderkurs, 3 Tage", "detail": "3 Tage · 2.5 h · ab 10:00 Uhr", "days": 3, "amountCents": 19500, "vatPercent": null } ], "jobs": [ { "id": 3, "kind": "delivery", "onDate": "2026-12-27", "status": "open", "doneAt": null, "doneBy": null, "doneOnDate": null, "skipReason": null, "note": null }, { "id": 4, "kind": "pickup", "onDate": "2027-01-01", "status": "open", "doneAt": null, "doneBy": null, "doneOnDate": null, "skipReason": null, "note": null } ], "payments": [ { "provider": "demo", "status": "paid", "amountCents": 58500, "currency": "EUR", "cardBrand": "visa", "authorizedAt": "2026-11-14T18:22:44.270Z", "payoutRef": null, "payoutOn": null, "feeCents": 0 } ], "sealCode": "WJ58JVBE38"}Dieses Beispiel ist die Buchung der Familie Berger: drei Personen, je Person die Positionen der Ausrüstung, dazu ein vermittelter Kurs als eigene Position ohne Umsatzsteuersatz.
personDetails[].envelopeträgt die Angaben, die der Monteur braucht, um die Bindung einzustellen. Die Z-Werte darin sind eine Schätzung nach ISO 11088 und als solche gemeint. Den Wert, der wirklich eingestellt wurde, nenntzSet.jobssind Lieferung und Abholung. Ihreidbrauchen Sie, um einen Auftrag zu melden.paymentsnennt Fakten für den Abgleich. Was auf eine Person zeigt, etwa der Karteninhaber, steht nicht darin.
Eine Buchung anlegen
Abschnitt betitelt „Eine Buchung anlegen“POST/api/ext/v1/bookings
Ohne Zahlung, genau wie das Büro sie im Portal anlegt: der Betrieb rechnet selbst ab. Gerechnet wird aus den Positionen; Beträge im Rumpf werden verworfen. Die Buchung ist sofort bestätigt, und die beiden Aufträge entstehen mit.
Im Rumpf
| Feld | Typ | Bedeutung |
|---|---|---|
itemsPflicht | object[] | Positionen. Der Server rechnet den Preis aus ihnen; Beträge im Rumpf werden verworfen.mind. 1 · max. 50 Einträge |
items[].kindPflicht | "rental" | Art der Position. Für diesen Endpunkt rental. |
items[].id | string | Eigene Kennung der Position. Geben Sie jeder Position eine andere, etwa p1, p2.max. 40 Zeichen |
items[].fromPflicht | string | Erster Miettag dieser Person.JJJJ-MM-TT |
items[].daysPflicht | integer | Anzahl der Miettage.1 bis 60 |
items[].personPflicht | object | Die Person, die die Ausrüstung trägt. |
items[].person.firstName | string | Vorname.max. 60 Zeichen · Vorgabe `` |
items[].person.lastName | string | Nachname.max. 60 Zeichen · Vorgabe `` |
items[].person.age | integer | null | Alter in Jahren. Bestimmt das Preisband und den Gratishelm für Kinder.1 bis 110 |
items[].person.ageGroup | string | null | Altersgruppe statt des Alters, wo der Betrieb nur sie abfragt. Mit einer Zahl in age rechnet der Server mit der Zahl.Erlaubt: child, youth, adult, senior |
items[].person.heightCm | integer | null | Körpergröße in Zentimetern. Grundlage der Bindungseinstellung.60 bis 230 |
items[].person.weightKg | integer | null | Gewicht in Kilogramm. Grundlage der Bindungseinstellung.10 bis 250 |
items[].person.shoeSize | string | null | Schuhgröße (EU).max. 10 Zeichen |
items[].person.headSize | string | null | Kopfumfang oder Helmgröße.max. 10 Zeichen |
items[].person.skierType | string | null | Fahrertyp nach ISO 11088: I vorsichtig, II durchschnittlich, III sportlich.Erlaubt: I, II, III |
items[].person.ownBoots | boolean | true, wenn die Person eigene Skischuhe mitbringt.Vorgabe false |
items[].person.bootSoleMm | integer | null | Sohlenlänge der eigenen Schuhe in Millimetern, von der Sohle abgelesen.200 bis 400 |
items[].person.wideFeet | boolean | Hinweis für den Monteur: extra breiter Fuß.Vorgabe false |
items[].selections | object[] | Gewählte Modelle, je Kategorie eines.max. 10 Einträge |
items[].selections[].categoryCodePflicht | string | Code der Kategorie aus dem Katalog, etwa ski.max. 40 Zeichen |
items[].selections[].modelCodePflicht | string | Code des Modells aus dem Katalog, etwa ski-comfort.max. 40 Zeichen |
items[].poles | boolean | Skistöcke dazu. Zu Ski sind sie gratis.Vorgabe false |
items[].damageWaiver | boolean | Haftungsreduktion dazu, ein Prozentsatz vom Mietpreis.Vorgabe false |
items[].lateReturn | boolean | Rückgabe am nächsten Morgen statt am Abend, gegen Gebühr.Vorgabe false |
locale | string | Sprache der Buchung und der Mail an den Gast. Ohne Angabe die Standardsprache.max. 5 Zeichen |
customerPflicht | object | Die buchende Person. |
customer.firstNamePflicht | string | Vorname.mind. 1 Zeichen · max. 60 Zeichen |
customer.lastNamePflicht | string | Nachname.mind. 1 Zeichen · max. 60 Zeichen |
customer.email | any | E-Mail-Adresse. An sie geht die Bestätigung. |
customer.phone | string | Telefonnummer.max. 40 Zeichen |
customer.street | string | Straße und Hausnummer der Wohnadresse.max. 120 Zeichen |
customer.zip | string | Postleitzahl der Wohnadresse.max. 12 Zeichen |
customer.city | string | Ort der Wohnadresse.max. 80 Zeichen |
customer.country | string | Land der Wohnadresse, ISO 3166-1 alpha-2.genau 2 Zeichen · Vorgabe AT |
customer.note | string | Anmerkung des Gastes.max. 800 Zeichen |
stayPflicht | object | Aufenthalt und Lieferadresse. |
stay.accommodationId | integer | null | Nummer aus der Liste der Unterkünfte. Die Lieferadresse kommt immer aus dieser Liste.ab 1 |
stay.pickupAtDepot | boolean | true: Abholung im Shop, keine Lieferung.Vorgabe false |
stay.arrivalOnPflicht | string | Anreisetag.JJJJ-MM-TT |
stay.departureOnPflicht | string | Abreisetag.JJJJ-MM-TT |
stay.rooms | string[] | Zimmernummern, falls bekannt.max. 12 Einträge |
source | string | Herkunft für die Auswertung: admin für das Büro, phone für das Telefon.Erlaubt: phone, admin · Vorgabe admin |
Der kleinste Fall: ein Laufkunde am Tresen, eine Person, ein Tag, Abholung im Shop.
curl -X POST "https://skirent.sumware.at/api/ext/v1/bookings" \ -H "Authorization: Bearer $SKI4ME_KEY" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "kind": "rental", "id": "p1", "from": "2026-12-28", "days": 1, "person": { "firstName": "Tobias", "lastName": "Winkler", "age": 29, "heightCm": 178, "weightKg": 76, "shoeSize": "43", "skierType": "II" }, "selections": [ { "categoryCode": "ski", "modelCode": "ski-prime" } ], "poles": true } ], "customer": { "firstName": "Tobias", "lastName": "Winkler", "phone": "+43 000 000031" }, "stay": { "pickupAtDepot": true, "arrivalOn": "2026-12-28", "departureOn": "2026-12-28" }, "source": "admin" }'const res = await fetch("https://skirent.sumware.at/api/ext/v1/bookings", { method: "POST", headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ items: [ { kind: "rental", id: "p1", from: "2026-12-28", days: 1, person: { firstName: "Tobias", lastName: "Winkler", age: 29, heightCm: 178, weightKg: 76, shoeSize: "43", skierType: "II", }, selections: [ { categoryCode: "ski", modelCode: "ski-prime" }, ], poles: true, }, ], customer: { firstName: "Tobias", lastName: "Winkler", phone: "+43 000 000031" }, stay: { pickupAtDepot: true, arrivalOn: "2026-12-28", departureOn: "2026-12-28", }, source: "admin", }),});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import osimport requests
res = requests.post( "https://skirent.sumware.at/api/ext/v1/bookings", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, json={ "items": [ { "kind": "rental", "id": "p1", "from": "2026-12-28", "days": 1, "person": { "firstName": "Tobias", "lastName": "Winkler", "age": 29, "heightCm": 178, "weightKg": 76, "shoeSize": "43", "skierType": "II", }, "selections": [ {"categoryCode": "ski", "modelCode": "ski-prime"}, ], "poles": True, }, ], "customer": { "firstName": "Tobias", "lastName": "Winkler", "phone": "+43 000 000031", }, "stay": { "pickupAtDepot": True, "arrivalOn": "2026-12-28", "departureOn": "2026-12-28", }, "source": "admin", }, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skirent.sumware.at/api/ext/v1/bookings');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('SKI4ME_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'items' => [ [ 'kind' => 'rental', 'id' => 'p1', 'from' => '2026-12-28', 'days' => 1, 'person' => [ 'firstName' => 'Tobias', 'lastName' => 'Winkler', 'age' => 29, 'heightCm' => 178, 'weightKg' => 76, 'shoeSize' => '43', 'skierType' => 'II', ], 'selections' => [ ['categoryCode' => 'ski', 'modelCode' => 'ski-prime'], ], 'poles' => true, ], ], 'customer' => [ 'firstName' => 'Tobias', 'lastName' => 'Winkler', 'phone' => '+43 000 000031', ], 'stay' => [ 'pickupAtDepot' => true, 'arrivalOn' => '2026-12-28', 'departureOn' => '2026-12-28', ], 'source' => 'admin', ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort201Created
{ "ref": "SB-261227-7F4E", "status": "confirmed", "totalCents": 3000, "payableCents": 3000, "sealCode": "ZHZQYTN66L"}Zwei Personen mit Lieferung in eine Unterkunft:
curl -X POST "https://skirent.sumware.at/api/ext/v1/bookings" \ -H "Authorization: Bearer $SKI4ME_KEY" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "kind": "rental", "id": "p1", "from": "2026-12-27", "days": 6, "person": { "firstName": "Sophie", "lastName": "Lang", "age": 33, "heightCm": 170, "weightKg": 64, "shoeSize": "39", "skierType": "II" }, "selections": [ { "categoryCode": "snowboard", "modelCode": "snowboard-comfort" }, { "categoryCode": "softboots", "modelCode": "softboots" } ], "poles": false, "damageWaiver": false }, { "kind": "rental", "id": "p2", "from": "2026-12-27", "days": 6, "person": { "firstName": "Tom", "lastName": "Lang", "age": 35, "heightCm": 185, "weightKg": 88, "shoeSize": "45", "skierType": "III" }, "selections": [ { "categoryCode": "ski", "modelCode": "ski-superior" }, { "categoryCode": "skiboots", "modelCode": "skiboots-prime" } ], "poles": true, "damageWaiver": true } ], "locale": "de", "customer": { "firstName": "Sophie", "lastName": "Lang", "email": "sophie.lang@example.org", "phone": "+43 000 000003", "country": "AT", "note": "Am Tresen gebucht, Lieferung heute." }, "stay": { "accommodationId": 3, "arrivalOn": "2026-12-27", "departureOn": "2027-01-01", "rooms": [ "3" ] }, "source": "admin" }'const res = await fetch("https://skirent.sumware.at/api/ext/v1/bookings", { method: "POST", headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ items: [ { kind: "rental", id: "p1", from: "2026-12-27", days: 6, person: { firstName: "Sophie", lastName: "Lang", age: 33, heightCm: 170, weightKg: 64, shoeSize: "39", skierType: "II", }, selections: [ { categoryCode: "snowboard", modelCode: "snowboard-comfort" }, { categoryCode: "softboots", modelCode: "softboots" }, ], poles: false, damageWaiver: false, }, { kind: "rental", id: "p2", from: "2026-12-27", days: 6, person: { firstName: "Tom", lastName: "Lang", age: 35, heightCm: 185, weightKg: 88, shoeSize: "45", skierType: "III", }, selections: [ { categoryCode: "ski", modelCode: "ski-superior" }, { categoryCode: "skiboots", modelCode: "skiboots-prime" }, ], poles: true, damageWaiver: true, }, ], locale: "de", customer: { firstName: "Sophie", lastName: "Lang", email: "sophie.lang@example.org", phone: "+43 000 000003", country: "AT", note: "Am Tresen gebucht, Lieferung heute.", }, stay: { accommodationId: 3, arrivalOn: "2026-12-27", departureOn: "2027-01-01", rooms: ["3"], }, source: "admin", }),});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import osimport requests
res = requests.post( "https://skirent.sumware.at/api/ext/v1/bookings", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, json={ "items": [ { "kind": "rental", "id": "p1", "from": "2026-12-27", "days": 6, "person": { "firstName": "Sophie", "lastName": "Lang", "age": 33, "heightCm": 170, "weightKg": 64, "shoeSize": "39", "skierType": "II", }, "selections": [ {"categoryCode": "snowboard", "modelCode": "snowboard-comfort"}, {"categoryCode": "softboots", "modelCode": "softboots"}, ], "poles": False, "damageWaiver": False, }, { "kind": "rental", "id": "p2", "from": "2026-12-27", "days": 6, "person": { "firstName": "Tom", "lastName": "Lang", "age": 35, "heightCm": 185, "weightKg": 88, "shoeSize": "45", "skierType": "III", }, "selections": [ {"categoryCode": "ski", "modelCode": "ski-superior"}, {"categoryCode": "skiboots", "modelCode": "skiboots-prime"}, ], "poles": True, "damageWaiver": True, }, ], "locale": "de", "customer": { "firstName": "Sophie", "lastName": "Lang", "email": "sophie.lang@example.org", "phone": "+43 000 000003", "country": "AT", "note": "Am Tresen gebucht, Lieferung heute.", }, "stay": { "accommodationId": 3, "arrivalOn": "2026-12-27", "departureOn": "2027-01-01", "rooms": ["3"], }, "source": "admin", }, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skirent.sumware.at/api/ext/v1/bookings');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('SKI4ME_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'items' => [ [ 'kind' => 'rental', 'id' => 'p1', 'from' => '2026-12-27', 'days' => 6, 'person' => [ 'firstName' => 'Sophie', 'lastName' => 'Lang', 'age' => 33, 'heightCm' => 170, 'weightKg' => 64, 'shoeSize' => '39', 'skierType' => 'II', ], 'selections' => [ ['categoryCode' => 'snowboard', 'modelCode' => 'snowboard-comfort'], ['categoryCode' => 'softboots', 'modelCode' => 'softboots'], ], 'poles' => false, 'damageWaiver' => false, ], [ 'kind' => 'rental', 'id' => 'p2', 'from' => '2026-12-27', 'days' => 6, 'person' => [ 'firstName' => 'Tom', 'lastName' => 'Lang', 'age' => 35, 'heightCm' => 185, 'weightKg' => 88, 'shoeSize' => '45', 'skierType' => 'III', ], 'selections' => [ ['categoryCode' => 'ski', 'modelCode' => 'ski-superior'], ['categoryCode' => 'skiboots', 'modelCode' => 'skiboots-prime'], ], 'poles' => true, 'damageWaiver' => true, ], ], 'locale' => 'de', 'customer' => [ 'firstName' => 'Sophie', 'lastName' => 'Lang', 'email' => 'sophie.lang@example.org', 'phone' => '+43 000 000003', 'country' => 'AT', 'note' => 'Am Tresen gebucht, Lieferung heute.', ], 'stay' => [ 'accommodationId' => 3, 'arrivalOn' => '2026-12-27', 'departureOn' => '2027-01-01', 'rooms' => ['3'], ], 'source' => 'admin', ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort201Created
{ "ref": "SB-261227-ZA22", "status": "confirmed", "totalCents": 42300, "payableCents": 42300, "sealCode": "EB8D3EHMYU"}Was der Server daraus gerechnet hat, zeigen die Positionen im Detail dieser Buchung:
Antwort200OK
Antwort anzeigen 62 Zeilen
[ { "id": 15, "personId": 7, "kind": "equipment", "label": "Snowboard Comfort", "detail": "6 Tage", "days": 6, "amountCents": 11400, "vatPercent": 20 }, { "id": 16, "personId": 7, "kind": "equipment", "label": "Snowboard-Boots Softboots", "detail": "6 Tage", "days": 6, "amountCents": 4500, "vatPercent": 20 }, { "id": 17, "personId": 8, "kind": "equipment", "label": "Ski Superior", "detail": "6 Tage", "days": 6, "amountCents": 17400, "vatPercent": 20 }, { "id": 18, "personId": 8, "kind": "equipment", "label": "Skischuhe Prime", "detail": "6 Tage", "days": 6, "amountCents": 6600, "vatPercent": 20 }, { "id": 19, "personId": 8, "kind": "poles", "label": "Skistöcke", "detail": "inklusive", "days": 6, "amountCents": 0, "vatPercent": 20 }, { "id": 20, "personId": 8, "kind": "waiver", "label": "Materialversicherung", "detail": "10 % vom Mietpreis", "days": 6, "amountCents": 2400, "vatPercent": 20 }]Gezeigt ist der Teil lines der Antwort.
Worauf es ankommt:
- Jede Position trägt eine eigene
id, etwap1,p2. Über sie ordnet der Server die berechneten Zeilen den Personen zu. - Angelegt wird der Verleih. Senden Sie Positionen mit
kind: "rental". Kurse buchen Gäste auf der Website; gelesen werden sie unter Kurse. - Modelle kommen aus dem Katalog, die Unterkunft aus der Liste der Unterkünfte. Eine frei getippte Lieferadresse gibt es nicht.
- Beträge im Rumpf werden verworfen. Gerechnet wird aus den Positionen, mit derselben Preisliste wie auf der Website.
- Die Buchung ist sofort bestätigt, und Lieferung und Abholung entstehen als Aufträge mit. Das Büro bekommt eine Benachrichtigung über die neue Buchung, mit dem Namen des Schlüssels.
- Bezahlt wird nicht über die Schnittstelle. Der Betrieb rechnet selbst ab.
Je Schlüssel gehen 60 neue Buchungen in der Stunde.
Eine Buchung ändern
Abschnitt betitelt „Eine Buchung ändern“PATCH/api/ext/v1/bookings/{ref}
Beträge ändert dieser Weg nicht. Wer den Preis einer bezahlten Buchung korrigieren will, storniert und legt neu an. Ändert sich ein Datum, wandern die Aufträge mit.
Im Pfad
| Parameter | Typ | Bedeutung |
|---|---|---|
ref | string | Die Buchungsnummer, etwa SB-261228-K7QA. |
Im Rumpf
| Feld | Typ | Bedeutung |
|---|---|---|
arrivalOn | string | Anreisetag.JJJJ-MM-TT |
departureOn | string | Abreisetag.JJJJ-MM-TT |
accommodationId | integer | null | Nummer einer anderen Unterkunft aus der Liste.ab 1 |
pickupAtDepot | boolean | true: der Gast holt im Shop ab, es gibt keine Lieferung. |
rooms | string[] | Zimmernummern. Stehen auf dem Tagesauftrag des Fahrers.max. 12 Einträge |
internalNote | string | Notiz für das Büro. Der Gast sieht sie nicht.max. 2000 Zeichen |
guestNote | string | Anmerkung des Gastes.max. 800 Zeichen |
Das Hotel trägt die Zimmernummern nach:
curl -X PATCH "https://skirent.sumware.at/api/ext/v1/bookings/SB-261114-WWNP" \ -H "Authorization: Bearer $SKI4ME_KEY" \ -H "Content-Type: application/json" \ -d '{ "rooms": [ "204", "205" ], "guestNote": "Kinderzimmer ist 205." }'const res = await fetch("https://skirent.sumware.at/api/ext/v1/bookings/SB-261114-WWNP", { method: "PATCH", headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ rooms: ["204", "205"], guestNote: "Kinderzimmer ist 205.", }),});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import osimport requests
res = requests.patch( "https://skirent.sumware.at/api/ext/v1/bookings/SB-261114-WWNP", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, json={ "rooms": ["204", "205"], "guestNote": "Kinderzimmer ist 205.", }, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skirent.sumware.at/api/ext/v1/bookings/SB-261114-WWNP');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'PATCH', CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('SKI4ME_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'rooms' => ['204', '205'], 'guestNote' => 'Kinderzimmer ist 205.', ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
{ "ref": "SB-261114-WWNP", "changed": [ "rooms", "guestNote" ]}changed nennt die Felder, die sich wirklich geändert haben. Ändert sich ein Datum, wandern die Aufträge mit:
curl -X PATCH "https://skirent.sumware.at/api/ext/v1/bookings/SB-261227-ZA22" \ -H "Authorization: Bearer $SKI4ME_KEY" \ -H "Content-Type: application/json" \ -d '{ "departureOn": "2027-01-02", "internalNote": "Verlängert bis Samstag, am Tresen." }'const res = await fetch("https://skirent.sumware.at/api/ext/v1/bookings/SB-261227-ZA22", { method: "PATCH", headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ departureOn: "2027-01-02", internalNote: "Verlängert bis Samstag, am Tresen.", }),});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import osimport requests
res = requests.patch( "https://skirent.sumware.at/api/ext/v1/bookings/SB-261227-ZA22", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, json={ "departureOn": "2027-01-02", "internalNote": "Verlängert bis Samstag, am Tresen.", }, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skirent.sumware.at/api/ext/v1/bookings/SB-261227-ZA22');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'PATCH', CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('SKI4ME_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'departureOn' => '2027-01-02', 'internalNote' => 'Verlängert bis Samstag, am Tresen.', ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
{ "ref": "SB-261227-ZA22", "changed": [ "departureOn", "internalNote" ]}Ein leerer Rumpf ist ein Fehler:
Antwort400Bad Request
{ "error": { "code": "invalid_request", "message": "Feld (Rumpf): Nichts zu ändern.", "status": 400, "hint": "Die erwarteten Parameter stehen unter https://skirent.sumware.at/api/.", "documentation_url": "https://skirent.sumware.at/api/" }}Den Preis einer Buchung ändert dieser Weg nicht, und eine stornierte Buchung lässt sich nicht mehr ändern.
Stornovorschlag lesen
Abschnitt betitelt „Stornovorschlag lesen“GET/api/ext/v1/bookings/{ref}/cancel-proposal
Tage bis zum ersten Miettag, die greifende Stufe der Staffel und die Beträge. Ab dem ersten Miettag sind es immer 100 Prozent vom Mietanteil; die Kaution geht immer ganz zurück.
Im Pfad
| Parameter | Typ | Bedeutung |
|---|---|---|
ref | string | Die Buchungsnummer, etwa SB-261228-K7QA. |
Felder der Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
daysBefore | integer | Tage bis zum ersten Miettag.ab -9007199254740991 |
feePercent | number | Stornogebühr in Prozent vom Mietanteil, nach der Staffel der Preisliste. |
rentalCents | integer | Mietanteil der Buchung in Cent, ohne Kaution und ohne Kurse.ab -9007199254740991 |
feeCents | integer | Stornogebühr in Cent.ab -9007199254740991 |
rentalRefundCents | integer | Was vom Mietanteil zurückgeht, in Cent.ab -9007199254740991 |
depositRefundCents | integer | Was von der Kaution zurückgeht. Immer die ganze Kaution.ab -9007199254740991 |
courseCents | integer | Betrag der vermittelten Kurse in Cent.ab -9007199254740991 |
totalRefundCents | integer | Vorgeschlagene Rückzahlung insgesamt, in Cent.ab -9007199254740991 |
basis | string | staffel: nach der Staffel der Preisliste. ab_anreise: ab dem ersten Miettag, immer 100 Prozent. keine_staffel: die Preisliste hat keine.Erlaubt: staffel, ab_anreise, keine_staffel |
curl "https://skirent.sumware.at/api/ext/v1/bookings/SB-261112-WDZH/cancel-proposal" \ -H "Authorization: Bearer $SKI4ME_KEY"const res = await fetch("https://skirent.sumware.at/api/ext/v1/bookings/SB-261112-WDZH/cancel-proposal", { headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, },});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import osimport requests
res = requests.get( "https://skirent.sumware.at/api/ext/v1/bookings/SB-261112-WDZH/cancel-proposal", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skirent.sumware.at/api/ext/v1/bookings/SB-261112-WDZH/cancel-proposal');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('SKI4ME_KEY'), ],]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
{ "daysBefore": 37, "feePercent": 25, "rentalCents": 21000, "feeCents": 5250, "rentalRefundCents": 15750, "depositRefundCents": 0, "courseCents": 7900, "totalRefundCents": 15750, "basis": "staffel"}Der Vorschlag rechnet mit der Stornostaffel der Preisliste und mit denselben Zahlen, die das Portal im Dialog zeigt. Im Beispiel liegen 37 Tage vor dem ersten Miettag, und die Staffel dieses Betriebs sieht dafür 25 Prozent vor: vom Mietanteil von € 210,00 gehen € 157,50 zurück.
Ab dem ersten Miettag sind es immer 100 Prozent vom Mietanteil. Die Kaution geht immer ganz zurück.
Der Vorschlag ändert nichts. Er ist die Grundlage für den Betrag, den Sie beim Stornieren nennen.
Eine Buchung stornieren
Abschnitt betitelt „Eine Buchung stornieren“POST/api/ext/v1/bookings/{ref}/cancel
rentalRefundCents ist, was vom Mietanteil zurückgeht, zwischen null und dem Mietanteil; die Kaution kommt immer ganz dazu. Ein Schlüssel bewegt kein Geld: die Rückzahlung steht danach offen an der Buchung, und der Admin stößt sie im Portal an. Der Gast bekommt eine Stornobestätigung per Mail.
Im Pfad
| Parameter | Typ | Bedeutung |
|---|---|---|
ref | string | Die Buchungsnummer, etwa SB-261228-K7QA. |
Im Rumpf
| Feld | Typ | Bedeutung |
|---|---|---|
rentalRefundCentsPflicht | integer | Was vom Mietanteil zurückgeht, in Cent.ab 0 |
reasonPflicht | string | Grund des Stornos. Steht im Journal.mind. 3 Zeichen · max. 400 Zeichen |
Felder der Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
ref | string | Buchungsnummer in der Form SB-JJMMTT-XXXX. |
status | "cancelled" | Immer cancelled. |
feeCents | integer | Stornogebühr in Cent.ab -9007199254740991 |
rentalRefundCents | integer | Was vom Mietanteil zurückgeht, in Cent.ab -9007199254740991 |
depositCents | integer | Kaution, die zurückgeht.ab -9007199254740991 |
guestMailed | boolean | true, wenn die Stornobestätigung an den Gast hinausging. |
curl -X POST "https://skirent.sumware.at/api/ext/v1/bookings/SB-261112-WDZH/cancel" \ -H "Authorization: Bearer $SKI4ME_KEY" \ -H "Content-Type: application/json" \ -d '{ "rentalRefundCents": 15750, "reason": "Gast hat telefonisch abgesagt." }'const res = await fetch("https://skirent.sumware.at/api/ext/v1/bookings/SB-261112-WDZH/cancel", { method: "POST", headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ rentalRefundCents: 15750, reason: "Gast hat telefonisch abgesagt." }),});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import osimport requests
res = requests.post( "https://skirent.sumware.at/api/ext/v1/bookings/SB-261112-WDZH/cancel", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, json={"rentalRefundCents": 15750, "reason": "Gast hat telefonisch abgesagt."}, timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skirent.sumware.at/api/ext/v1/bookings/SB-261112-WDZH/cancel');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('SKI4ME_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'rentalRefundCents' => 15750, 'reason' => 'Gast hat telefonisch abgesagt.', ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);Antwort200OK
{ "ref": "SB-261112-WDZH", "status": "cancelled", "feeCents": 5250, "rentalRefundCents": 15750, "depositCents": 0, "guestMailed": true}rentalRefundCentslegen Sie fest: zwischen null und dem Mietanteil. Wer der Staffel folgt, nimmt den Wert aus dem Vorschlag.- Die Kaution geht immer ganz zurück und steht nicht zur Wahl.
- Geld bewegt der Aufruf nicht. Die Rückzahlung steht danach offen an der Buchung, und der Admin stößt sie im Portal an.
- Der Gast bekommt eine Stornobestätigung per Mail;
guestMailedsagt, ob sie hinausging. - Hängt ein vermittelter Kurs an der Buchung, erfährt es die Skischule als Meldung
course.cancelled.
Ein zweites Storno derselben Buchung ist ein Widerspruch zum Stand:
Antwort409Conflict
{ "error": { "code": "conflict", "message": "Diese Buchung ist schon storniert.", "status": 409, "hint": "Im Verlauf steht, wann und von wem.", "documentation_url": "https://skirent.sumware.at/api/" }}