casa.ai API v0.1.0

PATCH/api/ablesung/{id}

Berichtigt den Stand EINER Ablesung (correct_meter_reading); Zeitpunkt und Anlass bleiben. Antwort mit `stand`, `vorherigerStand` und neu gerechneter `plausibilitaet`. Eine Ablesung, auf der eine festgeschriebene Abrechnung beruht, ist gesperrt (409).

operationId: berichtigeAblesung · Auth: bearerAuth

Request-Body (Pflicht): application/json → AblesungBerichtigenRequest

POST/api/abrechnung

Startet einen Betriebskosten-Abrechnungslauf (start_billing_run) — Readiness fail-closed, Eingabe INV-TIME-01-gebunden.

operationId: startAbrechnung · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/abrechnung/{id}

Liest die Ergebniszahlen eines Abrechnungslaufs maschinenlesbar — Geld ausschließlich als Integer-STRING, cent-genau.

operationId: getAbrechnungErgebnis · Auth: bearerAuth

POST/api/abrechnung/{id}/berechnet

Setzt den Lauf auf `berechnet` (mark_billing_run_berechnet) — nur bei freigabefähigem Prüfbericht. KEIN Body.

operationId: markAbrechnungBerechnet · Auth: bearerAuth

GET/api/abrechnung/{id}/s35a-bescheinigungen

Erzeugt die §35a-Bescheinigungen ALLER Wohnraum-Mieter eines FESTGESCHRIEBENEN Abrechnungslaufs (Serienlauf je Objekt) — Geld ausschließlich als Integer-STRING.

operationId: getAbrechnungS35aBescheinigungen · Auth: bearerAuth

GET/api/abschluss/{id}/freeze

Fragt, ob an einer Abrechnung noch geschrieben werden darf (Muster F7). Ein bestandskräftiger Lauf plus `vorhaben=neuberechnung` endet mit 409 und nennt den Korrekturweg — ein stilles „nichts passiert" sähe für den Bediener wie Erfolg aus.

operationId: getAbschlussFreeze · Auth: bearerAuth

POST/api/abschluss/{id}/storno

Storniert EINEN Abschluss-Lauf — der einzige Weg, an einer festgeschriebenen Abrechnung überhaupt etwas zu bewegen. Der Lauf bleibt danach vollständig lesbar (GG4/GoBD).

operationId: storniereAbschlussLauf · Auth: bearerAuth

Request-Body (Pflicht): application/json → AbschlussStornoRequest

GET/api/altbestand/posten

Liest die übernommene OP-, Mahn- und Zahlhistorie EINES Mieters (die Auskunft bei Mieterwiderspruch, ADR 0019).

operationId: listAltbestandPosten · Auth: bearerAuth

GET/api/altbestand/provenienz

Liest die Herkunft EINER Eröffnungs-Sollstellung: Altsystem, Exportzeitpunkt, Datei-Hash, Stichtag, Quellzeile (GG7).

operationId: getEroeffnungsProvenienz · Auth: bearerAuth

POST/api/altbestand/uebernahme

Übernimmt einen Altbestand (uebernehme_altbestand): offene Posten buchen, Mahn-/Zahlhistorie ablegen, Provenienz binden.

operationId: uebernehmeAltbestand · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/ausnahmen

Listet die Ausnahme-Inbox (offene Verarbeitungs-/Routing-Ausnahmen des aufrufenden Tenants).

operationId: listAusnahmen · Auth: bearerAuth

GET/api/auswertung/einnahmen-ausgaben

Liest das Einnahmen-/Ausgaben-Journal eines Objekts für einen Zeitraum: je Geldbewegung eine Zeile mit Gegenkonto, Beleg und Netto/USt/Brutto, dazu die Summen je Gegenkonto. Eine Umbuchung zwischen zwei Geldkonten ist weder Einnahme noch Ausgabe — sie steht in `umbuchungen`.

operationId: liesEinnahmenAusgabenJournal · Auth: bearerAuth

GET/api/auswertung/einnahmen-ueberschuss

Einnahmen-Überschuss-Aufstellung EINES Objekts für EIN Kalenderjahr (Zufluss/Abfluss, § 11 EStG): Einnahmen und Werbungskosten je Gruppe, Brutto/USt/Netto, Überschuss — für das Objekt oder den Anteil eines Eigentümers; Kautionen, durchlaufende Posten, Rücklagen und Eigentümer-Einlagen/-Entnahmen zählen nicht.

operationId: getEinnahmenUeberschuss · Auth: bearerAuth

GET/api/auswertung/finanzstatus

Finanzstatus EINES Objekts: Entwicklung der Geldkonten im Zeitraum (Anfangsbestand, Zugänge, Abgänge, Endbestand, laufender Saldo je Buchung nach Wertstellung) und Vermögensübersicht zum Stichtag.

operationId: getFinanzstatus · Auth: bearerAuth

GET/api/auswertung/saldenliste

Summen- und Saldenliste der Sachkonten EINES Objekts für einen Zeitraum: je Konto Anfangsbestand, Soll- und Haben-Umsatz und Endsaldo, gegliedert nach Kontenklassen.

operationId: getSaldenliste · Auth: bearerAuth

GET/api/auswertung/ust-liste

Umsatzsteuer, Vorsteuer und Zahllast eines Objekts über einen Zeitraum — je Steuersatz, auf Wunsch je Konto.

operationId: getAuswertungUstListe · Auth: bearerAuth

GET/api/auswertungen

Der Katalog der Auswertungen: welche Berichte es gibt, welche Zeitachsen sie kennen und welche Spalten sie liefern.

operationId: getAuswertungsKatalog · Auth: bearerAuth

GET/api/auswertungen/{auswertung}

EINE Auswertung des Katalogs für ein Objekt und einen Zeitraum, als JSON oder CSV — mit Quellenangabe (Mandant, Objekt, Zeitraum, Datenstand).

operationId: getAuswertung · Auth: bearerAuth

GET/api/bank

Listet Bankverbindungen (3-Wege-Filter, optional auf EIN Objekt eingegrenzt).

operationId: listBankverbindungen · Auth: bearerAuth

POST/api/bank

Legt EINE Bankverbindung an einem Objekt an (IBAN-validiert).

operationId: createBankverbindung · Auth: bearerAuth

Request-Body (Pflicht): application/json → BankCreateRequest

GET/api/bank/{id}

Liest EINE Bankverbindung (auch archiviert).

operationId: getBankverbindung · Auth: bearerAuth

PATCH/api/bank/{id}

Ändert Bankverbindungs-Stammfelder (IBAN/Kontoart/Gläubiger-ID).

operationId: updateBankverbindung · Auth: bearerAuth

Request-Body (Pflicht): application/json → BankUpdateRequest

POST/api/bank/{id}/archive

Archiviert eine Bankverbindung (archived_at statt DELETE, K5).

operationId: archiveBankverbindung · Auth: bearerAuth

GET/api/bank/{id}/umsaetze

