Steuerrechnungstool/README.md

Steuerrechnungstool – Campinghof Bartl

(früher „Beherbergungssteuer“ – siehe Hinweis unten)

Umbenennung, 06.09.2026

Die Repositories heissen jetzt:

bisher	jetzt
beherbergungssteuer	Steuerrechnungstool - https://git.pcore.de/TheMockTv/Steuerrechnungstool
rechnungstool	unveraendert - https://git.pcore.de/TheMockTv/rechnungstool

Grund: „Beherbergungssteuer“ beschrieb nur noch einen Teil dessen, was das Programm tut. Alte Links leitet Forgejo weiter, bestehende Klone laufen weiter - das origin sollte trotzdem umgestellt werden:

git remote set-url origin https://git.pcore.de/TheMockTv/Steuerrechnungstool.git

Fehler und Wünsche bitte als Issue im jeweiligen Repository melden - die Adresse steht auch im Programm unter Hilfe → Info und im Hinweis beim Start.

⚠️ Der lokale Ordner heißt weiterhin C:\claude\beherbergungssteuer. Der Pfad steht fest verdrahtet in mehreren Prüfständen und in den Spec-Dateien - das Umbenennen ist ein eigener Schritt.

Ersetzt die Excel-Mappe Beherbergungsteuer.xlsx.

Quelle der Wahrheit sind die Rechnungs-PDFs aus dem Rechnungstool. Das Programm liest den Rechnungs-Ordner ein, führt daraus das Steuerjournal und schreibt auf Knopfdruck die Excel-Mappe fürs Amt.

Starten

• Doppelklick auf Beherbergungssteuer starten.bat
• oder im Terminal: python app.py

Bedienung

1. Rechnungs-Ordner… → den Ordner wählen, in dem das Rechnungstool die PDFs ablegt (Standard: Dokumente\Campinghof Rechnungen). Danach wird sofort eingelesen; bei jedem Start passiert das automatisch.
2. Rechnungen einlesen (oder F5) holt neue Rechnungen nach. Bereits gelesene PDFs werden übersprungen (Vergleich über Pfad, Änderungszeit und Größe) – das geht auch bei tausend Rechnungen schnell.
3. Monats-Reiter zeigen die Buchungen mit Summenzeile, unten rechts steht die Jahressumme.
4. PDF fürs Amt schreibt den Monatsbericht des offenen Reiters als PDF im Campinghof-Layout (gleicher Briefkopf wie die Rechnungen) nach berichte/: Tabelle aller Rechnungen, Summenblock mit der Steuer, Unterschriftszeile. Über das Menü gibt es zusätzlich den Jahresbericht. Gedruckt wird aus dem PDF-Programm heraus.

Im Journal wird nichts von Hand geändert (seit v1.4): weder anlegen noch bearbeiten. Jede Zeile gehört zu einer Rechnung aus dem Rechnungstool – auch die Barzahlung. Wer hier Betrag oder Nummer verstellte, meldete dem Amt etwas anderes, als auf dem Beleg steht; beim nächsten Einlesen käme die Änderung ohnehin zurück. Stimmt eine Rechnung nicht, wird sie im Rechnungstool storniert oder berichtigt.

Löschen bleibt: Entf oder die Haken-Spalte mit dem Papierkorb. Das entfernt nur die Zeile aus dem Zwischenspeicher – die PDF bleibt liegen und wird beim nächsten Einlesen wieder gefunden.

Der Briefkopf des Berichts (Firma, Logo, Bankzeile) wird aus der config.json des Rechnungstools gelesen – also nur an einer Stelle gepflegt.

Was aus der PDF gelesen wird

Spalte	Herkunft in der Rechnung
Datum	Rechnungsdatum:
Rechnung	Rechnungsnummer: (z.B. 2026-238)
Nachname	erste Zeile unter Rechnung an:
Übernachtungen	Zeitraum: 3 Nächte (ersatzweise An-/Abreise)
Gezahlt	Zwischensumme: – das ist die Basis der Steuer
Steuer	zzgl. Beherbergungssteuer (5 %):

