Zum Inhalt springen

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.

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

Einmal bei der Einrichtung: die Nummer des eigenen Hauses in 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"

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.

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

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.

Die Buchungsnummer steht in booking.ref der Tour.

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

Die Zimmer stehen danach auf dem Tagesauftrag des Fahrers.

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]}`);
}
  • 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.