Liest die IMPORTIERTEN Umsätze einer Bankverbindung — die `bankTransactionId`, die POST /api/bankabgleich/* erwartet.

operationId: listBankUmsaetze · Auth: bearerAuth

POST/api/bank/{id}/umsatz-import

Importiert einen Kontoauszug als Datei (camt.053/camt.052/MT940) auf eine Bankverbindung. Die Datei wird serverseitig geparst; verbucht wird das ERKANNTE Format, nicht das deklarierte. Wiederholung ist gefahrlos (Dedup).

operationId: importBankUmsaetze · Auth: bearerAuth

Request-Body (Pflicht): multipart/form-data → Binärfeld file (format: binary)

POST/api/bankabgleich/verbuchen

Legt vor, gibt frei und bucht (execute_bank_transaction_booking) — `modus` wählt das Freigabe-Gate: einzeln (gelb erlaubt) oder sammel (all-green).

operationId: verbucheBankumsatz · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/bankabgleich/vorlegen

Legt EINEN Bankumsatz als Buchungsvorschlag vor (create_bank_transaction_booking_proposal) — vorbereitend, reversibel, ohne Freigabe.

operationId: legeBankumsatzVor · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/bankzugang

Listet die Bankzugänge des aufrufenden Tenants samt Status (ohne Anbieter-Zugangsdaten).

operationId: listBankzugaenge · Auth: bearerAuth

GET/api/bauabzug/anmeldung

Liest die einbehaltene Bauabzugsteuer je Monat EINES Kalenderjahres — Grundlage der Anmeldung (§ 48a EStG): Summe, Zahl der Einbehalte und Fälligkeit am 10. des Folgemonats. Gezählt wird nur tatsächlich Einbehaltenes: ein Einbehalt zählt, solange seine Buchung (Kreditor an Verbindlichkeit Finanzamt, entsteht mit der Freigabe des Zahlungsauftrags) wirksam, also nicht storniert ist; ein noch nicht freigegebener Auftrag zählt nicht.

operationId: listBauabzugAnmeldung · Auth: bearerAuth

GET/api/bauabzug/freistellungsbescheinigung

Liest die hinterlegten Freistellungsbescheinigungen (§ 48b EStG) EINES Kreditors: Nummer, gültig bis, Umfang, Auftragsbezug und ausstellendes Finanzamt, absteigend nach Gültigkeit.

operationId: listFreistellungsbescheinigungen · Auth: bearerAuth

POST/api/bauabzug/freistellungsbescheinigung

Hinterlegt eine Freistellungsbescheinigung am Kreditor (hinterlege_freistellungsbescheinigung). Ohne gültige Bescheinigung behält der Zahlungsauftrag für eine Bauleistung über der Bagatellgrenze 15 % für das Finanzamt ein.

operationId: hinterlegeFreistellungsbescheinigung · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/bauabzug/kostenart

Kennzeichnet eine Kostenart als Bauleistung (§ 48 Abs. 1 Satz 3 EStG) oder nimmt das Kennzeichen zurück (setze_kostenart_bauleistung). Eingangsrechnungen auf Aufwandskonten dieser Kostenart lösen am Zahlungsauftrag die Bauabzugs-Prüfung aus.

operationId: setzeKostenartBauleistung · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/bauabzug/objekt-einstellung

Setzt die Lage des Auftraggebers am Objekt, die § 48 EStG unterscheidet (setze_bauabzug_objekt_einstellung): ausschließlich steuerfreie Vermietungsumsätze nach § 4 Nr. 12 UStG heben die Bagatellgrenze auf 15.000 € (§ 48 Abs. 2 Nr. 1 EStG); ein Vermieter von höchstens zwei Wohnungen ist vom Abzug ausgenommen (§ 48 Abs. 1 Satz 2 EStG, Grund vermieter-hoechstens-zwei-wohnungen). Ohne Einstellung gilt 5.000 € und keine Ausnahme.

operationId: setzeBauabzugObjektEinstellung · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/bauabzug/pruefungen

Liest die Bauabzugs-Entscheidungen je Bauleistungs-Position der Zahlungsaufträge: Grund, Rechnungsbetrag, Auszahlung, Einbehalt, Fälligkeit und den Befund der Freistellungsbescheinigung — eine fehlende oder abgelaufene wird mit Status, Nummer und Gültigkeit benannt.

operationId: listBauabzugPruefungen · Auth: bearerAuth

POST/api/bauabzug/volle-zahlung

Erlaubt, einen offenen Posten (Bauleistung) trotz fehlender Freistellungsbescheinigung VOLL zu zahlen (erlaube_volle_zahlung_bauleistung) — nur mit dokumentierter Begründung und nur mit dem Recht bauabzug.volle-zahlung. Je Posten gilt die erste Erlaubnis.

operationId: erlaubeVolleZahlungBauleistung · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/beleg

Reicht einen Beleg über die echte Ingest-Vordertür ein (Byte-Typ-/Malware-Gate, Blob, Ingest, Dispatch-Enqueue).

operationId: uploadBeleg · Auth: bearerAuth

Request-Body (Pflicht): multipart/form-data → Binärfeld file (format: binary)

POST/api/beschluss/{id}/status

Schreibt den Lebenszyklus-Status eines Beschlusses fort (append-only-Verlauf plus Projektion).

operationId: setzeBeschlussStatus · Auth: bearerAuth

Request-Body (Pflicht): application/json → BeschlussStatusRequest

POST/api/buchung

Führt einen freigegebenen Buchungsvorschlag aus (execute_booking) — optional rückdatiert.

operationId: executeBuchung · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/buchung/eroeffnungsbestand

Baut Anfangsbestände auf (import_opening_balances) — die Migrationsnaht.

operationId: importEroeffnungsbestand · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/cli/login/exchange

Schritt 3 des CLI-Browser-Logins: tauscht den einmaligen Rückruf-Code gegen den Session-Token (nur im Antwort-Body, nie in einer URL).

operationId: exchangeCliLoginCode · Auth: keine (öffentlich)

Request-Body (Pflicht): application/json

POST/api/cli/login/start

Schritt 1 des CLI-Browser-Logins: startet eine Anmelderunde und liefert die im Browser zu öffnende Anmelde-URL.

operationId: startCliLogin · Auth: keine (öffentlich)

Request-Body (Pflicht): application/json → CliLoginStartRequest

POST/api/datev/belegpaket

Erzeugt den DATEV-Buchungsstapel mit Beleglinks UND das zugehörige Belegpaket (ZIP mit document.xml und den unveränderten Original-Belegen) in EINEM Lauf (eine Historien-Zeile). Body wie beim Buchungsstapel. Die Antwort trägt "stapel" (Metadaten, laufId, hinweise, datei), "belegpaket" (null, wenn keine Buchung einen übertragbaren Beleg hat), "ohneBeleg" (Zeilennummer und Grund je Buchung ohne Beleg im Paket; nie Buchungstext oder Name) und "hinweis" (Text genau dann, wenn belegpaket null ist). In der Historie liegt nur die Stapel-Datei mit den Beleglinks; das ZIP wird NICHT abgelegt und ist nur in dieser Antwort abrufbar. Ist der Belegspeicher nicht erreichbar, gibt es 503, keinen Teil-Export und keine Historien-Zeile.

operationId: exportiereDatevBelegpaket · Auth: bearerAuth

Request-Body (Pflicht): application/json → DatevBelegpaketRequest

POST/api/datev/buchungsstapel

Erzeugt den DATEV-Buchungsstapel (EXTF 700) für ein oder mehrere Objekte und ein Kalenderjahr und legt den Lauf in der Export-Historie ab. Die Antwort trägt die Datei (Windows-1252, Base64) samt sha256 und "hinweise" auf nicht festgeschriebene Perioden (Hinweis, kein Abweis). Der Export löst KEINE Festschreibung aus; "festschreibung" ist nur das Kennzeichen im Kopfsatz. Ein abweichendes Wirtschaftsjahr geht als zwei Stapel (zwei Aufrufe): exportiert wird der Teil des Kalenderjahres `jahr`, der im Wirtschaftsjahr ab `wirtschaftsjahrBeginn` liegt; berührt das Wirtschaftsjahr das Jahr nicht, ist das ein 400.

operationId: exportiereDatevBuchungsstapel · Auth: bearerAuth

Request-Body (Pflicht): application/json → DatevBuchungsstapelRequest

POST/api/datev/debkred

Erzeugt die DATEV-Stammdatendatei Debitoren/Kreditoren (EXTF, Personenkonten mit Name, Anschrift und bestätigter IBAN) zu einem Buchungsstapel für ein oder mehrere Objekte und ein Kalenderjahr. Die Antwort trägt die Datei (Windows-1252, Base64) samt sha256 und Zahlen. "umfang" ist Pflicht (buchungsstapel oder alle-aktiven). Die Datei enthält Namen und Anschriften: sie steht NICHT in der Export-Historie und ist nicht erneut abrufbar (siehe "hinweise"); der Beleg im Kommando-Log trägt nur sha256 und Zahlen.

operationId: exportiereDatevDebKred · Auth: bearerAuth

Request-Body (Pflicht): application/json → DatevDebKredRequest

GET/api/datev/historie

Listet die früheren DATEV-Buchungsstapel-Läufe, die für die angemeldete Person sichtbar sind, jüngster zuerst: Lauf-Id, Zeitraum, Objekte, Dateiname, sha256, Zeilenzahl, Summe, Zeitpunkt und erzeugende Person; nie Buchungstexte und keine Datei-Bytes. Ein Lauf über mehrere Objekte steht in der Liste jedes seiner Objekte (nur als Kennzahlen); seine Datei liefert der Download nur, wenn die Person für ALLE Objekte des Laufs zuständig ist. Die Historie hält nur die Stapel-Datei; ein Belegpaket (ZIP) und die DebKred-Datei sind nicht darin. Seitenweise: "weiter" der Antwort ist der Cursor für die nächste Seite. Mandant und Zuständigkeit stammen aus der Session.

operationId: listeDatevHistorie · Auth: bearerAuth

GET/api/datev/historie/{laufId}/datei

Liefert die abgelegte Stapel-Datei eines früheren Laufs erneut, byte-gleich zum ursprünglichen Export (gleiche sha256), ohne neuen Buchungslauf, ohne Kommando-Log-Eintrag und ohne neue Historien-Zeile. Nur die Stapel-Datei: ein Belegpaket (ZIP) und die DebKred-Datei liegen nicht in der Historie. Unbekannte, fremde oder nicht vollständig zuständige Lauf-Id ⇒ 404. Stimmen die abgelegten Bytes nicht mehr zu ihrem sha256, gibt es 500 und kein Byte.

operationId: ladeDatevHistorieDatei · Auth: bearerAuth

POST/api/eigentum/{id}/beenden

Beendet eine Eigentumszeile; die Pfad-Id ist die `ownershipId`. `endeExklusiv` ist der erste Tag OHNE Eigentum („zum 30.06." ⇒ 2025-07-01). Beenden kürzt nur das Fenster; dasselbe Ende ein zweites Mal ist ein Erfolg ohne Änderung (`beendet` false). Der Idempotenz-Schlüssel kommt vom Aufrufer (Header).

operationId: beendeEigentum · Auth: bearerAuth

Request-Body (Pflicht): application/json → EigentumBeendenRequest

GET/api/einheit

Listet Einheiten (3-Wege-Filter Alle/Aktiv/Archiviert, Default aktiv; optional je Gebäude oder Objekt).

operationId: listEinheiten · Auth: bearerAuth

POST/api/einheit

Legt eine Einheit an einem aktiven Gebäude an.

operationId: createEinheit · Auth: bearerAuth

Request-Body (Pflicht): application/json → EinheitCreateRequest

GET/api/einheit/{id}

Liest EINE Einheit (auch archiviert) samt Gebäude- und Objekt-Bezug.

operationId: getEinheit · Auth: bearerAuth

PATCH/api/einheit/{id}

Ändert unitNo/unitKind/bezeichnung (nur nicht-archivierte Einheiten).

operationId: updateEinheit · Auth: bearerAuth

Request-Body (Pflicht): application/json → EinheitUpdateRequest

POST/api/einheit/{id}/archive

Archiviert eine Einheit (archived_at statt DELETE, K5).

operationId: archiveEinheit · Auth: bearerAuth

GET/api/einheit/{id}/attribut

Liest die Attribut-Historie einer Einheit (alle Zeitscheiben je Attribut, active zum Stichtag).

operationId: listEinheitAttribute · Auth: bearerAuth

POST/api/einheit/{id}/attribut

Setzt/ändert eine Attribut-Zeitscheibe „ab Datum" (SCD-2; Überschneidungen desselben Attributs werden abgelehnt).

operationId: setEinheitAttribut · Auth: bearerAuth

Request-Body (Pflicht): application/json → EinheitAttributSetRequest

GET/api/einheit/{id}/belegung

Löst die Belegung einer Einheit zum Stichtag auf („wer wohnt in Einheit X?"), optional stattdessen die Historie. EINE Zustandsachse mit vier Ausgängen: aktiver Mietvertrag (Mietpartei) · Eigentümer als Selbstnutzer · Drittnutzer-Kontakt · Leerstand. Der Zustand wird ABGELEITET, wo casa den Mietvertrag selbst führt (aktiver Vertrag ⇒ vermietet, Vertragslücke ⇒ Leerstand), und aus der gepflegten Zeitscheibe GELESEN, wo nicht (fremdverwaltete WEG-Einheit). Ein Widerspruch zwischen beiden ist ein BEFUND, keine Sperre.

operationId: getEinheitBelegung · Auth: bearerAuth

POST/api/einheit/{id}/belegung

Setzt/ändert die GEPFLEGTE Belegungs-Zeitscheibe „ab Datum" (SCD-2; Überschneidungen werden abgelehnt). Pflegt ausschliesslich den Fall, in dem casa den Mietvertrag NICHT führt. Personenzahl 0 bei zustand=leerstand wird abgelehnt: eine leerstehende Einheit zählt bei personenbasierter Umlage fiktiv als 1 Person (BGH VIII ZR 159/05), 0 ist nicht wählbar.

operationId: setEinheitBelegung · Auth: bearerAuth

Request-Body (Pflicht): application/json → EinheitBelegungSetRequest

GET/api/einheit/{id}/eigentuemerwechsel

Listet die Eigentümerwechsel-Vorgänge einer Einheit, aufsteigend nach Grundbuch-Stichtag, mit den beteiligten abgehenden und neuen Eigentumszeilen. Eine Einheit ohne Wechsel ist eine leere Liste.

operationId: listEinheitEigentuemerwechsel · Auth: bearerAuth

POST/api/einheit/{id}/eigentuemerwechsel

Erfasst einen Eigentümerwechsel als EINEN Vorgang: die abgehenden Eigentumszeilen enden am Grundbuch-Stichtag, die neuen beginnen an ihm; optional mit Verwalterzustimmung. Der Stichtag ist die Eintragung im Grundbuch, Abteilung I — nicht der Notartermin. Laufende SEV-Mandate abgehender Eigentümer werden nicht beendet, sondern in `sevMandateOffen` genannt. Der Idempotenz-Schlüssel kommt vom Aufrufer (Header).

operationId: erfasseEinheitEigentuemerwechsel · Auth: bearerAuth

Request-Body (Pflicht): application/json → EigentuemerwechselErfassenRequest

POST/api/einheit/{id}/eigentum

Erfasst eine Eigentumszeile (Person, Anteil in Zehntausendsteln als Integer-String, Beginn, optional Ende, Zustellanschrift, Vollmacht, Umsatzsteuer-Option) an der Einheit. Die Einheit steht im Pfad. Der Idempotenz-Schlüssel kommt vom Aufrufer (Header). Ein Löschweg existiert bewusst nicht: Eigentum wird beendet.

operationId: erfasseEinheitEigentum · Auth: bearerAuth

Request-Body (Pflicht): application/json → EigentumErfassenRequest

PUT/api/einheit/{id}/einnahmeart

Setzt die Einnahmeart einer Einheit (Wohnung, andere Räume, an Angehörige vermietet, nicht steuerpflichtig) und optional das Geschoss — die Merkmale, nach denen die Auswertung `einnahmen-ueberschuss-einnahmeart` die Mieteinnahmen gliedert. `einnahmeart: null` entfernt sie; die Auswertung meldet eine Einheit ohne Einnahmeart dann als Befund, statt einen Wert zu raten.

operationId: setEinheitEinnahmeart · Auth: bearerAuth

Request-Body (Pflicht): application/json → EinheitEinnahmeartSetRequest

POST/api/einheit/{id}/reactivate

Reaktiviert eine Einheit (#445).

operationId: reactivateEinheit · Auth: bearerAuth

GET/api/einheit/{id}/sev-mandat

Löst die Sondereigentumsverwaltung einer Einheit zum Stichtag auf („beauftragt der Eigentümer uns hier zusätzlich mit der Vermietung, und mit welchen Vertragswerten?"), optional stattdessen die Historie. Halboffen: ein Mandat ab 01.01.2025 wird zum 01.06.2025 gefunden, zum 31.12.2024 nicht; ein zum 01.07.2025 beendetes am 30.06. noch, am 01.07. nicht mehr. `mandat: null` heisst „am Stichtag keine Sondereigentumsverwaltung" — nicht „Einheit unbekannt" (dafür 404).

operationId: getEinheitSevMandat · Auth: bearerAuth

POST/api/einheit/{id}/sev-mandat

Vereinbart die Sondereigentumsverwaltung für einen Eigentümer und diese Einheit als Zeitabschnitt. NUR in einem Objekt der Verwaltungsart "pro" ("WEG mit Mietverwaltung"): in einem reinen Mietobjekt gibt es kein Sondereigentum, das zusätzlich beauftragt werden könnte, in einer reinen WEG führt die Verwaltung die Mietseite nicht. Die Person muss im GESAMTEN Mandatszeitraum Eigentümerin der Einheit sein. Es gibt bewusst KEIN Änderungs-Kommando: ein Wechsel von „mit Mietinkasso" zu „ohne" ist beenden + neu anlegen (Parität Immoware24).

operationId: legeEinheitSevMandatAn · Auth: bearerAuth

Request-Body (Pflicht): application/json → SevMandatAnlegenRequest

POST/api/einheit/{id}/sev-mieterabrechnung

Berechnet die Betriebskostenabrechnung des Mieters der SEV-Wohnung aus der Hausgeld-Einzelabrechnung, die der Server aus dem genannten festgeschriebenen WEG-Abschlusslauf lädt (hashgeprüft; nie Beträge, Positionen oder Schlüssel aus dem Body) — umlagefähiger Anteil, Geldkreis miete — plus umlagefähigen Kosten der Wohnung; Vermieter ist der Eigentümer laut unit_ownerships (bei Wechsel ein Abschnitt je Eigentümer). Bei Mietinkasso lädt der Server die Vorauszahlungen aus der Mietbuchhaltung des Vertrags (ein Vorauszahlungsfeld im Body ist ein 400). Dazu derselbe Prüfbericht wie bei Mietobjekten, einschließlich heizkostenv_ohne_verbrauch (Kürzungsrecht nach § 12 HeizkostenV). Schreibt nichts.

operationId: berechneSevMieterabrechnung · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/einheit/{id}/sev-mieterkosten

Die SE-Kosten der Wohnung, die für die Mieterabrechnung bereitstehen: genau die umlagefähig gekennzeichneten, bezahlten, nicht stornierten Rechnungen mit Rechnungsdatum im Zeitraum (beide Grenzen inklusiv).

operationId: listSevMieterKosten · Auth: bearerAuth

GET/api/einheit/{id}/wechselzeitraum

Prüft vorab, ob sich ein nachträglich erfasster früherer Bewohner- oder Eigentümerzeitraum (von/bis, beide Tage INKLUSIVE) in den Bestand der Einheit einfügt: ok · ueberlappt (mit Zeilen-Id der betroffenen Zeile; auch wenn das Ende auf den Beginn des bestehenden Zeitraums fällt) · zeitraum-verdreht · beginn-unbekannt, dazu eine etwaige Lücke zum nächsten bestehenden Zeitraum (gemeldet, nicht verboten). Reiner Read, schreibt nichts; erfasst wird über die Belegungs- und Eigentumsendpunkte.

operationId: pruefeEinheitWechselzeitraum · Auth: bearerAuth

GET/api/einheitengruppe

Listet die Abrechnungskreise (3-Wege-Archiv-Filter, optional auf ein Objekt eingegrenzt).

operationId: listEinheitengruppen · Auth: bearerAuth

POST/api/einheitengruppe

Legt einen Abrechnungskreis an einem aktiven Objekt an.

operationId: createEinheitengruppe · Auth: bearerAuth

Request-Body (Pflicht): application/json → EinheitengruppeCreateRequest

GET/api/einheitengruppe/{id}

Liest einen Abrechnungskreis mit seinen Mitgliedschaften (active zum Stichtag).

operationId: getEinheitengruppe · Auth: bearerAuth

PATCH/api/einheitengruppe/{id}

Ändert Stammfelder eines Abrechnungskreises (name/groupKind).

operationId: updateEinheitengruppe · Auth: bearerAuth

Request-Body (Pflicht): application/json → EinheitengruppeUpdateRequest

POST/api/einheitengruppe/{id}/archive

Archiviert einen Abrechnungskreis (archived_at statt DELETE).

operationId: archiveEinheitengruppe · Auth: bearerAuth

POST/api/einheitengruppe/{id}/mitglied

Nimmt eine Einheit „ab Datum" in den Kreis auf (SCD-2; Überschneidungen derselben Einheit im Kreis werden abgelehnt).

operationId: addEinheitengruppeMitglied · Auth: bearerAuth

Request-Body (Pflicht): application/json → EinheitengruppeMitgliedAddRequest

POST/api/einheitengruppe/{id}/mitglied/beenden

Beendet die offene Mitgliedschaft einer Einheit zum Stichtag.

operationId: endEinheitengruppeMitglied · Auth: bearerAuth

Request-Body (Pflicht): application/json → EinheitengruppeMitgliedEndRequest

POST/api/einstellungen/festschreibung

Schaltet die Festschreibung der Buchungsperioden für ein Objekt (propertyId) oder als Mandanten-Vorgabe (propertyId null) ein oder aus. Ausschalten lässt bestehende Festschreibungen unberührt. Nur ein Mensch mit Admin-Recht.

operationId: setzeFestschreibungSchalter · Auth: bearerAuth

Request-Body (Pflicht): application/json → FestschreibungSchalterRequest

GET/api/fremdvertrag

Liest die Verträge mit Dritten des Mandanten (Versicherung, Wartung, Dienstleistung, Versorgung), begrenzt auf die Objekte mit Zuständigkeit des Aufrufers: Art, Bezeichnung, Partner, Beginn, Konditionen zum Stichtag (Beträge als Integer-STRING in Cent), Fristenstand, Zahl der Schadenfälle. Filter propertyId, art, status (aktiv | beendet | alle, Vorgabe aktiv), limit (Vorgabe 50, höchstens 200) und offset. Nur lesend.

operationId: getFremdvertragListe · Auth: bearerAuth

POST/api/fremdvertrag

Legt einen Vertrag mit Dritten samt ersten Konditionen an: propertyId, art, partnerPersonId (Rolle Kreditor oder Dienstleister), bezeichnung, beginn, kuendigungsfristMonate; optional laufzeitEnde, vertragsnummer, Verlängerung (ohne Angabe: Vorgabe der Einstellung, sonst ja, 12 Monate), beitrag mit beitragIntervall, selbstbehalt (nur Versicherung) und bemerkung. Geld ist ein Objekt {cents, currency}.

operationId: legeFremdvertragAn · Auth: bearerAuth

Request-Body (Pflicht): application/json → FremdvertragAnlegenRequest

GET/api/fremdvertrag/{id}

Liest EINEN Vertrag mit Dritten: Konditionen zum Stichtag, Konditionen-Historie, Ereignisse, Fristenstand (spaetesterZugang, aufgabeAb), Dauerzahlungs-Abgleich und Schadenfälle. Optional stichtag (Vorgabe: Berliner Tag der Server-Uhr). Nur lesend.

operationId: getFremdvertrag · Auth: bearerAuth

POST/api/fremdvertrag/{id}/beendigung

Beendet den Vertrag zum Tag beendetAm (nicht vor dem Beginn, optional grund). Die Vertrags-Id steht im Pfad.

operationId: beendeFremdvertrag · Auth: bearerAuth

Request-Body (Pflicht): application/json → FremdvertragBeendigungRequest

POST/api/fremdvertrag/{id}/dauerzahlung

Verknüpft den Vertrag mit einer Dauerzahlung desselben Objekts. Weichen Beitrag und Dauerzahlung ab, nennt die Antwort den Befund; er sperrt nicht. Die Vertrags-Id steht im Pfad.

operationId: verknuepfeFremdvertragDauerzahlung · Auth: bearerAuth

Request-Body (Pflicht): application/json → FremdvertragDauerzahlungRequest

POST/api/fremdvertrag/{id}/dauerzahlung/loesen

Löst die Verknüpfung des Vertrags mit seiner Dauerzahlung (Body {}). Die Dauerzahlung selbst bleibt unberührt. Die Vertrags-Id steht im Pfad.

operationId: loeseFremdvertragDauerzahlung · Auth: bearerAuth

Request-Body (Pflicht): application/json → FremdvertragDauerzahlungLoesenRequest

POST/api/fremdvertrag/{id}/frist-entscheid

Hält die Entscheidung zu einem Vertragsende fest: bezugEnde, entscheidung (verlaengern | kuendigen | neu_ausschreiben), optional grund. Es wird nie eine Kündigung angelegt. Danach verschwindet die Zeile aus dem Fristenwächter. Die Vertrags-Id steht im Pfad.

operationId: entscheideFremdvertragFrist · Auth: bearerAuth

Request-Body (Pflicht): application/json → FremdvertragFristEntscheidRequest

POST/api/fremdvertrag/{id}/konditionen

Legt eine neue Konditions-Version des Vertrags an (kein Teil-Patch: jeder Schlüssel ist Pflicht, leer ist null). gueltigAb muss nach dem gueltigAb der letzten Version liegen. Die Vertrags-Id steht im Pfad.

operationId: aendereFremdvertragKonditionen · Auth: bearerAuth

Request-Body (Pflicht): application/json → FremdvertragKonditionenRequest

POST/api/fremdvertrag/{id}/kuendigung

Hält die Kündigung des Vertrags fest (wirksamZum nicht vor heute, optional grund). Die Antwort nennt das früheste Vertragsende und den spätesten Zugang als Auskunft; sie sperrt nicht. Die Vertrags-Id steht im Pfad.

operationId: kuendigeFremdvertrag · Auth: bearerAuth

Request-Body (Pflicht): application/json → FremdvertragKuendigungRequest

GET/api/fremdvertrag/einstellung

Liest die Einstellung der Verträge mit Dritten des Mandanten: Vorlauf-Tage, Vorgaben für die Verlängerung, Meldefrist für Schadenfälle, Schadenhonorar (Basispunkte und Text) und Herkunft (vorgabe | mandant). Ohne gespeicherte Einstellung gilt die Vorgabe. Nur lesend.

operationId: getFremdvertragEinstellung · Auth: bearerAuth

PUT/api/fremdvertrag/einstellung

Setzt die Einstellung der Verträge mit Dritten des Mandanten (alle sechs Werte, kein Teil-Patch): vorlaufTage, Vorgaben für die Verlängerung, schadenMeldefristTage, Schadenhonorar in Basispunkten und ob es aktiv ist. Nur ein Mensch mit dem Recht, Rollen und Rechte zu verwalten.

operationId: setzeFremdvertragEinstellung · Auth: bearerAuth

Request-Body (Pflicht): application/json → FremdvertragEinstellungSetzenRequest

GET/api/fremdvertrag/fristen

Liest den Fristenwächter der Verträge mit Dritten: je Vertrag kategorie (kuendigungsfrist | frist-verpasst | ohne-laufzeit), spaetesterZugang, aufgabeAb, tageBisFrist, Ampel und offen. Filter stichtag (Vorgabe: Berliner Tag der Server-Uhr), propertyId, art, nurOffen (Vorgabe true) und mitUeberwachungsluecken (Verträge ohne Laufzeitende). Nur lesend, begrenzt auf die Objekte mit Zuständigkeit des Aufrufers.

operationId: getFremdvertragFristen · Auth: bearerAuth

GET/api/gebaeude

Listet Gebäude (3-Wege-Filter Alle/Aktiv/Archiviert, Default aktiv; optional je Objekt).

operationId: listGebaeude · Auth: bearerAuth

POST/api/gebaeude

Legt ein Gebäude an einem aktiven Objekt an.

operationId: createGebaeude · Auth: bearerAuth

Request-Body (Pflicht): application/json → GebaeudeCreateRequest

GET/api/gebaeude/{id}

Liest EIN Gebäude (auch archiviert).

operationId: getGebaeude · Auth: bearerAuth

PATCH/api/gebaeude/{id}

Ändert die Gebäude-Adresse (nur nicht-archivierte Gebäude).

operationId: updateGebaeude · Auth: bearerAuth

Request-Body (Pflicht): application/json → GebaeudeUpdateRequest

POST/api/gebaeude/{id}/archive

Archiviert ein Gebäude (archived_at statt DELETE, K5). Kaskadiert abwärts: alle Einheiten des Gebäudes werden mitarchiviert (#445).

operationId: archiveGebaeude · Auth: bearerAuth

POST/api/gebaeude/{id}/reactivate

Nimmt die Archiv-Kaskade eines Gebäudes zurück (#445) — nur der eigene Teilbaum, nie aufwärts.

operationId: reactivateGebaeude · Auth: bearerAuth

GET/api/health

Liveness der Web-App (App-Prozess + DB-Erreichbarkeit).

operationId: getHealth · Auth: keine (öffentlich)

GET/api/honorar/anpassungen

Geschichte der Honorar-Anpassungen EINES Objekts, neueste zuerst — ohne den Akteur, der sie vorgenommen hat.

operationId: listHonorarAnpassungen · Auth: bearerAuth

POST/api/honorar/anpassungen

Passt die Honorarvereinbarung eines Objekts an (passe_honorarvereinbarung_an): neue Zeitscheibe ab einem Monatsersten, die laufende endet am Vortag. WEG nur mit tragendem Beschluss, keine Rückwirkung auf gestellte Monate. Derselbe Idempotency-Key legt die Anpassung nur einmal an.

operationId: passeHonorarvereinbarungAn · Auth: bearerAuth

Request-Body (Pflicht): application/json → PasseHonorarvereinbarungAnRequest

POST/api/honorar/lauf

Stellt das Verwalterhonorar EINES Objekts für EINE Periode — Monat oder Quartal, passend zum Rhythmus (#5583) — (stelle_verwalterhonorar): Soll Aufwand „Verwaltervergütung" an Haben Kreditor Verwalter, Rechnungsnummer aus dem Nummernkreis des Verwalters (HON-nnnnnn). NUR mit dem Inhalts-Hash aus POST /api/honorar/lauf/vorschlag. Genau einmal je Periode — ein zweiter Start ist `unveraendert`, eine geänderte Vereinbarung eine Differenzbuchung. Bei vereinbarter Entnahme ein Zahlungsauftrag `awaiting-approval` in der bestehenden Zahlungsfreigabe (gib_zahlungsauftrag_frei, Vier-Augen) — nie direkt ausgeführt.

operationId: stelleVerwalterhonorar · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/honorar/lauf/storno

Storniert den Honorarlauf EINES Objekts für EINE Periode — Monat oder Quartal (#5583) — (storniere_verwalterhonorar): je wirksamer Honorarbuchung ein Storno-Satz über den bestehenden Storno-Weg (storno_entry, Periode des Originals) und Abbruch noch nicht eingereichter Entnahmeaufträge. Danach ist die Periode neu stellbar.

operationId: storniereVerwalterhonorar · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/honorar/lauf/vorschlag

Vorschlag des Honorarlaufs EINES Objekts für EINE Periode (Monat oder Quartal, passend zum Rhythmus, #5583): die Rechnung aus der Honorarvorschau, das für die Periode schon Gebuchte, die Differenz, ob eine Entnahme entstünde, und der Inhalts-Hash — ohne zu schreiben.

operationId: honorarlaufVorschlag · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/honorar/rentabilitaet

Rentabilität EINES Objekts über einen Zeitraum ganzer Monate: Ertrag, Aufwand, Deckungsbeitrag, Marge, Kapazitätsanteil und Urteil samt den geltenden Kalkulationssätzen. Ohne erfasste Zeit lautet das Urteil nicht-beurteilbar, nie wirtschaftlich.

operationId: getRentabilitaet · Auth: bearerAuth

POST/api/honorar/sonderleistungen

Erfasst EINE Sonderleistung (erfasse_sonderleistung) mit dem Preis-Schnappschuss aus dem Katalog des Objekts. Derselbe Idempotency-Key legt sie nur einmal an.

operationId: erfasseSonderleistung · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/honorar/sonderleistungen/serie

Serienerfassung (erfasse_sonderleistungsserie): EINE Leistung mit Preis je Einheit für jede Einheit, die am Leistungsdatum zum Objekt gehört — in einem Schritt (z. B. § 35a-Bescheinigung). Dieselbe Serie (Objekt, Leistung, Leistungsdatum) entsteht nur einmal; eine Wiederholung meldet bereitsErfasst: true.

operationId: erfasseSonderleistungsserie · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/honorar/sonderleistungen/storno

Storniert eine erfasste Sonderleistung (storniere_sonderleistung). Sie bleibt auffindbar, zählt aber in keiner Honorarrechnung mehr.

operationId: storniereSonderleistung · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/honorar/sonderleistungen/vorlage

Kopiert den Vorlage-Katalog des Mandanten (Mandanten-Option `verwalterhonorar.sonderleistungen`) als EIGENEN Sonderleistungs-Katalog an ein Objekt (uebernimm_sonderleistungsvorlage). Eine Kopie, kein Verweis; ein vorhandener Katalog wird nie überschrieben.

operationId: uebernimmSonderleistungsvorlage · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/honorar/vorschau

Verwalterhonorar EINES Objekts für EINEN Monat als Vorschau: Positionsaufstellung je Einheit/Basis/Zuschlag, Netto, Umsatzsteuer und Brutto — ohne Buchung.

operationId: getHonorarVorschau · Auth: bearerAuth

GET/api/inkasso

Listet die Inkasso-Übergaben des Mandanten, neueste zuerst; Query `objekt` (UUID) und `status` (entwurf | uebergeben | zurueckgenommen | abgeschlossen). Nur lesend. Die Übergabe ist ein Datensatz: sie sendet nichts an Dritte und erzeugt kein Partnerformat.

operationId: listeInkassoUebergaben · Auth: bearerAuth

POST/api/inkasso

Legt eine Inkasso-Übergabe als ENTWURF an (lege_inkasso_uebergabe_an): je Posten offener Rest, Fälligkeit, Mahnstufe, Mahngebühren und Verzugszinsen bis zum Stichtag; die Forderungsaufstellung wird gebildet, gehasht und eingefroren. Voraussetzung ist Mahnstufe 3 oder anwalt; darunter nur mit `begruendungMahnstufe`. Die Übergabe ist ein Datensatz: sie sendet nichts an Dritte und erzeugt kein Partnerformat. Derselbe Posten kann nicht in zwei aktiven Übergaben stehen (409). Der Idempotency-Key kommt vom Aufrufer.

operationId: legeInkassoUebergabeAn · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/inkasso/{id}

Liest EINE Inkasso-Übergabe samt eingefrorener Forderungsaufstellung (ausgeschrieben, Cent als Integer-Strings) und Postenliste. Unbekannt und mandantenfremd antworten gleich. Nur lesend.

operationId: getInkassoUebergabe · Auth: bearerAuth

POST/api/inkasso/{id}/abschluss

Schließt die übergebene Inkasso-Übergabe ab (schliesse_inkasso_uebergabe_ab): Body `{ art, notiz? }` mit art bezahlt | vergleich | uneinbringlich | sonstiges. Die Posten werden frei. Der Idempotency-Key kommt vom Aufrufer.

operationId: schliesseInkassoUebergabeAb · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/inkasso/{id}/forderungsaufstellung

Lädt die eingefrorene Forderungsaufstellung als CSV-Datei in einer JSON-Antwort (`datei`: dateiname, sha256, groesseBytes, inhaltBase64; dazu `aufstellungHash`). Semikolon-getrennt, UTF-8 mit BOM, Dezimalkomma; zweimal geladen ⇒ byte-gleich. Der Dateiname trägt keine Personenangaben. Reiner Lesezugriff — nichts wird geschrieben; `Cache-Control: no-store`.

operationId: getInkassoForderungsaufstellung · Auth: bearerAuth

POST/api/inkasso/{id}/uebergabe

Übergibt den Entwurf (uebergebe_inkasso): setzt den Mahnstatus jedes Postens auf „Beim Rechtsanwalt" (anwalt), in derselben Transaktion. Body `{ uebergebenAm }`. Sendet nichts an Dritte. Eine zweite Übergabe ⇒ 409. Der Idempotency-Key kommt vom Aufrufer.

operationId: uebergebeInkasso · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/inkasso/{id}/zuruecknahme

Nimmt die Übergabe mit Pflichtgrund zurück (nimm_inkasso_uebergabe_zurueck): die Posten werden frei; der Mahnstatus wird NICHT zurückgestuft. Body `{ grund }` (höchstens 500 Zeichen). Ohne Grund ⇒ 400. Der Idempotency-Key kommt vom Aufrufer.

operationId: nimmInkassoUebergabeZurueck · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/instandhaltung

Liest die Instandhaltungs-Vorgänge des Mandanten, begrenzt auf die Objekte mit Zuständigkeit des Aufrufers: Nummer, Titel, Typ, Dringlichkeit, Status, Objekt, Einheit, Auftragswert (Cent als Integer-STRING), Auftragsnummer und die Zahl offener Befunde. Filter propertyId, status, dringlichkeit, typ, nurOffen (ohne abgeschlossen und storniert), limit (Vorgabe 50, höchstens 200) und offset. Nur lesend.

operationId: getInstandhaltungListe · Auth: bearerAuth

POST/api/instandhaltung

Erfasst eine Meldung: Pflicht propertyId, typSchluessel (aktiver Vorgangstyp), titel, beschreibung, dringlichkeit; optional unitId, melderPersonId, beginnAm, haeufigkeit, baulichVeraendernd. Der Vorgang entsteht im Status gemeldet mit Nummer. Der Idempotenz-Schlüssel kommt vom Aufrufer (Header).

operationId: meldeInstandhaltung · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungMeldenRequest

GET/api/instandhaltung/{id}

Liest EINEN Instandhaltungs-Vorgang mit Verlauf, Angeboten, Aufträgen, Freigabestand des lebenden Auftrags, Rechnungen mit Zahlungsstand (nicht-gebucht | nicht-ermittelbar | offen | ausgeglichen), Befunden und nächsten Schritten. Optional stichtag (Vorgabe: Berliner Tag der Server-Uhr). Nur lesend.

operationId: getInstandhaltungVorgang · Auth: bearerAuth

POST/api/instandhaltung/{id}/abschluss

Schließt den Vorgang ab; optional begruendung. Die Vorgangs-Id steht im Pfad.

operationId: schliesseInstandhaltungVorgang · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungAbschlussRequest

POST/api/instandhaltung/{id}/angebot

Erfasst das Angebot eines zugeordneten Dienstleisters: dienstleisterPersonId, betrag als Objekt {cents, currency}, optional gueltigBis, realisierungAb, dokumentId. Die Vorgangs-Id steht im Pfad.

operationId: erfasseInstandhaltungAngebot · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungAngebotRequest

POST/api/instandhaltung/{id}/angebot/verwerfen

Verwirft ein Angebot des Vorgangs mit Grund. Die Vorgangs-Id steht im Pfad.

operationId: verwerfeInstandhaltungAngebot · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungAngebotVerwerfenRequest

POST/api/instandhaltung/{id}/angebot/waehlen

Wählt ein vorliegendes Angebot des Vorgangs. Die Vorgangs-Id steht im Pfad.

operationId: waehleInstandhaltungAngebot · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungAngebotWaehlenRequest

POST/api/instandhaltung/{id}/auftrag

Erteilt den Auftrag des Vorgangs, nachdem die Kostenfreigabe vollständig ist: optional auftragId (ohne Angabe der lebende Auftrag des Vorgangs). Ein Auftrag ohne gültige Freigabe wird nie erteilt (409). Gestattungs- und Freistellungsbefunde sind Warnungen, die Erteilung läuft trotzdem. Die Vorgangs-Id steht im Pfad.

operationId: erteileInstandhaltungAuftrag · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungAuftragErteilenRequest

POST/api/instandhaltung/{id}/auftrag/ausfuehrung

Meldet die Ausführung des erteilten Auftrags: ausgefuehrtAm (nicht nach heute, nicht vor der Erteilung), optional notiz und auftragId (ohne Angabe der lebende Auftrag). Die Vorgangs-Id steht im Pfad.

operationId: meldeInstandhaltungAusfuehrung · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungAuftragAusfuehrungRequest

POST/api/instandhaltung/{id}/auftrag/stornieren

Storniert den Auftrag des Vorgangs mit Grund (Pflicht); optional auftragId. Nach der Freigabe fällt der Vorgang zurück in angebote_offen, eine neue Freigabe ist nötig. Ein ausgeführter Auftrag oder ein Auftrag mit Rechnung lässt sich nicht mehr stornieren (409). Die Vorgangs-Id steht im Pfad.

operationId: storniereInstandhaltungAuftrag · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungAuftragStornierenRequest

POST/api/instandhaltung/{id}/dienstleister

Weist dem Vorgang einen Dienstleister zu; es entsteht ein Angebot im Status angefragt. Die Vorgangs-Id steht im Pfad.

operationId: weiseInstandhaltungDienstleisterZu · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungDienstleisterRequest

POST/api/instandhaltung/{id}/freigabe

Beantragt die Kostenfreigabe des Vorgangs (Auftrag im Status zur_freigabe): optional angebotId, kostenobergrenze als Objekt {cents, currency}, dienstleisterPersonId, costCategoryId. Zu einem Vorgang mit lebendem Auftrag ist ein zweiter Antrag ein Konflikt. Die Vorgangs-Id steht im Pfad.

operationId: beantrageInstandhaltungKostenfreigabe · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungFreigabeBeantragenRequest

POST/api/instandhaltung/{id}/freigabe/entscheid

Entscheidet eine Stufe (verwalter, zweit) der Kostenfreigabe des Vorgangs: approved oder rejected mit rejectReason. Eine zweite Stufe ist nur bei aktivem Vier-Augen-Schalter und erreichter Schwelle nötig. Der Antragsteller kann bei aktivem Vier-Augen nicht selbst freigeben (403). Die Vorgangs-Id steht im Pfad.

operationId: entscheideInstandhaltungKostenfreigabe · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungFreigabeEntscheidenRequest

POST/api/instandhaltung/{id}/qualifizieren

Qualifiziert einen Vorgang: Typ, Dringlichkeit, baulich verändernd, Gestattungsbeschluss, Beginn und Häufigkeit, oder ausdrücklich beginnUnbekannt. Die Vorgangs-Id steht im Pfad, nie im Body. Aus gemeldet wird in_klaerung.

operationId: qualifiziereInstandhaltungVorgang · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungQualifizierenRequest

POST/api/instandhaltung/{id}/rechnung

Verknüpft einen Rechnungsbeleg mit dem ausgeführten Auftrag: documentId, rechnungsdatum, optional auftragId. Befunde (freistellung-fehlt, rechnung-ueber-auftrag, gestattungsbeschluss-fehlt) sperren nicht: die Verknüpfung gelingt und nennt sie. Die harte Sperre der Zahlung ohne Freistellungsbescheinigung liegt im Zahlungsauftrag. Die Vorgangs-Id steht im Pfad.

operationId: verknuepfeInstandhaltungRechnung · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungRechnungRequest

POST/api/instandhaltung/{id}/stornieren

Storniert den Vorgang mit Grund (Pflicht). Läuft noch ein Auftrag, ist erst der Auftrag zu stornieren (409). Die Vorgangs-Id steht im Pfad.

operationId: storniereInstandhaltungVorgang · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungVorgangStornierenRequest

GET/api/instandhaltung/aufgaben

Liest die offene Instandhaltung-Arbeit als abgeleitete Aufgaben (sofort-unbearbeitet, angebot-ausstehend, freigabe-wartet, rechnung-fehlt) der Objekte mit Zuständigkeit des Aufrufers. Optional stichtag (Vorgabe: Berliner Tag der Server-Uhr) und propertyId. Nur lesend.

operationId: getInstandhaltungAufgaben · Auth: bearerAuth

GET/api/instandhaltung/einstellung

Liest die Instandhaltung-Einstellung des Mandanten: Zweitfreigabe-Schwelle, Vergleichsangebote-Schwelle (Cent als Integer-STRING), Mindestangebote und die Herkunft (vorgabe | mandant). Nur lesend.

operationId: getInstandhaltungEinstellung · Auth: bearerAuth

PUT/api/instandhaltung/einstellung

Setzt die Instandhaltung-Einstellung des Mandanten: zweitfreigabeAbCents (Cent als Integer-String, null = nie), vergleichsangeboteAbCents, mindestangebote. Nur ein Mensch mit Recht (sonst 403).

operationId: setzeInstandhaltungEinstellung · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungEinstellungSetzenRequest

GET/api/instandhaltung/katalog

Liest den aufgelösten Vorgangstypen-Katalog des Mandanten (Vorgabe plus Abweichungen); standardmäßig nur aktive Typen, mit auchInaktive=true alle. Nur lesend.

operationId: getInstandhaltungKatalog · Auth: bearerAuth

PUT/api/instandhaltung/katalog

Legt einen Vorgangstyp im Katalog des Mandanten an oder ändert ihn: schluessel, bezeichnung, ohneAngebotErlaubt, aktiv. Nur ein Mensch mit Recht (sonst 403).

operationId: setzeInstandhaltungVorgangstyp · Auth: bearerAuth

Request-Body (Pflicht): application/json → InstandhaltungKatalogSetzenRequest

GET/api/kaution

Liest die Kautionsliste des Mandanten zum Stichtag: vereinbart · erhalten · offen · getrennte Anlage (§ 551 BGB).

operationId: listKautionsliste · Auth: bearerAuth

GET/api/kaution/abrechnung

Liest den gespeicherten Abrechnungsstand EINES Vertrags (nicht stornierte Kautionsabrechnung) mit Rückbehalt-Status keiner | gehalten | teilfreigegeben | freigegeben, dem noch gehaltenen Rest und den Teilfreigaben.

operationId: getKautionsabrechnungStand · Auth: bearerAuth

POST/api/kaution/abrechnung

Rechnet die Kaution eines beendeten Vertrags ab (rechne_kaution_ab): Kaution + Zinsen − ausgewählte fällige Forderungen dieses Vertrags (Verrechnung über die bestehende OP-Verrechnung) − Rückbehalt mit Grundart (BK-Nachzahlung gedeckelt, Sonstiges mit Begründung). Bucht NUR mit hashgebundener Freigabe des Inhalts (vorschlagHash aus POST /api/kaution/abrechnung/vorschlag, freigegeben über POST /api/kaution/abrechnung/freigabe). Die Auszahlung geht als Zahlungsauftrag in die bestehende Freigabe (gib_zahlungsauftrag_frei, Vier-Augen) — nie direkt. Genau einmal je Vertrag.

operationId: rechneKautionAb · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/kaution/abrechnung/freigabe

Gibt einen Vorschlag der Kautionsabrechnung, Rückbehalt-Freigabe bzw. des Stornos frei (gib_kautionsabrechnung_frei): bindet die Freigabe an genau den vorgelegten Inhalts-Hash, bucht selbst nichts. Erst danach buchen POST /api/kaution/abrechnung, POST /api/kaution/rueckbehalt-freigabe bzw. POST /api/kaution/abrechnung/storno.

operationId: gibKautionsabrechnungFrei · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/kaution/abrechnung/storno

Storniert eine ausgeführte Kautionsabrechnung (storniere_kautionsabrechnung): NUR mit hashgebundener Freigabe (vorschlagHash aus POST /api/kaution/abrechnung/vorschlag, art storno, freigegeben über POST /api/kaution/abrechnung/freigabe). Danach ist POST /api/kaution/abrechnung für denselben Vertrag wieder möglich.

operationId: storniereKautionsabrechnung · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/kaution/abrechnung/vorschlag

Berechnet den VORSCHLAG einer Kautionsabrechnung (art abrechnung), einer Rückbehalt-Freigabe (art rueckbehalt) bzw. eines Stornos (art storno) samt Inhalts-Hash — mit derselben Rechnung wie die Ausführung, ohne zu schreiben.

operationId: kautionsabrechnungsvorschlag · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/kaution/eingang

Verbucht einen Bankumsatz des am Vertrag hinterlegten Kautionskontos als Eingang der Kaution (verbuche_kautionseingang): Bank an Kautions-Personenkonto des Mieters, mit Buchungsanspruch und Tilgung der offenen Raten — ohne Zuordnung zum Mietkonto. Nur bei Barkaution.

operationId: verbucheKautionseingang · Auth: bearerAuth

Request-Body (Pflicht): application/json

GET/api/kaution/einstellung

Liest die Kaution-Einstellung des Mandanten: die Frist des Rückbehalts in Monaten (Vorgabe 6; beginnt mit dem Abrechnungsdatum der Kautionsabrechnung) und `istVorgabe` (true, solange der Mandant nichts eingestellt hat).

operationId: getKautionEinstellung · Auth: bearerAuth

PUT/api/kaution/einstellung

Setzt die Frist des Rückbehalts des Mandanten (setze_kaution_rueckbehalt_frist): ganze Zahl 1…36 Monate. Nur ein Mensch mit Admin-Recht (rollenrechte.verwalten). Gilt nur für neue Abrechnungen — das Wiedervorlage-Datum wird beim Buchen an der Abrechnung festgeschrieben, bestehende bleiben unverändert. Idempotent: derselbe Wert nochmal ändert nichts.

operationId: setzeKautionRueckbehaltFrist · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/kaution/freigabe

Gibt einen Kautions-Vorschlag frei (gib_kaution_frei): bindet die Freigabe an genau den vorgelegten Inhalts-Hash. Erst danach buchen POST /api/kaution/sollstellung bzw. POST /api/kaution/eingang.

operationId: gibKautionFrei · Auth: bearerAuth

Request-Body (Pflicht): application/json

POST/api/kaution/rueckbehalt-freigabe

Gibt den Rückbehalt einer Kautionsabrechnung als eigenen Schritt frei (gib_kautionsrueckbehalt_frei): optional gegen dann fällige Forderungen dieses Vertrags verrechnet, der Rest als Zahlungsauftrag in die bestehende Freigabe. Mit betragCents nur einen TEILBETRAG (#6900): Status teilfreigegeben mit Rest, der letzte Schritt (Rest 0) freigegeben; ohne betragCents der ganze Rest. Jeder Schritt bucht NUR mit hashgebundener Freigabe seines Inhalts (art rueckbehalt).

operationId: gibKautionsrueckbehaltFrei · Auth: bearerAuth

Request-Body (Pflicht): application/json