Zum Inhalt springen

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.

GET/api/ext/v1/bookings

Recht booking.viewErfolg 200

Der Zeitraum bezieht sich auf den Anreisetag und nicht auf das Buchungsdatum. Eine Freitextsuche gibt es hier nicht.

In der Abfrage

ParameterTypBedeutung
statusstringEin Zustand oder mehrere, durch Komma getrennt, etwa confirmed,delivered.max. 200 Zeichen
fromstringAnreisetag ab diesem Tag.JJJJ-MM-TT
tostringAnreisetag bis zu diesem Tag.JJJJ-MM-TT
accommodationintegerNur Buchungen dieser Unterkunft.ab 1
pageintegerSeite, gezählt ab 1.1 bis 500 · Vorgabe 1
perPageintegerEinträge je Seite.1 bis 100 · Vorgabe 25
Felder der Antwort
FeldTypBedeutung
bookingsobject[]Die Buchungen dieser Seite, sortiert nach Anreisetag und Nummer.
bookings[].refstringBuchungsnummer in der Form SB-JJMMTT-XXXX.
bookings[].statusstringZustand der Buchung, siehe Zustände.
bookings[].sourcestringHerkunft: web (Website), agent (aus einem Entwurf eines KI-Assistenten), admin (Büro) oder phone (Telefon).
bookings[].localestringSprache der Buchung. In ihr gehen Mails an den Gast.
bookings[].guestNamestringVor- und Nachname der buchenden Person. Nach dem Löschlauf steht hier nur noch die Kurzform, etwa „Martin B.“.
bookings[].stayobjectAufenthalt und Lieferadresse.
bookings[].stay.arrivalOnstringAnreisetag.
bookings[].stay.departureOnstringAbreisetag.
bookings[].stay.rentalFromstringErster Miettag.
bookings[].stay.rentalDaysintegerAnzahl der Miettage.ab -9007199254740991
bookings[].stay.pickupAtDepotbooleantrue: der Gast holt im Shop ab, es gibt keine Lieferung.
bookings[].stay.accommodationobjectUnterkunft, wie sie beim Buchen stand. Ändert der Betrieb später die Adresse, bleibt sie hier unverändert.
bookings[].stay.accommodation.idinteger | nullab -9007199254740991
bookings[].stay.accommodation.namestringName der Unterkunft.
bookings[].stay.accommodation.streetstringStraße und Hausnummer.
bookings[].stay.accommodation.zipstringPostleitzahl.
bookings[].stay.accommodation.citystringOrt.
bookings[].stay.roomsstring[]Zimmernummern. Stehen auf dem Tagesauftrag des Fahrers.
bookings[].personsintegerAnzahl der Personen mit Leihausrüstung.ab -9007199254740991
bookings[].totalsobjectSummen zum Buchungszeitpunkt. Eine spätere Preisänderung ändert sie nicht.
bookings[].totals.totalCentsintegerSumme ohne Kaution, in Cent.ab -9007199254740991
bookings[].totals.depositCentsintegerKaution, in Cent. Sie geht nach der Rückgabe vollständig zurück.ab -9007199254740991
bookings[].totals.vatCentsintegerIn der Summe enthaltene Umsatzsteuer, in Cent.ab -9007199254740991
bookings[].totals.payableCentsintegerZahlbetrag: Summe plus Kaution, in Cent.ab -9007199254740991
bookings[].totals.currencystringWährung nach ISO 4217.
bookings[].createdAtstringZeitpunkt des Anlegens.
bookings[].confirmedAtstring,nullZeitpunkt der Bestätigung. Ab dann gibt es die Aufträge.
bookings[].cancelledAtstring,nullZeitpunkt des Stornos, sonst null.
bookings[].purgedbooleantrue nach dem Löschlauf. Fehlende Gastdaten sind dann kein Fehler, sondern die Löschfrist.
pageintegerNummer der Seite, gezählt ab 1.ab -9007199254740991
perPageintegerEinträge je Seite.ab -9007199254740991
totalintegerAnzahl aller Treffer.ab -9007199254740991
pagesintegerAnzahl der Seiten.ab -9007199254740991
Terminal-Fenster
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"

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:

