Zum Inhalt springen

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.

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.

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.

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 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.

Wer die Zahlen in ein eigenes Werkzeug holt, liest die Buchungen eines Zeitraums und je Buchung das Detail. Das braucht das Recht booking.view.

Terminal-Fenster
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"

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.
  • totals nennt Summe, Kaution und enthaltene Umsatzsteuer in Cent. Die Kaution ist ein durchlaufender Posten.
  • lines[].vatPercent ist bei vermittelten Kursen null: 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.