Weicht der in der PDF ausgewiesene Steuerbetrag von der eigenen Rechnung ab, steht das als Warnung in beherbergungssteuer.log.

Doppelt vergebene Rechnungsnummern

Jede Rechnungsnummer darf es nur einmal geben (§ 14 Abs. 4 Nr. 4 UStG). Kommt eine Nummer trotzdem zweimal vor, zeigt das Journal sie an, statt eine der beiden verschwinden zu lassen:

• die betroffenen Zeilen stehen rot und tragen ein ⚠ vor der Nummer,
• der Monatsreiter bekommt ebenfalls ein ⚠ – auch dann, wenn die zweite Rechnung in einem anderen Monat liegt (gerechnet wird über das ganze Jahr),
• unter der Jahressumme steht eine rote Zeile mit dem Knopf „Doppelte Rechnungen anzeigen…": dort stehen alle Belege mit Datum, Gast, Betrag und Dateiname.

Die Beträge bleiben in allen Summen und im Bericht fürs Amt – es wird nichts stillschweigend weggerechnet. Zwei Zeilen zur selben Rechnung (z. B. einmal aus dem Excel-Altbestand und einmal aus der PDF) melden die Übernachtung doppelt ans Amt; zwei verschiedene Gäste unter einer Nummer sind ein Fehler im Rechnungstool. Was zu tun ist, entscheidet der Wirt – das Programm ändert von allein nichts.

Bis Version 1.2 war die Rechnungsnummer der Schlüssel der Datenbank: die zweite Rechnung hat die erste still überschrieben und fehlte danach in der Meldung ans Amt. Seit v1.3 ist der Schlüssel die PDF-Datei, seit v1.4 sieht man den Fall auch.

Nur ein Fenster

Das Programm lässt sich nicht zweimal öffnen. Ein zweiter Doppelklick holt das offene Fenster nach vorn. Grund: beide Fenster würden denselben Rechnungsordner in dieselbe journal.sqlite3 einlesen und danach verschiedene Stände zeigen – wer im älteren Fenster auf „PDF fürs Amt" drückt, meldet einen Stand, den es nicht mehr gibt.

Excel einlesen

Datei → Excel-Tabelle einlesen… zieht die bisherige Beherbergungsteuer.xlsx ins Journal – sowohl den Altbestand aus der Zeit vor dem Rechnungstool als auch jede spätere Fassung, die noch in Excel gepflegt wurde. Zeilen ohne PDF sind in der Tabelle grau dargestellt. Rechnungsnummern werden dabei vereinheitlicht (001, 13, 2026-17 → 2026-013), sonst entstünden doppelte Buchungen.

Dateien

Datei	Zweck
app.py	Fenster, Menü, Aktionen
gui_monat.py	ein Monatsblatt (Tabelle + Summenzeile)
pdf_parser.py	Rechnungs-PDF → Buchung
bericht_pdf.py	Monats-/Jahresbericht fürs Amt (reportlab)
firma.py	Briefkopf aus der config.json des Rechnungstools
db.py	Journal (SQLite) + PDF-Scan mit Cache
xlsx_io.py	Excel-Import
modell.py	Datenmodell + Steuerrechnung + doppelte Nummern (die einzige Rechenstelle)
ablage.py	wo der Datenordner liegt (neben der EXE oder in LOCALAPPDATA)
einzelinstanz.py	Sperre gegen ein zweites Fenster
pruef_doppelte.py	Prüfstand: werden doppelte Nummern angezeigt?
pruef_einzelinstanz.py	Prüfstand: geht das Programm wirklich nur einmal auf?
pruef_berichtigung.py	Prüfstand: Storno/Berichtigung überschreiben nichts
journal.sqlite3	die Daten (wird beim 1. Start angelegt)
berichte/	die erzeugten Amts-PDFs

Voraussetzungen

Python 3.10+, pypdf, openpyxl und reportlab (pip install pypdf openpyxl reportlab).