Terminal-Fenster
curl "https://skirent.sumware.at/api/ext/v1/bookings?from=2026-12-27&to=2026-12-27&accommodation=2" \
-H "Authorization: Bearer $SKI4ME_KEY"

GET/api/ext/v1/bookings/{ref}

Recht booking.viewErfolg 200

Nach dem Löschlauf steht customer auf null und purged auf true. Das ist kein Fehler, sondern die Löschfrist.

Im Pfad

ParameterTypBedeutung
refstringDie Buchungsnummer, etwa SB-261228-K7QA.
Felder der Antwort
FeldTypBedeutung
refstringBuchungsnummer in der Form SB-JJMMTT-XXXX.
statusstringZustand der Buchung, siehe Zustände.
sourcestringHerkunft: web (Website), agent (aus einem Entwurf eines KI-Assistenten), admin (Büro) oder phone (Telefon).
localestringSprache der Buchung. In ihr gehen Mails an den Gast.
guestNamestringVor- und Nachname der buchenden Person. Nach dem Löschlauf steht hier nur noch die Kurzform, etwa „Martin B.“.
stayobjectAufenthalt und Lieferadresse.
stay.arrivalOnstringAnreisetag.
stay.departureOnstringAbreisetag.
stay.rentalFromstringErster Miettag.
stay.rentalDaysintegerAnzahl der Miettage.ab -9007199254740991
stay.pickupAtDepotbooleantrue: Abholung im Shop, keine Lieferung.
stay.accommodationobjectUnterkunft, wie sie beim Buchen stand. Ändert der Betrieb später die Adresse, bleibt sie hier unverändert.
stay.accommodation.idinteger | nullab -9007199254740991
stay.accommodation.namestringName der Unterkunft.
stay.accommodation.streetstringStraße und Hausnummer.
stay.accommodation.zipstringPostleitzahl.
stay.accommodation.citystringOrt.
stay.roomsstring[]Zimmernummern, falls bekannt.
personsintegerAnzahl der Personen mit Leihausrüstung.ab -9007199254740991
totalsobjectSummen zum Buchungszeitpunkt. Eine spätere Preisänderung ändert sie nicht.
totals.totalCentsintegerSumme ohne Kaution, in Cent.ab -9007199254740991
totals.depositCentsintegerKaution, in Cent. Sie geht nach der Rückgabe vollständig zurück.ab -9007199254740991
totals.vatCentsintegerIn der Summe enthaltene Umsatzsteuer, in Cent.ab -9007199254740991
totals.payableCentsintegerZahlbetrag: Summe plus Kaution, in Cent.ab -9007199254740991
totals.currencystringWährung nach ISO 4217.
createdAtstringZeitpunkt des Anlegens.
confirmedAtstring,nullZeitpunkt der Bestätigung. Ab dann gibt es die Aufträge.
cancelledAtstring,nullZeitpunkt des Stornos, sonst null.
purgedbooleantrue nach dem Löschlauf. Fehlende Gastdaten sind dann kein Fehler, sondern die Löschfrist.
customerobject | nullKontaktdaten der buchenden Person. null nach dem Löschlauf.
customer.firstNamestringVorname.
customer.lastNamestringNachname.
customer.emailstringE-Mail-Adresse. An sie geht die Bestätigung.
customer.phonestringTelefonnummer.
customer.streetstringStraße und Hausnummer der Wohnadresse.
customer.zipstringPostleitzahl der Wohnadresse.
customer.citystringOrt der Wohnadresse.
customer.notestringAnmerkung des Gastes.
personDetailsobject[]Je Person mit Leihausrüstung ein Eintrag.
personDetails[].idintegerNummer der Person in dieser Buchung. Positionen verweisen mit personId darauf.ab -9007199254740991
personDetails[].sortOrderintegerReihenfolge innerhalb der Buchung.ab -9007199254740991
personDetails[].displayHintstring,nullKurzform des Namens, etwa „Martin B.“.
personDetails[].envelopeanyAngaben 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[].bslSourcestring,nullWoher die Sohlenlänge stammt, etwa mietschuh für den Leihschuh.
personDetails[].bslMeasuredMmnumber,nullVom Monteur gemessene Sohlenlänge in Millimetern.
personDetails[].zSetnumber,nullDer Z-Wert, den der Monteur an der Bindung eingestellt hat. Der Wert im Umschlag ist dagegen eine Schätzung nach Norm.
personDetails[].zSetBystring,nullWer den Z-Wert eingetragen hat.
personDetails[].zSetAtstring,nullWann der Z-Wert eingetragen wurde.
linesobject[]Positionen der Buchung, so wie sie berechnet wurden.
lines[].idintegerNummer der Position.ab -9007199254740991
lines[].personIdinteger | nullPerson, zu der die Position gehört. null bei Positionen der ganzen Buchung, etwa einem Kurs oder der Lieferung.ab -9007199254740991
lines[].kindstringArt der Position, siehe Arten von Positionen.
lines[].labelstringBezeichnung in der Sprache der Buchung.
lines[].detailstring,nullZusatz zur Bezeichnung, etwa die Dauer.
lines[].daysinteger | nullMiettage dieser Position.ab -9007199254740991
lines[].amountCentsintegerBetrag der Position in Cent. Nachlässe sind negativ.ab -9007199254740991
lines[].vatPercentnumber,nullUmsatzsteuersatz. null bei durchlaufenden Posten wie einem vermittelten Kurs.
jobsobject[]Aufträge: Lieferung und Abholung.
jobs[].idintegerNummer des Auftrags. Mit ihr melden Sie ihn als erledigt.ab -9007199254740991
jobs[].kindstringdelivery für die Lieferung, pickup für die Abholung.
jobs[].onDatestringGeplanter Tag.
jobs[].statusstringopen, done oder skipped. Ein übersprungener Auftrag gilt nicht als erledigt.
jobs[].doneAtstring,nullZeitpunkt, zu dem der Auftrag erledigt oder übersprungen wurde.
jobs[].doneBystring,nullWer ihn gemeldet hat: der Name des Mitarbeiters oder des Schlüssels.
jobs[].doneOnDatestring,nullDer Tourtag, an dem erledigt wurde. Den setzt der Server.
jobs[].skipReasonstring,nullGrund, wenn der Auftrag übersprungen wurde.
jobs[].notestring,nullNotiz zum Auftrag.
paymentsobject[]Zahlungen zur Buchung, ohne Angaben zur Person.
payments[].providerstringZahlungsweg.
payments[].statusstringZustand der Zahlung, etwa paid.
payments[].amountCentsintegerBetrag in Cent.ab -9007199254740991
payments[].currencystringWährung nach ISO 4217.
sealCodestring,nullPrüfcode der Buchung. Mit ihm lässt sich belegen, dass eine Bestätigung zu dieser Buchung gehört, siehe Prüfcode.
Terminal-Fenster
curl "https://skirent.sumware.at/api/ext/v1/bookings/SB-261114-WWNP" \
-H "Authorization: Bearer $SKI4ME_KEY"

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[].envelope trä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, nennt zSet.
  • jobs sind Lieferung und Abholung. Ihre id brauchen Sie, um einen Auftrag zu melden.
  • payments nennt Fakten für den Abgleich. Was auf eine Person zeigt, etwa der Karteninhaber, steht nicht darin.

