Dokumentation | API-Referenz

Übersicht

Eine Quittung gruppiert eine oder mehrere Zahlungen und Gebühren in ein bestätigbares Dokument. Der Quittungsbetrag wird automatisch als Summe aller verknüpften Zuordnungen berechnet. Jeder Zuordnungsbetrag kann inline geändert werden, wobei automatisch Korrektureinträge beim Anbieter erstellt werden.

Automatische Berechnung

Quittungsbetrag = Summe aller verknüpften Zahlungen + Gebühren + Einmalausgaben. Keine manuelle Eingabe — alles wird automatisch berechnet.

Inline-Korrekturen

Ändern Sie den Zuordnungsbetrag direkt auf der Quittungsseite. Das System erstellt automatisch eine Korrektur mit dem Dienstleister.

Einmalausgaben

Fügen Sie Einmalausgaben (Reparaturen, Dienstleistungen) direkt aus der Quittung hinzu. Das System erstellt automatisch Belastung + Zahlung + Zuordnung.

Beidseitige Bestätigung

Sowohl Vermieter als auch Mieter müssen die Quittung unabhängig bestätigen für vollständige Validierung.

Mehrwährungsunterstützung

Quittungen werden automatisch in die Landeswährung der Immobilie umgerechnet, wenn sie sich von der Quittungswährung unterscheidet.

Dokumentanhang

Fügen Sie einen Scan der Bankbestätigung oder des Kassenbelegs im Format PDF, JPG, PNG oder HEIC bei.

Architektur

Quittungen sind über Zuordnungen mit Zahlungen verbunden. Wenn der Zuordnungsbetrag von der ursprünglichen Zahlung abweicht, werden automatisch eine Korrekturverknüpfung und eine Anbieterkorrektur erstellt.

Receipt Automatische Summe, Notizen, Bestätigungen

↕

PaymentAllocation Verknüpft Quittung ↔ Zahlung mit bearbeitbarem Betrag

↙ ↘

Payment Originalzahlung vom Mieter

AdjustmentLink Original → korrigierter Betrag, Differenz

↓

ServiceProviderAdjustment Saldokorrektur mit Dienstleister

Korrekturprozess

Wenn Sie den Zuordnungsbetrag auf der Quittungsseite ändern:

1

Betrag bearbeiten

Klicken Sie auf das Stiftsymbol neben dem Zahlungsbetrag. Geben Sie den neuen Betrag in der Immobilienwährung ein.

2

Korrekturverknüpfung erstellt

System erstellt ReceiptAdjustmentLink mit: Originalbetrag, korrigiertem Betrag und Differenz. Eine Verknüpfung pro Zuordnung.

3

Anbieterkorrektur

Wenn die Zahlung mit einer Ausgabe mit Anbieter verknüpft ist (Payment → ExpenseCharge → PropertyExpense → ExpenseProvider), wird eine ServiceProviderAdjustment automatisch erstellt/aktualisiert. Automatische Bestätigung von der Ersteller-Seite.

4

Automatische Bereinigung

Wenn korrigierter Betrag = Originalbetrag (Differenz = 0), werden Korrekturverknüpfung und Anbieterkorrektur automatisch gelöscht.

Fall ohne Anbieter: Mietgebühren und einfache Zahlungen haben keinen Dienstleister. In diesem Fall wird nur der AdjustmentLink erstellt (ohne ServiceProviderAdjustment).

Bestätigung und Bearbeitungsregeln

Quittungen verwenden ein zweiseitiges Bestätigungssystem, das Bearbeitungsrechte steuert:

Nicht bestätigt

Standard. Keine Seite hat bestätigt. Vollständige Bearbeitung verfügbar.

Bestätigt

Eine Seite hat bestätigt. Die bestätigende Seite kann widerrufen. Die andere Seite kann bearbeiten.

Vollständig bestätigt

Beide Seiten haben bestätigt. Quittung gesperrt — keine Bearbeitung, kein Anhängen/Trennen von Zahlungen, keine Dokumentänderungen.

Sperrregel: Wenn die ANDERE Seite bestätigt, wird die Bearbeitung für Sie gesperrt. Beispiel: Wenn der Mieter bestätigt, kann der Vermieter keine Beträge mehr ändern, Zahlungen anhängen oder Dokumente hochladen. Nur Bestätigungs-/Widerrufsschaltflächen bleiben aktiv.

Verknüpfung mit Zahlungen

Auf der Quittungsseite können Sie bestehende Zahlungen anhängen oder neue Einmalausgaben erstellen:

Bestehende Zahlung anhängen

Wählen Sie aus verfügbaren Zahlungen/Gebühren in der Dropdown-Liste. Der Betrag wird automatisch in der Immobilienwährung ausgefüllt. Sie können ihn ändern, um eine Korrektur zu erstellen.

Einmalausgabe hinzufügen

Geben Sie einen Namen und Betrag ein. System erstellt: ExpenseCharge (Typ ONE_TIME) → Payment → Allocation. Beide Felder erforderlich.

Zahlung trennen

Zahlung von der Quittung entfernen. Dies löscht auch automatisch die zugehörige Korrekturverknüpfung und Anbieterkorrektur.

Mehr erfahren: Für detaillierte Informationen zu Zahlungen siehe Zahlungen.

Inline-Bearbeitung

Die Quittungsansicht unterstützt Inline-Bearbeitung ohne Navigation zu einem separaten Formular:

Notizen (WYSIWYG)

Klicken Sie auf das Stiftsymbol, um den Rich-Text-Editor (Summernote) zu öffnen. Unterstützt Fett, Kursiv, Listen und Links. Speichert per AJAX ohne Seitenneuladen.

Zahlungsbeträge

Klicken Sie auf das Stiftsymbol neben dem Zahlungsbetrag, um ihn zu ändern. Speichert per AJAX. Erstellt/aktualisiert/entfernt Korrekturen automatisch.

Dokument hochladen

Datei ziehen oder auswählen. Unterstützt JPG, PNG, PDF, HEIC (max. 20 MB). Dokumente werden automatisch mit Google Drive synchronisiert.

Sichtbarkeitsregeln

Rolle	Kann sehen
LANDLORD / AGENT	Alle Quittungen für eigene Immobilien
TENANT / AGENT	Quittungen im Zusammenhang mit ihren Verträgen und Zahlungen

REST API

Zugriff auf Quittungen über REST API (erfordert JWT-Authentifizierung):

GET    /api/v1/receipts                              - Meine Quittungen auflisten
GET    /api/v1/properties/{id}/receipts              - Immobilienquittungen auflisten
GET    /api/v1/properties/{id}/receipts/{rid}        - Quittungsdetails abrufen

Vollständige API-Dokumentation mit interaktiven Tests ist in Swagger UI verfügbar: /api/v1/doc