Offene Schnittstelle
Tour und Aufträge
Jede Buchung mit Lieferung hat zwei Aufträge: die Lieferung am ersten Miettag und die Abholung am Abreisetag. Die Tour eines Tages ist die Liste dieser Aufträge.
Aufträge eines Tages
Abschnitt betitelt „Aufträge eines Tages“GET/api/ext/v1/days/{date}
Eine flache Liste in der Reihenfolge der Tour. Kein Lieferfenster: es gibt keine Uhrzeit, zu der geliefert wird, und deshalb auch kein Feld dafür.
Im Pfad
| Parameter | Typ | Bedeutung |
|---|---|---|
date | string | Ein Tag als JJJJ-MM-TT. |
Felder der Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
date | string | Der abgefragte Tag. |
jobs | object[] | Aufträge: Lieferung und Abholung. |
jobs[].id | integer | Nummer des Auftrags. Mit ihr melden Sie ihn als erledigt.ab -9007199254740991 |
jobs[].kind | string | delivery für die Lieferung, pickup für die Abholung.Erlaubt: delivery, pickup |
jobs[].onDate | string | Geplanter Tag. |
jobs[].sortOrder | integer | null | Platz in der Tour, gezählt ab 1. null, solange niemand die Tour geordnet hat.ab -9007199254740991 |
jobs[].status | string | open, done oder skipped. Ein übersprungener Auftrag gilt nicht als erledigt.Erlaubt: open, done, skipped |
jobs[].accommodation | object | Wohin der Auftrag geht. |
jobs[].accommodation.id | integer | null | ab -9007199254740991 |
jobs[].accommodation.name | string | Name der Unterkunft. |
jobs[].accommodation.street | string | Straße und Hausnummer. |
jobs[].accommodation.zip | string | Postleitzahl. |
jobs[].accommodation.city | string | Ort. |
jobs[].booking | object | Die Buchung hinter dem Auftrag. |
jobs[].booking.ref | string | Buchungsnummer in der Form SB-JJMMTT-XXXX. |
jobs[].booking.status | string | Zustand der Buchung, siehe Zustände. |
jobs[].booking.guestName | string | Vor- und Nachname der buchenden Person. Nach dem Löschlauf steht hier nur noch die Kurzform, etwa „Martin B.“. |
jobs[].booking.phone | string,null | Telefonnummer des Gastes für Rückfragen des Fahrers. |
jobs[].booking.rooms | string[] | Zimmernummern. Stehen auf dem Tagesauftrag des Fahrers. |
jobs[].booking.persons | integer | Anzahl der Personen mit Leihausrüstung.ab -9007199254740991 |
jobs[].booking.pickupAtDepot | boolean | true: der Gast holt im Shop ab, es gibt keine Lieferung. |
jobs[].note | string,null | Notiz zum Auftrag. |
jobs[].skipReason | string,null | Grund, wenn der Auftrag übersprungen wurde. |
jobs[].doneAt | string,null | Zeitpunkt, zu dem der Auftrag erledigt oder übersprungen wurde. |
jobs[].doneBy | string,null | Wer ihn gemeldet hat: der Name des Mitarbeiters oder des Schlüssels. |
jobs[].doneOnDate | string,null | Der Tourtag, an dem erledigt wurde. Den setzt der Server. |
jobs[].earlyDone | boolean | true, wenn vor dem geplanten Tag erledigt wurde, etwa am Abend davor. Solche Aufträge gehören nicht mehr in die Tour des Tages. |
counts | object | Zählung über alle Aufträge des Tages. |
counts.delivery | integer | Anzahl Lieferungen.ab -9007199254740991 |
counts.pickup | integer | Anzahl Abholungen.ab -9007199254740991 |
counts.open | integer | Noch offen.ab -9007199254740991 |
counts.done | integer | Erledigt.ab -9007199254740991 |
counts.skipped | integer | Übersprungen.ab -9007199254740991 |
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 }}Die Antwort ist eine flache Liste in der Reihenfolge der Tour, keine Gruppierung nach Haus. Wer nach Haus gruppieren will, nimmt accommodation.id.
- Für ein Hotel ist das der Zustellstatus: die Einträge mit der eigenen
accommodation.id, je mit Gast, Zimmern undstatus. sortOrderistnull, solange niemand die Tour geordnet hat.earlyDoneisttrue, wenn ein Auftrag vor seinem geplanten Tag erledigt wurde, etwa am Abend davor. Ein Programm, das die Tour des Tages zeichnet, lässt diese Aufträge weg. An welchem Tag wirklich erledigt wurde, nenntdoneOnDate.
So sieht derselbe Tag aus, nachdem eine Lieferung erledigt und eine übersprungen wurde:
Antwort200OK
Antwort anzeigen 75 Zeilen
{ "date": "2026-12-27", "jobs": [ { "id": 3, "kind": "delivery", "onDate": "2026-12-27", "sortOrder": null, "status": "done", "accommodation": { "id": 2, "name": "Hotel Alpenhof", "street": "Dorfstraße 12", "zip": "5999", "city": "Bergdorf" }, "booking": { "ref": "SB-261114-WWNP", "status": "delivered", "guestName": "Martin Berger", "phone": "+49 000 0000002", "rooms": [ "204", "205" ], "persons": 3, "pickupAtDepot": false }, "note": "Im Skiraum abgestellt, Fach 204.", "skipReason": null, "doneAt": "2026-12-27T08:12:46.278Z", "doneBy": "Kassensystem", "doneOnDate": "2026-12-27", "earlyDone": false }, { "id": 5, "kind": "delivery", "onDate": "2026-12-27", "sortOrder": null, "status": "skipped", "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": "Zweiter Versuch nach 17 Uhr.", "skipReason": "Niemand angetroffen, Rezeption nicht besetzt.", "doneAt": "2026-12-27T08:41:18.040Z", "doneBy": "Kassensystem", "doneOnDate": "2026-12-27", "earlyDone": false } ], "counts": { "delivery": 2, "pickup": 0, "open": 0, "done": 1, "skipped": 1 }}Die Buchung hinter dem erledigten Auftrag steht jetzt auf delivered.
Einen Auftrag melden
Abschnitt betitelt „Einen Auftrag melden“PATCH/api/ext/v1/jobs/{id}
Bei skipped ist skipReason Pflicht. Der Buchungsstatus folgt: geliefert, abgeholt, und erst wenn beide Aufträge erledigt sind, geschlossen.
Im Pfad
| Parameter | Typ | Bedeutung |
|---|---|---|
id | string | Die Nummer des Auftrags aus jobs[].id. |
Im Rumpf
| Feld | Typ | Bedeutung |
|---|---|---|
status | string | done erledigt, skipped übersprungen, open nimmt beides zurück.Erlaubt: open, done, skipped |
skipReason | string | Pflicht bei skipped, etwa „niemand angetroffen“.max. 400 Zeichen |
note | string | Notiz zum Auftrag. Geht auch ohne Statuswechsel.max. 800 Zeichen |
Die Antwort nennt den neuen Stand des Auftrags: jobId, status, doneAt, doneBy, doneOnDate, earlyDone, skipReason und note.
Erledigt
Abschnitt betitelt „Erledigt“curl -X PATCH "https://skirent.sumware.at/api/ext/v1/jobs/3" \ -H "Authorization: Bearer $SKI4ME_KEY" \ -H "Content-Type: application/json" \ -d '{ "status": "done", "note": "Im Skiraum abgestellt, Fach 204." }'const res = await fetch("https://skirent.sumware.at/api/ext/v1/jobs/3", { method: "PATCH", headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ status: "done", note: "Im Skiraum abgestellt, Fach 204." }),});
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/jobs/3", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, json={"status": "done", "note": "Im Skiraum abgestellt, Fach 204."}, 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/jobs/3');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(['status' => 'done', 'note' => 'Im Skiraum abgestellt, Fach 204.']),]);$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
{ "jobId": 3, "status": "done", "doneAt": "2026-12-27T08:12:46.278Z", "doneBy": "Kassensystem", "doneOnDate": "2026-12-27", "earlyDone": false, "skipReason": null, "swapStatus": null, "note": "Im Skiraum abgestellt, Fach 204."}doneBy ist der Name des Schlüssels. Den Tourtag in doneOnDate setzt der Server; er lässt sich nicht mitgeben.
Übersprungen
Abschnitt betitelt „Übersprungen“Bei skipped ist ein Grund Pflicht. „Nicht angetroffen“ ohne Grund ist am nächsten Morgen nicht mehr zu klären.
curl -X PATCH "https://skirent.sumware.at/api/ext/v1/jobs/5" \ -H "Authorization: Bearer $SKI4ME_KEY" \ -H "Content-Type: application/json" \ -d '{ "status": "skipped", "skipReason": "Niemand angetroffen, Rezeption nicht besetzt." }'const res = await fetch("https://skirent.sumware.at/api/ext/v1/jobs/5", { method: "PATCH", headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ status: "skipped", skipReason: "Niemand angetroffen, Rezeption nicht besetzt.", }),});
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/jobs/5", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, json={ "status": "skipped", "skipReason": "Niemand angetroffen, Rezeption nicht besetzt.", }, 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/jobs/5');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([ 'status' => 'skipped', 'skipReason' => 'Niemand angetroffen, Rezeption nicht besetzt.', ]),]);$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
{ "jobId": 5, "status": "skipped", "doneAt": "2026-12-27T08:41:18.040Z", "doneBy": "Kassensystem", "doneOnDate": "2026-12-27", "earlyDone": false, "skipReason": "Niemand angetroffen, Rezeption nicht besetzt.", "swapStatus": null, "note": null}Ohne Grund lehnt der Server ab:
Antwort400Bad Request
{ "error": { "code": "invalid_request", "message": "Ein übersprungener Auftrag braucht einen Grund.", "status": 400, "hint": "Feld skipReason mitsenden, etwa \"niemand angetroffen\".", "documentation_url": "https://skirent.sumware.at/api/" }}Ein übersprungener Auftrag gilt nicht als erledigt. Er ist der Grund für die zweite Fahrt.
Eine Notiz geht auch ohne Statuswechsel.
curl -X PATCH "https://skirent.sumware.at/api/ext/v1/jobs/5" \ -H "Authorization: Bearer $SKI4ME_KEY" \ -H "Content-Type: application/json" \ -d '{ "note": "Zweiter Versuch nach 17 Uhr." }'const res = await fetch("https://skirent.sumware.at/api/ext/v1/jobs/5", { method: "PATCH", headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ note: "Zweiter Versuch nach 17 Uhr." }),});
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/jobs/5", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, json={"note": "Zweiter Versuch nach 17 Uhr."}, 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/jobs/5');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(['note' => 'Zweiter Versuch nach 17 Uhr.']),]);$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
{ "jobId": 5, "note": "Zweiter Versuch nach 17 Uhr."}Zurücknehmen
Abschnitt betitelt „Zurücknehmen“open nimmt done und skipped zurück.
curl -X PATCH "https://skirent.sumware.at/api/ext/v1/jobs/5" \ -H "Authorization: Bearer $SKI4ME_KEY" \ -H "Content-Type: application/json" \ -d '{ "status": "open" }'const res = await fetch("https://skirent.sumware.at/api/ext/v1/jobs/5", { method: "PATCH", headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ status: "open" }),});
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/jobs/5", headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, json={"status": "open"}, 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/jobs/5');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(['status' => 'open']),]);$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
{ "jobId": 5, "status": "open", "doneAt": null, "doneBy": null, "doneOnDate": null, "earlyDone": false, "skipReason": null, "swapStatus": null, "note": null}Auswirkung auf die Buchung
Abschnitt betitelt „Auswirkung auf die Buchung“Der Zustand der Buchung folgt den Aufträgen, wie im Portal:
| Aufträge | Buchung |
|---|---|
| Lieferung erledigt | delivered |
| Abholung erledigt, Lieferung noch nicht | collected |
| beide erledigt | closed |
| ein Auftrag zurückgenommen | einen Schritt zurück, bis confirmed |
Sie setzen den Zustand der Buchung also nie selbst. Sie melden, was am Haus geschehen ist.