POST/api/ext/v1/bookings

Recht booking.createErfolg 201

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

FeldTypBedeutung
itemsPflichtobject[]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[].idstringEigene Kennung der Position. Geben Sie jeder Position eine andere, etwa p1, p2.max. 40 Zeichen
items[].fromPflichtstringErster Miettag dieser Person.JJJJ-MM-TT
items[].daysPflichtintegerAnzahl der Miettage.1 bis 60
items[].personPflichtobjectDie Person, die die Ausrüstung trägt.
items[].person.firstNamestringVorname.max. 60 Zeichen · Vorgabe ``
items[].person.lastNamestringNachname.max. 60 Zeichen · Vorgabe ``
items[].person.ageinteger | nullAlter in Jahren. Bestimmt das Preisband und den Gratishelm für Kinder.1 bis 110
items[].person.ageGroupstring | nullAltersgruppe 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.heightCminteger | nullKörpergröße in Zentimetern. Grundlage der Bindungseinstellung.60 bis 230
items[].person.weightKginteger | nullGewicht in Kilogramm. Grundlage der Bindungseinstellung.10 bis 250
items[].person.shoeSizestring | nullSchuhgröße (EU).max. 10 Zeichen
items[].person.headSizestring | nullKopfumfang oder Helmgröße.max. 10 Zeichen
items[].person.skierTypestring | nullFahrertyp nach ISO 11088: I vorsichtig, II durchschnittlich, III sportlich.Erlaubt: I, II, III
items[].person.ownBootsbooleantrue, wenn die Person eigene Skischuhe mitbringt.Vorgabe false
items[].person.bootSoleMminteger | nullSohlenlänge der eigenen Schuhe in Millimetern, von der Sohle abgelesen.200 bis 400
items[].person.wideFeetbooleanHinweis für den Monteur: extra breiter Fuß.Vorgabe false
items[].selectionsobject[]Gewählte Modelle, je Kategorie eines.max. 10 Einträge
items[].selections[].categoryCodePflichtstringCode der Kategorie aus dem Katalog, etwa ski.max. 40 Zeichen
items[].selections[].modelCodePflichtstringCode des Modells aus dem Katalog, etwa ski-comfort.max. 40 Zeichen
items[].polesbooleanSkistöcke dazu. Zu Ski sind sie gratis.Vorgabe false
items[].damageWaiverbooleanHaftungsreduktion dazu, ein Prozentsatz vom Mietpreis.Vorgabe false
items[].lateReturnbooleanRückgabe am nächsten Morgen statt am Abend, gegen Gebühr.Vorgabe false
localestringSprache der Buchung und der Mail an den Gast. Ohne Angabe die Standardsprache.max. 5 Zeichen
customerPflichtobjectDie buchende Person.
customer.firstNamePflichtstringVorname.mind. 1 Zeichen · max. 60 Zeichen
customer.lastNamePflichtstringNachname.mind. 1 Zeichen · max. 60 Zeichen
customer.emailanyE-Mail-Adresse. An sie geht die Bestätigung.
customer.phonestringTelefonnummer.max. 40 Zeichen
customer.streetstringStraße und Hausnummer der Wohnadresse.max. 120 Zeichen
customer.zipstringPostleitzahl der Wohnadresse.max. 12 Zeichen
customer.citystringOrt der Wohnadresse.max. 80 Zeichen
customer.countrystringLand der Wohnadresse, ISO 3166-1 alpha-2.genau 2 Zeichen · Vorgabe AT
customer.notestringAnmerkung des Gastes.max. 800 Zeichen
stayPflichtobjectAufenthalt und Lieferadresse.
stay.accommodationIdinteger | nullNummer aus der Liste der Unterkünfte. Die Lieferadresse kommt immer aus dieser Liste.ab 1
stay.pickupAtDepotbooleantrue: Abholung im Shop, keine Lieferung.Vorgabe false
stay.arrivalOnPflichtstringAnreisetag.JJJJ-MM-TT
stay.departureOnPflichtstringAbreisetag.JJJJ-MM-TT
stay.roomsstring[]Zimmernummern, falls bekannt.max. 12 Einträge
sourcestringHerkunft 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.

