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.
Schlüssel und Rechte
Abschnitt betitelt „Schlüssel und Rechte“| 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 |
Ablauf am Tresen
Abschnitt betitelt „Ablauf am Tresen“1. Katalog laden
Abschnitt betitelt „1. Katalog laden“Einmal am Tag reicht. Aus dem Katalog kommen die Codes der Kategorien und Modelle und die Preise für die Anzeige.
curl "https://skirent.sumware.at/api/ext/v1/catalog?from=2026-12-27&days=6" \ -H "Authorization: Bearer $SKI4ME_KEY"const res = await fetch("https://skirent.sumware.at/api/ext/v1/catalog?from=2026-12-27&days=6", { 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/catalog", params={"from": "2026-12-27", "days": "6"}, 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/catalog?from=2026-12-27&days=6');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);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.
2. Unterkunft wählen oder Abholung
Abschnitt betitelt „2. Unterkunft wählen oder Abholung“Wird geliefert, kommt die Unterkunft aus der Liste des Betriebs:
curl "https://skirent.sumware.at/api/ext/v1/accommodations?q=Dorfstra%C3%9Fe&limit=10" \ -H "Authorization: Bearer $SKI4ME_KEY"const res = await fetch("https://skirent.sumware.at/api/ext/v1/accommodations?q=Dorfstra%C3%9Fe&limit=10", { 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/accommodations", params={"q": "Dorfstraße", "limit": "10"}, 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/accommodations?q=Dorfstra%C3%9Fe&limit=10');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);Holt der Kunde selbst ab, setzen Sie stay.pickupAtDepot auf true und lassen die Unterkunft weg.
3. Buchung anlegen
Abschnitt betitelt „3. Buchung anlegen“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"}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:
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);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.
4. Beleg
Abschnitt betitelt „4. Beleg“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.
Zahlung
Abschnitt betitelt „Zahlung“Ü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:
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"}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}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.
Abgleich der Unterkünfte
Abschnitt betitelt „Abgleich der Unterkünfte“Führt die Kasse eine eigene Liste von Häusern, kann sie die des Betriebs pflegen: anlegen, ändern, entfernen.
- Geben Sie
placeIdmit, wenn Sie eine haben. Dann antwortet der Server bei einer Dublette mit 409 statt sie anzulegen. - Senden Sie beim Ändern
street,zipundcityimmer 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.