# -*- coding: utf-8 -*- """ Datenmodell + Rechenkern der Beherbergungssteuer. Eine Buchung = eine Zeile im Steuerjournal = eine Rechnung. Gerechnet wird ausschließlich hier, damit GUI, Excel-Export und PDF-Import garantiert dieselben Zahlen zeigen. Steuerlogik (wie in der Excel-Vorlage und im Rechnungstool): Steuer = Gezahlt / 100 * Satz wobei "Gezahlt" die Zwischensumme der Rechnung ist (Leistungen brutto, also inkl. USt, aber ohne die Beherbergungssteuer selbst). """ import re from dataclasses import dataclass, field from datetime import date MONATE = [ "Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember", ] MONATE_KURZ = ["JAN", "FEB", "MÄR", "APR", "MAI", "JUN", "JUL", "AUG", "SEP", "OKT", "NOV", "DEZ"] STANDARD_SATZ = 5.0 # Prozent Beherbergungssteuer def runde(x) -> float: """Kaufmännisch auf 2 Nachkommastellen runden.""" return round(float(x) + 1e-9, 2) def steuer_betrag(gezahlt, satz) -> float: """Beherbergungssteuer auf einen Rechnungsbetrag: Gezahlt / 100 * Satz.""" return runde(float(gezahlt or 0) / 100.0 * float(satz or 0)) @dataclass class Buchung: """Eine Zeile des Steuerjournals.""" datum: date rechnungsnummer: str # nur der Zähler, z.B. "238" (das Jahr steckt in .jahr) jahr: int nachname: str naechte: int gezahlt: float # Zwischensumme der Rechnung (Basis der Steuer) satz: float = STANDARD_SATZ quelle: str = "pdf" # pdf | xlsx | manuell pdf_pfad: str = "" id: int = 0 # Aus den Kenndaten der PDF: was fuer ein Beleg ist das, und worauf bezieht # er sich. Ohne diese vier Felder ist eine Stornozeile im Journal nur eine # Buchung mit Minusbetraegen - man sieht nicht, welche Rechnung sie aufhebt. art: str = "rechnung" # rechnung | storno | korrektur storno_zu: str = "" # Nummer der aufgehobenen Rechnung storno_datum: str = "" # deren Datum (TT.MM.JJJJ) - Teil des Bezugs vorgang: str = "" # Klammer um Rechnung, Storno und Neuausstellung # Worauf der Storno VORWAERTS zeigt. Ohne das endet die Kette am Storno und # niemand weiss, wo die Leistung nun abgerechnet ist (seine Ansage 04.09.2026: # "wer soll denn sonst wissen, wo er suchen muss"). folge_nummer: str = "" # Nummer der Rechnung, die danach gilt folge_art: str = "" # neu | vorhanden | "" (es folgt nichts) @property def steuer(self) -> float: return steuer_betrag(self.gezahlt, self.satz) @property def monat(self) -> int: """1-12""" return self.datum.month @property def voll_nummer(self) -> str: return f"{self.jahr}-{self.rechnungsnummer}" @property def schluessel(self) -> str: """Eindeutig pro Rechnung – verhindert Doppel-Import derselben PDF.""" return f"{self.jahr}-{self.rechnungsnummer}" def aufhebungen(buchungen) -> dict: """Welcher Storno hebt welche Rechnung auf: {id der Rechnung: Storno-Buchung}. Der Bezug ist Nummer + Datum + Nachname, nicht die Nummer allein. Genau darum geht es hier: bei einer DOPPELT vergebenen Nummer waere die Nummer kein eindeutiger Bezug - § 31 Abs. 5 UStDV verlangt aber, dass sich ein berichtigendes Dokument "spezifisch und eindeutig" auf die Rechnung bezieht. Steht auf dem Storno also 2026-020 vom 05.08. fuer Zweitgast, dann ist die Rechnung von Erstgast NICHT aufgehoben. Zurueckgegeben wird der Storno selbst und nicht nur ein Haken, damit die Anzeige auch sagen kann, WOMIT eine Rechnung aufgehoben wurde ("storniert mit 2026-901"). Sonst zeigt das Blatt nur "storniert" und man muss die Gegenzeile suchen. """ stornos = [b for b in buchungen if b.storno_zu] if not stornos: return {} zu = {} for s in stornos: for b in buchungen: if b.id in zu or b is s or not b.id: continue if b.voll_nummer != s.storno_zu: continue # Datum und Name muessen passen, WENN der Storno sie nennt. if s.storno_datum and b.datum.strftime("%d.%m.%Y") != s.storno_datum: continue if s.nachname and b.nachname and s.nachname != b.nachname: continue zu[b.id] = s break return zu def aufgehobene(buchungen) -> set: """Nur die ids - fuer alle, die den Storno selbst nicht brauchen.""" return set(aufhebungen(buchungen)) def doppelte_nummern(buchungen) -> dict: """Rechnungsnummern, die mehr als einmal im Journal stehen. {"2026-020": [Buchung, Buchung]} Gerechnet wird ueber das ganze JAHR, nicht je Monat: dieselbe Nummer kann im August und im September liegen - dann sieht kein Monat fuer sich eine Dublette, das Amt bekaeme die Uebernachtung trotzdem zweimal gemeldet. Gemeldet wird der Fund, nichts wird stillschweigend weggerechnet: die Betraege bleiben in allen Summen und im Amtsbericht, sonst stimmte das Journal nicht mehr mit dem Rechnungsordner ueberein. Jede Nummer darf es nur einmal geben (Paragraph 14 Abs. 4 Nr. 4 UStG) - was zu tun ist, entscheidet der Wirt, nicht das Programm. """ weg = aufgehobene(buchungen) nach_nummer = {} for b in buchungen: # Stornos tragen eine eigene Nummer und sind nie eine Dublette. Und was # storniert wurde, ist keine offene Rechnung mehr - sonst bliebe die # Meldung stehen, obwohl der Fall richtiggestellt ist. if not b.rechnungsnummer or b.storno_zu or b.id in weg: continue nach_nummer.setdefault(b.voll_nummer, []).append(b) return {nr: sorted(liste, key=lambda b: (b.datum, b.id)) for nr, liste in sorted(nach_nummer.items()) if len(liste) > 1} @dataclass class Summe: """Aufsummierte Kennzahlen einer Menge von Buchungen (Monat oder Jahr).""" buchungen: int = 0 naechte: int = 0 gezahlt: float = 0.0 steuer: float = 0.0 gesamt: float = field(default=0.0) # gezahlt + steuer (wie I2 in der Vorlage) def summiere(buchungen) -> Summe: """Kennzahlen einer Menge von Buchungen - ALLE Zeilen, mit ihrem Vorzeichen. ⭐ Ein Storno wird VERRECHNET, nicht weggelassen: die aufgehobene Rechnung bleibt mit ihrem Plus im Monat der Rechnung stehen, der Storno steht mit seinem Minus im Monat des Storno-Belegs. Uebers Jahr hebt sich das auf. Das ist eine Entscheidung des Auftraggebers vom 04.09.2026, nachdem beides durchgerechnet und die Satzung nachgelesen war (04.09. war es zwischenzeitlich andersherum gebaut). Sein Wort: "ich wuerde das wie beim alten lassen, nicht das er der Stadt zu wenig gibt" Der Unterschied zwischen beiden Wegen ist NUR der Monat, nie das Jahr: verrechnet (so wie hier): August meldet die Doppelung mit, September zieht sie ab weggelassen (verworfen): August meldet sie gar nicht erst ⚠️ Streng nach § 7 Abs. 5 der Beherbergungssteuersatzung Markkleeberg wird die im Kalendermonat *vereinnahmte* Steuer angemeldet - fuer eine doppelt geschriebene, nie kassierte Rechnung waere das der Monat der Rechnung. Verrechnen meldet im ersten Monat also eher zu VIEL und im zweiten zu wenig. Genau in dieser Richtung ist es gewollt: zu viel zuerst ist beim Amt nie ein Problem, zu wenig schon. Wer das umbaut, aendert eine bewusste Entscheidung - bitte vorher fragen. """ s = Summe() for b in buchungen: s.buchungen += 1 s.naechte += int(b.naechte or 0) s.gezahlt += float(b.gezahlt or 0) s.steuer += b.steuer s.gezahlt = runde(s.gezahlt) s.steuer = runde(s.steuer) s.gesamt = runde(s.gezahlt + s.steuer) return s def eur(x) -> str: """1234.5 -> '1.234,50 €' (deutsche Schreibweise).""" s = f"{float(x or 0):,.2f}" s = s.replace(",", "#").replace(".", ",").replace("#", ".") return s + " €" def eur_kurz(x) -> str: """Wie eur(), aber ohne Währungszeichen (für enge Tabellenspalten).""" s = f"{float(x or 0):,.2f}" return s.replace(",", "#").replace(".", ",").replace("#", ".") RE_NUMMER = re.compile(r"^\s*(?:(?P\d{4})\s*[-/]\s*)?(?P.+?)\s*$") def zerlege_nummer(text, standard_jahr: int): """ Bringt jede Schreibweise der Rechnungsnummer auf eine Form. '2026-238' -> (2026, '238') '013' -> (standard_jahr, '013') '13' -> (standard_jahr, '013') dreistellig wie im Rechnungstool 'A-7' -> (standard_jahr, 'A-7') nicht-numerisch bleibt, wie es ist Ohne diese Normalisierung wären '17' und '2026-17' zwei verschiedene Buchungen – in der alten Excel-Tabelle kommt beides vor. """ s = " ".join(str(text or "").split()) if not s: return standard_jahr, "" m = RE_NUMMER.match(s) jahr = int(m.group("jahr")) if m.group("jahr") else standard_jahr nr = m.group("nr") if nr.isdigit(): nr = f"{int(nr):03d}" return jahr, nr def zahl_aus_text(text) -> float: """'1.234,50 €' / '87,00' / '13.00' -> float. Leere/kaputte Eingabe -> 0.0""" if text is None: return 0.0 if isinstance(text, (int, float)): return float(text) s = "".join(c for c in str(text) if c.isdigit() or c in ",.-") if not s: return 0.0 # Deutsche Schreibweise: Punkt = Tausender, Komma = Dezimal if "," in s: s = s.replace(".", "").replace(",", ".") try: return float(s) except ValueError: return 0.0