Terminal-Fenster
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"
}'

Antwort201Created

{
"ref": "SB-261227-7F4E",
"status": "confirmed",
"totalCents": 3000,
"payableCents": 3000,
"sealCode": "ZHZQYTN66L"
}

Zwei Personen mit Lieferung in eine Unterkunft:

Terminal-Fenster
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"
}'

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, etwa p1, 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.

PATCH/api/ext/v1/bookings/{ref}

Recht booking.editErfolg 200

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

ParameterTypBedeutung
refstringDie Buchungsnummer, etwa SB-261228-K7QA.

Im Rumpf

FeldTypBedeutung
arrivalOnstringAnreisetag.JJJJ-MM-TT
departureOnstringAbreisetag.JJJJ-MM-TT
accommodationIdinteger | nullNummer einer anderen Unterkunft aus der Liste.ab 1
pickupAtDepotbooleantrue: der Gast holt im Shop ab, es gibt keine Lieferung.
roomsstring[]Zimmernummern. Stehen auf dem Tagesauftrag des Fahrers.max. 12 Einträge
internalNotestringNotiz für das Büro. Der Gast sieht sie nicht.max. 2000 Zeichen
guestNotestringAnmerkung des Gastes.max. 800 Zeichen

Das Hotel trägt die Zimmernummern nach:

