Integrationen
Hotel
Ein Hotel will zwei Dinge wissen: Welche Gäste bekommen heute Ausrüstung, und ist sie schon da. Dazu will es eine Sache beitragen: die Zimmernummer, damit der Fahrer nicht an der Rezeption fragen muss.
Schlüssel und Rechte
Abschnitt betitelt „Schlüssel und Rechte“Der Skiverleih legt im Portal unter Schnittstelle einen Schlüssel für das Haus an.
| Recht | Wofür |
|---|---|
day.view |
Tour und Zustellstatus lesen, Unterkünfte lesen |
booking.edit |
Zimmernummern nachtragen |
Eigene Unterkunft ermitteln
Abschnitt betitelt „Eigene Unterkunft ermitteln“Einmal bei der Einrichtung: die Nummer des eigenen Hauses in 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);Antwort200OK
{ "accommodations": [ { "id": 6, "name": "Gasthof Talblick", "street": "Dorfstraße 30", "zip": "5999", "city": "Bergdorf", "country": "AT", "district": "Unterdorf", "lat": 47.2488, "lng": 13.2052, "placeId": null, "contactName": null, "contactPhone": null, "driverNote": null, "isDepot": false, "active": true, "bookingCount": 0 }, { "id": 2, "name": "Hotel Alpenhof", "street": "Dorfstraße 12", "zip": "5999", "city": "Bergdorf", "country": "AT", "district": "Oberdorf", "lat": 47.2533, "lng": 13.2071, "placeId": "ChIJalpenhofBergdorf0001", "contactName": "Rezeption", "contactPhone": "+43 000 000010", "driverNote": "Skiraum im Untergeschoss, Zugang über die Garage.", "isDepot": false, "active": true, "bookingCount": 0 } ]}Merken Sie sich die id. Sie bleibt gleich, auch wenn der Betrieb Namen oder Adresse ändert.
Zustellstatus abfragen
Abschnitt betitelt „Zustellstatus abfragen“curl "https://skirent.sumware.at/api/ext/v1/days/2026-12-27" \ -H "Authorization: Bearer $SKI4ME_KEY"const res = await fetch("https://skirent.sumware.at/api/ext/v1/days/2026-12-27", { 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/days/2026-12-27", 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/days/2026-12-27');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 75 Zeilen
{ "date": "2026-12-27", "jobs": [ { "id": 3, "kind": "delivery", "onDate": "2026-12-27", "sortOrder": null, "status": "open", "accommodation": { "id": 2, "name": "Hotel Alpenhof", "street": "Dorfstraße 12", "zip": "5999", "city": "Bergdorf" }, "booking": { "ref": "SB-261114-WWNP", "status": "confirmed", "guestName": "Martin Berger", "phone": "+49 000 0000002", "rooms": [ "204", "205" ], "persons": 3, "pickupAtDepot": false }, "note": null, "skipReason": null, "doneAt": null, "doneBy": null, "doneOnDate": null, "earlyDone": false }, { "id": 5, "kind": "delivery", "onDate": "2026-12-27", "sortOrder": null, "status": "open", "accommodation": { "id": 3, "name": "Pension Sonnblick", "street": "Sonnweg 4", "zip": "5999", "city": "Bergdorf" }, "booking": { "ref": "SB-261227-ZA22", "status": "confirmed", "guestName": "Sophie Lang", "phone": "+43 000 000003", "rooms": [ "3" ], "persons": 2, "pickupAtDepot": false }, "note": null, "skipReason": null, "doneAt": null, "doneBy": null, "doneOnDate": null, "earlyDone": false } ], "counts": { "delivery": 2, "pickup": 0, "open": 2, "done": 0, "skipped": 0 }}Aus der Liste zählen für das Hotel die Einträge mit der eigenen accommodation.id:
| Feld | Was die Rezeption daraus liest |
|---|---|
kind |
delivery: Ausrüstung kommt. pickup: Ausrüstung wird geholt. |
status |
open: steht aus. done: erledigt. skipped: der Fahrer war da und hat niemanden angetroffen. |
booking.guestName, booking.persons |
wer, und für wie viele Personen |
booking.rooms |
die Zimmer, die an der Buchung stehen |
doneAt, note |
wann erledigt, und was der Fahrer notiert hat |
Ein Abruf alle paar Minuten reicht. Eine Uhrzeit, zu der geliefert wird, gibt es nicht.
Zimmernummern nachtragen
Abschnitt betitelt „Zimmernummern nachtragen“Die Buchungsnummer steht in booking.ref der Tour.
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" ]}Die Zimmer stehen danach auf dem Tagesauftrag des Fahrers.
Beispielprogramm
Abschnitt betitelt „Beispielprogramm“Der Zustellstatus eines Hauses für heute, in JavaScript ab Node.js 18:
const BASE = 'https://skirent.sumware.at/api/ext/v1';const HAUS = Number(process.env.SKI4ME_HAUS); // id der eigenen Unterkunft
async function ski4me(pfad, init = {}) { const res = await fetch(BASE + pfad, { ...init, headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, ...(init.body ? { 'Content-Type': 'application/json' } : {}), }, }); const data = await res.json(); if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`); return data;}
const heute = new Date().toISOString().slice(0, 10);const tag = await ski4me(`/days/${heute}`);
const TEXT = { open: 'steht aus', done: 'erledigt', skipped: 'niemand angetroffen' };
for (const auftrag of tag.jobs.filter((j) => j.accommodation.id === HAUS)) { const was = auftrag.kind === 'delivery' ? 'Lieferung' : 'Abholung'; const zimmer = auftrag.booking.rooms.join(', ') || 'Zimmer fehlt'; console.log(`${was} ${auftrag.booking.guestName} ${zimmer} ${TEXT[auftrag.status]}`);}Einschränkungen
Abschnitt betitelt „Einschränkungen“- Ein Schlüssel mit diesen beiden Rechten liest keine Buchungen im Ganzen: keine Positionen, keine Beträge, keine Körperdaten.
- Er meldet keinen Auftrag als erledigt. Das tut der Fahrer.
- Er legt keine Buchung an. Gäste buchen auf der Website des Betriebs.