Integrationen
Buchhaltung
Für die Buchhaltung gibt es zwei Wege: die Exporte im Portal, fertig für Tabellenkalkulation und Steuerberatung, und die offene Schnittstelle für ein eigenes Werkzeug.
Exporte im Portal
Abschnitt betitelt „Exporte im Portal“Unter Exporte lädt, wer im Betrieb die Rolle Admin, Büro oder Buchhaltung hat. Ein Zeitraum reicht über höchstens zwei Jahre; Tage zählen in der Zeit des Betriebs.
| Export | Inhalt | Format |
|---|---|---|
| Buchungen | je Buchung eine Zeile: Zustand, Herkunft, Zeitraum, Personen, Unterkunft, Verleih brutto, davon Umsatzsteuer, Kurse, Kaution, Gesamt, Rechnung, Storno, Zahlweg | CSV, XLSX |
| Zahlungen | je Zahlung oder Rückzahlung eine Zeile: Datum, Art, Zweck, Buchung, Weg, Betrag, davon Kaution und Kurse, Transaktion, Auszahlung, Entgelt, Beleg | CSV, XLSX |
| Belege | je Beleg und Steuersatz eine Zeile: Nummer, Art, Datum, Netto, Umsatzsteuer, Brutto, Datei, Prüfsumme. Gutschriften sind negativ. | CSV, XLSX |
| Umsatz | Summen je Bereich und Steuersatz | CSV, XLSX |
| Monatspaket | alles für einen Monat in einer Datei | ZIP |
| DATEV | Buchungsstapel eines Monats | CSV im Format EXTF |
Neue Spalten kommen immer am Ende dazu. Die Position einer vorhandenen Spalte ändert sich nicht, ein Import bleibt also stehen.
Jeder Abruf wird im Journal des Betriebs vermerkt, mit der Prüfsumme der Datei.
CSV-Dateien
Abschnitt betitelt „CSV-Dateien“| Kodierung | UTF-8 mit BOM |
| Trennzeichen | Strichpunkt |
| Zeilenende | CRLF |
| Beträge | mit Dezimalkomma, etwa 123,45 |
| Datum | JJJJ-MM-TT |
| Anführungszeichen | nur, wo eine Zelle Strichpunkt, Anführungszeichen, Zeilenumbruch oder Leerzeichen am Rand enthält |
Text, der mit =, +, - oder @ beginnt, bekommt ein Hochkomma davor, damit eine Tabellenkalkulation ihn nicht als Formel liest.
In den XLSX-Dateien sind Beträge Zahlen und Datumsangaben echte Datumswerte. Die Kopfzeile ist fixiert, ein Filter ist gesetzt.
Monatspaket
Abschnitt betitelt „Monatspaket“Eine ZIP-Datei je Monat, gedacht zum Weiterreichen an die Steuerberatung.
| Datei | Inhalt |
|---|---|
LIESMICH.txt |
Betrieb, UID, Zeitraum, Summen und der Hinweis, was das Paket ist und was nicht |
Auswertung.xlsx |
vier Blätter: Umsatz, Belege, Zahlungen, Buchungen |
umsatz.csv, belege.csv, zahlungen.csv, buchungen.csv |
dieselben Daten einzeln |
datev/EXTF_Buchungsstapel_….csv |
der DATEV-Stapel, wenn die Kontenzuordnung vollständig ist |
Belege/ |
jede Rechnung und Gutschrift, wie sie ausgestellt wurde |
PRUEFSUMMEN.txt |
Prüfsummen aller Dateien, prüfbar mit sha256sum -c |
Jeder Beleg wird vor dem Einpacken gegen seine gespeicherte Prüfsumme geprüft. Fehlt eine Datei oder wurde sie verändert, bleibt sie draußen und LIESMICH.txt nennt sie. Der laufende Monat ist als vorläufig gekennzeichnet.
Der Buchungsstapel folgt dem Format EXTF, Version 700, Datenkategorie 21, Formatversion 13. Geschrieben werden die ersten vierzehn Spalten: Umsatz, Soll/Haben-Kennzeichen, Währung, Kurs, Basisumsatz, Konto, Gegenkonto, BU-Schlüssel, Belegdatum, Belegfeld 1 und 2, Skonto und Buchungstext.
| Kodierung | Windows-1252, ohne BOM |
| Trennzeichen | Strichpunkt |
| Beträge | mit Dezimalkomma, immer positiv; bei einem negativen Betrag tauschen Konto und Gegenkonto |
| Belegdatum | TTMM |
| Dateiname | EXTF_Buchungsstapel_<betrieb>_<JJJJ-MM>.csv |
Vor dem ersten Stapel trägt der Betrieb im Portal ein: Beraternummer, Mandantennummer, Beginn des Wirtschaftsjahres, Länge der Sachkonten und die Konten für Erlöse, Kaution, Skischule, Zahlungsanbieter, Bank, Kasse und Gebühren. Fehlt eine Angabe, die der Monat braucht, entsteht kein Stapel, und das Portal nennt, was fehlt.
Im Stapel stehen Erlöse aus Verleih und Verkauf, Provisionen, Kautionen in beide Richtungen, vereinnahmtes und ausgezahltes Kursgeld und die Entgelte des Zahlungsanbieters. Rechnungen, die vor Ort bezahlt wurden oder noch offen sind, stehen nicht im Stapel, sondern in den Hinweisen dazu.
Rechnungen als ZUGFeRD
Abschnitt betitelt „Rechnungen als ZUGFeRD“Rechnungen und Gutschriften entstehen als PDF/A-3 mit eingebetteter XML-Rechnung: ZUGFeRD 2.3 und Factur-X im Profil EN 16931. Ein Mensch liest das PDF, ein Programm die Datei factur-x.xml darin.
| Beleg | Art |
|---|---|
| Rechnung zur Buchung | 380 |
| Gutschrift zum Storno | 381 |
| Rechnung über einen Kauf statt Rückgabe | 380 |
| Provisionsrechnung an die Skischule | 380 |
Der Gast bekommt seine Rechnung als Anhang der Bestätigung und findet sie in seinem Gastkonto. Kaution und vermittelte Kurse stehen auf dem Blatt unter der Summe und nicht in der XML-Rechnung: sie sind kein Umsatz des Betriebs.
Buchungsbestätigungen und Abrechnungen sind keine Rechnungen und tragen keine XML.
Zugriff über die Schnittstelle
Abschnitt betitelt „Zugriff über die Schnittstelle“Wer die Zahlen in ein eigenes Werkzeug holt, liest die Buchungen eines Zeitraums und je Buchung das Detail. Das braucht das Recht booking.view.
curl "https://skirent.sumware.at/api/ext/v1/bookings?from=2026-12-27&to=2026-12-31&status=confirmed,paid&perPage=25" \ -H "Authorization: Bearer $SKI4ME_KEY"const res = await fetch("https://skirent.sumware.at/api/ext/v1/bookings?from=2026-12-27&to=2026-12-31&status=confirmed,paid&perPage=25", { 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", params={ "from": "2026-12-27", "to": "2026-12-31", "status": "confirmed,paid", "perPage": "25", }, 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?from=2026-12-27&to=2026-12-31&status=confirmed,paid&perPage=25');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);Worauf zu achten ist:
- Der Zeitraum der Liste bezieht sich auf den Anreisetag, nicht auf das Buchungs- oder Rechnungsdatum. Für eine Auswertung nach Rechnungsdatum sind die Exporte der richtige Weg.
totalsnennt Summe, Kaution und enthaltene Umsatzsteuer in Cent. Die Kaution ist ein durchlaufender Posten.lines[].vatPercentist bei vermittelten Kursennull: sie laufen im Namen und auf Rechnung der Skischule.payments[]nennt Betrag, Zustand und, sobald bekannt, Auszahlung und Entgelt.- Belege selbst, also die PDF-Dateien, gibt es nur im Portal.