Terminal-Fenster
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."
}'

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:

Terminal-Fenster
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."
}'

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.

GET/api/ext/v1/bookings/{ref}/cancel-proposal

Recht booking.cancelErfolg 200

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

ParameterTypBedeutung
refstringDie Buchungsnummer, etwa SB-261228-K7QA.
Felder der Antwort
FeldTypBedeutung
daysBeforeintegerTage bis zum ersten Miettag.ab -9007199254740991
feePercentnumberStornogebühr in Prozent vom Mietanteil, nach der Staffel der Preisliste.
rentalCentsintegerMietanteil der Buchung in Cent, ohne Kaution und ohne Kurse.ab -9007199254740991
feeCentsintegerStornogebühr in Cent.ab -9007199254740991
rentalRefundCentsintegerWas vom Mietanteil zurückgeht, in Cent.ab -9007199254740991
depositRefundCentsintegerWas von der Kaution zurückgeht. Immer die ganze Kaution.ab -9007199254740991
courseCentsintegerBetrag der vermittelten Kurse in Cent.ab -9007199254740991
totalRefundCentsintegerVorgeschlagene Rückzahlung insgesamt, in Cent.ab -9007199254740991
basisstringstaffel: 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
Terminal-Fenster
curl "https://skirent.sumware.at/api/ext/v1/bookings/SB-261112-WDZH/cancel-proposal" \
-H "Authorization: Bearer $SKI4ME_KEY"

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.

POST/api/ext/v1/bookings/{ref}/cancel

Recht booking.cancelErfolg 200

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

ParameterTypBedeutung
refstringDie Buchungsnummer, etwa SB-261228-K7QA.

Im Rumpf

FeldTypBedeutung
rentalRefundCentsPflichtintegerWas vom Mietanteil zurückgeht, in Cent.ab 0
reasonPflichtstringGrund des Stornos. Steht im Journal.mind. 3 Zeichen · max. 400 Zeichen
Felder der Antwort
FeldTypBedeutung
refstringBuchungsnummer in der Form SB-JJMMTT-XXXX.
status"cancelled"Immer cancelled.
feeCentsintegerStornogebühr in Cent.ab -9007199254740991
rentalRefundCentsintegerWas vom Mietanteil zurückgeht, in Cent.ab -9007199254740991
depositCentsintegerKaution, die zurückgeht.ab -9007199254740991
guestMailedbooleantrue, wenn die Stornobestätigung an den Gast hinausging.
Terminal-Fenster
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."
}'

Antwort200OK

{
"ref": "SB-261112-WDZH",
"status": "cancelled",
"feeCents": 5250,
"rentalRefundCents": 15750,
"depositCents": 0,
"guestMailed": true
}
  • rentalRefundCents legen 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; guestMailed sagt, 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/"
}
}