Zum Inhalt springen

Integrationen

Kassensystem

Ein Kassensystem, das ein Betrieb schon hat, legt Buchungen an, die am Tresen entstehen: ein Laufkunde will für morgen Ski, bezahlt an der Kasse, und die Ausrüstung soll auf dem Tagesauftrag stehen wie jede andere.

Recht Wofür
price.view Katalog und Preise lesen
day.view Unterkünfte lesen
booking.create Buchungen anlegen
booking.view angelegte Buchungen lesen
booking.cancel Buchungen stornieren
accommodation.edit nur, wenn die Kasse die Liste der Unterkünfte pflegt

Einmal am Tag reicht. Aus dem Katalog kommen die Codes der Kategorien und Modelle und die Preise für die Anzeige.

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

Der Katalog rechnet für die Miettage, die Sie in days nennen. Für eine Preisauskunft über mehrere Dauern lesen Sie die Leitern unter ladders, siehe Katalog und Preise.

Wird geliefert, kommt die Unterkunft aus der Liste des Betriebs:

Terminal-Fenster
curl "https://skirent.sumware.at/api/ext/v1/accommodations?q=Dorfstra%C3%9Fe&limit=10" \
-H "Authorization: Bearer $SKI4ME_KEY"

Holt der Kunde selbst ab, setzen Sie stay.pickupAtDepot auf true und lassen die Unterkunft weg.

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"
}

Die Antwort nennt die Buchungsnummer und den Betrag, den der Server gerechnet hat. Kassieren Sie payableCents, nicht einen Betrag, den die Kasse selbst gerechnet hat: so stimmen Kasse und Buchung überein.

Mit mehreren Personen und Lieferung:

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

Die Regeln dazu stehen unter Eine Buchung anlegen. Die drei wichtigsten:

  • Jede Position bekommt eine eigene id.
  • Senden Sie Positionen mit kind: "rental".
  • Beträge im Rumpf werden verworfen.

Die Buchungsnummer gehört auf den Kassenbeleg. Mit ihr findet das Büro die Buchung im Portal, und der Kunde kann sich auf sie berufen.

Über die Schnittstelle wird nicht bezahlt, und eine Zahlung lässt sich dort auch nicht vermerken. Eine Buchung, die die Kasse anlegt, gilt im Portal als offen, bis das Büro sie als vor Ort bezahlt vermerkt.

Das gilt auch, wenn ein Fahrer bei der Übergabe im Hotel kassiert: die Zahlung läuft über die Kasse des Betriebs, der Vermerk an der Buchung entsteht im Portal.

Erst den Vorschlag nach der Staffel lesen, dann stornieren:

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"
}
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
}

Geld bewegt der Aufruf nicht. Hat die Kasse das Geld eingenommen, zahlt die Kasse zurück; bei einer online bezahlten Buchung stößt der Admin die Rückzahlung im Portal an.

Führt die Kasse eine eigene Liste von Häusern, kann sie die des Betriebs pflegen: anlegen, ändern, entfernen.

  • Geben Sie placeId mit, wenn Sie eine haben. Dann antwortet der Server bei einer Dublette mit 409 statt sie anzulegen.
  • Senden Sie beim Ändern street, zip und city immer mit.
  • Ein Haus mit Buchungen wird beim Entfernen stillgelegt, nicht gelöscht.

Je Schlüssel gehen 60 neue Buchungen in der Stunde und 600 Anfragen in der Minute. Für einen Tresen ist das weit mehr als nötig. Eine Kasse, die Buchungen aus einem anderen System in großer Zahl einspielen soll, verteilt sie über die Zeit.