Docs

VERTRAG

Dokumentation

VERTRAG

Mit VERTRAG verwalten Sie Mietverträge / Vorgänge zwischen Vermieter und Mieter.

Pro Vertrag können Sie hinterlegen:

  • Vermieter und Mieter (siehe VERMIETER, MIETER)
  • Zeitraum (Beginn, Ende)
  • zugeordnetes Inventar (Mengen, optional Preise)
  • Techniker / Helfer
  • Kommentare und Dokumente (Uploads)
  • Status / Kanban-Spalte (siehe KANBAN)
  • digitale Unterschriften (Vermieter & Mieter)
  • generiertes PDF des Vertrags
  • generierte Rechnung (HTML/PDF) aus den Vertragsdaten (M27)

  • Vertrag anlegen und Daten pflegen
  • Inventar zuweisen
  • PDF generieren
  • Rechnung aus dem Vertrag generieren (HTML/PDF)
  • Vertrag von Vermieter und/oder Mieter unterschreiben lassen
  • Per Kanban-Drag&Drop in eine andere Spalte schieben
  • Anhänge hochladen (z.B. Ausweis, AGB, Auftragsbestätigung)
  • Verträge filtern (z.B. nur offene, nur abgeschlossene)
  • Verträge löschen (Soft) und ggf. wiederherstellen oder endgültig löschen

1) Vertrag anlegen

  1. Öffnen Sie Vertrag → Verträge (/dokumente/vertraege).
  2. „Neu“ klicken (/dokumente/vertraege/new).
  3. Pflichtfelder ausfüllen:
    • Mieter (Auswahl oder neu anlegen)
    • Vermieter
    • Zeitraum
  4. Speichern.

2) Vertrag bearbeiten

  1. Vertrag in der Liste anklicken (/dokumente/vertraege/{id}).
  2. Felder ändern und speichern.
  3. Auf der Detailseite zusätzlich verfügbar:
    • Kommentare hinzufügen
    • Dokumente hochladen / herunterladen / löschen
    • Inventar zuweisen (Auswahlliste oder Schnellsuche per Name)
    • Techniker zuweisen
    • PDF generieren
    • Unterschriften erfassen / Signatur-Link erzeugen

3) Inventar zum Vertrag hinzufügen

  1. Auf der Detailseite den Bereich Inventar öffnen.
  2. Item auswählen (oder per Name suchen, „Quick add“).
  3. Menge setzen.
  4. Speichern. Das Item wird mit Tagessatz übernommen, sofern hinterlegt.

Items entfernen: Auf das X / „Entfernen“ neben dem Eintrag klicken.

4) Vertrag in der Kanban-Ansicht verschieben

  • In der Kanban-Übersicht Karte per Drag&Drop in eine andere Spalte ziehen.
  • Im Hintergrund wird /dokumente/vertraege/kanban/move aufgerufen.
  • Siehe Plugin KANBAN für die Spalten-Konfiguration.

5) Vertrags-PDF erzeugen

  1. Auf der Detailseite (sofern TEMPLATING aktiv ist) im Template-Auswahlmenü eine VERTRAG-Vorlage wählen. „Standard“ nutzt die Standardvorlage für VERTRAG.
  2. Mit „PDF generieren“ wird das PDF geöffnet bzw. erzeugt: GET /dokumente/vertraege/{id}/pdf. Ohne Parameter nutzt die App das gespeicherte, geschützte Vertrags-PDF (bzw. regeneriert es, wenn der Vertrag nicht gesperrt ist). Mit template={uuid} wird die gewählte Vorlage on-the-fly gerendert.
  3. Optional kann über type ein anderer Dokumenttyp gerendert werden – Details siehe Abschnitt 6.

> Layout und Inhalt der generierten Dokumente werden über das TEMPLATING-Plugin gesteuert. Dort legen Sie Vorlagen für VERTRAG und RECHNUNG an und wählen pro Typ die Standardvorlage.

6) Als Rechnung generieren

  1. Auf der Detailseite die Buttons „Als Rechnung generieren“ und „Rechnung als PDF“ nutzen (nur sichtbar, wenn TEMPLATING aktiv ist).
  2. „Als Rechnung generieren“ öffnet die HTML-Ansicht: GET /dokumente/vertraege/{id}/generate?type=RECHNUNG.
  3. „Rechnung als PDF“ erzeugt das PDF: GET /dokumente/vertraege/{id}/pdf?type=RECHNUNG.
  4. Ohne template-Parameter wird die Standard-RECHNUNG-Vorlage verwendet. Mit template={uuid} wird eine explizit gewählte RECHNUNG-Vorlage gerendert; der Typ muss zur Vorlage passen, sonst erhält man einen Fehler (HTTP 400).
  5. On-the-fly generierte Rechnungen werden nicht als Vertrags-Dokument gespeichert und nicht im Änderungslog protokolliert.

7) Vertrag unterschreiben lassen

a) Vermieter-Unterschrift (intern)

  1. Auf der Detailseite „Vermieter unterschreiben“ klicken (POST /dokumente/vertraege/{id}/sign-vermieter).
  2. Mit Maus / Touchpad / Stift unterschreiben → speichern.

b) Mieter-Unterschrift (per Link extern)

  1. Auf der Detailseite „Signatur-Link erzeugen“ klicken (POST /dokumente/vertraege/{id}/sign/generate-token).
  2. Es wird ein Token-Link erzeugt: /dokumente/vertraege/sign/{token}.
  3. Diesen Link an den Mieter senden (z.B. per Mail).
  4. Der Mieter öffnet den Link, sieht die Vertragsübersicht und unterschreibt direkt im Browser. Es ist kein Login nötig.
  5. Nach dem Speichern erscheint die Unterschrift am Vertrag.

> Der Link ist nur gültig, solange der Token aktiv ist und der Vertrag nicht vollständig unterschrieben wurde.

8) Vertrag löschen / wiederherstellen

  • Löschen (Soft): POST /dokumente/vertraege/{id}/delete – Vertrag wird ausgeblendet, bleibt aber in der DB.
  • Wiederherstellen: POST /dokumente/vertraege/{id}/restore
  • Endgültig löschen: POST /dokumente/vertraege/{id}/permanent-delete – nicht mehr rückholbar.

9) Filtern & Suchen

In der Liste können Sie nach Status / Kanban-Spalte / Mieter / Vermieter / Zeitraum filtern. Die Filter werden in der URL als Query-Parameter mitgegeben, sodass Sie die Ansicht als Lesezeichen speichern können.


Optionen (/settings/admin/dokumente/vertrag/options)

Globale Einstellungen rund um den Vertrag, z.B.:

  • Standard-Steuersatz / Standardwerte
  • Sichtbare Felder im Formular
  • Defaults beim Anlegen aus einer Homepage-Anfrage

Uploads (/settings/admin/dokumente/vertrag/uploads)

Voreinstellungen für Dokument-Uploads (z.B. erlaubte Dateitypen, max. Größe). Die hochgeladenen Dateien landen physisch unter <tenant-root>/contract-uploads.


„PDF wird leer / sieht falsch aus“

  • Prüfen Sie das Vertrags-Template im TEMPLATING-Plugin (Standardvorlage gesetzt?).
  • Bilder/Logos: ist der Pfad korrekt im Template?

„Mieter kann den Signatur-Link nicht öffnen“

  • Token wirklich kopiert und unverändert geschickt?
  • Vertrag schon vollständig unterschrieben? Dann ist der Link „verbraucht“.
  • Eventuell wurde ein neuer Token generiert (alter Link wird ungültig).

„Inventar-Position fehlt im PDF“

  • Position wirklich gespeichert?
  • Im Template muss der Inventar-Block aktiv sein (TEMPLATING).

„Vertrag ist nicht im Kanban“

  • KANBAN aktiv? Kategorie zugeordnet? Vertrag nicht soft-gelöscht?

Nutzerbereich (/dokumente/vertraege):

  • GET /dokumente/vertraege – Liste
  • GET /dokumente/vertraege/new – Neuer Vertrag
  • POST /dokumente/vertraege – Anlegen
  • GET /dokumente/vertraege/{id} – Detail
  • POST /dokumente/vertraege/{id} – Speichern
  • GET /dokumente/vertraege/{id}/pdf – PDF anzeigen (optional: lang, type=VERTRAG|RECHNUNG, template={uuid})
  • GET /dokumente/vertraege/{id}/generate – Dokument-HTML generieren (optional: lang, type=VERTRAG|RECHNUNG, template={uuid})
  • POST /dokumente/vertraege/{id}/comments – Kommentar
  • POST /dokumente/vertraege/{id}/documents – Dokument hochladen
  • GET /dokumente/vertraege/{id}/documents/{docId} – Dokument abrufen
  • POST /dokumente/vertraege/{id}/documents/{docId}/delete – Dokument löschen
  • POST /dokumente/vertraege/{id}/inventar – Inventar zuweisen
  • POST /dokumente/vertraege/{id}/inventar/by-name – Schnellsuche-Inventar
  • POST /dokumente/vertraege/{id}/inventar/{itemId}/remove – Position entfernen
  • POST /dokumente/vertraege/{id}/techniker – Techniker setzen
  • POST /dokumente/vertraege/{id}/sign-vermieter – Vermieter-Unterschrift
  • POST /dokumente/vertraege/{id}/sign/generate-token – Mieter-Signatur-Link erzeugen
  • POST /dokumente/vertraege/kanban/move – Karte zwischen Spalten bewegen
  • POST /dokumente/vertraege/{id}/delete – Soft-Delete
  • POST /dokumente/vertraege/{id}/restore – Wiederherstellen
  • POST /dokumente/vertraege/{id}/permanent-delete – Endgültig löschen

Seit M27 (Issue #522) unterstützen GET .../pdf und GET .../generate die
optionalen Query-Parameter lang (Default de), type
(VERTRAG/RECHNUNG, bei Auslassung Default VERTRAG) und template
(UUID einer existierenden Vorlage):

  • Ohne type/template bleibt das Legacy-Verhalten: /pdf liefert das
    gespeicherte, geschützte Vertrags-PDF (bzw. regeneriert es, wenn der Vertrag
    nicht gesperrt ist), /generate rendert die Standard-VERTRAG-Vorlage.
  • Mit type oder template wird das Dokument on-the-fly gerendert und nicht
    als Vertrags-Dokument gespeichert (kein Änderungslog-Eintrag).
  • Unbekannter type, unbekannte template-UUID oder Typ-Fehlmatch zwischen
    type und template → HTTP 400 mit i18n-Fehlermeldung.

Öffentlich (nur mit Token):

  • GET /dokumente/vertraege/sign/{token} – Signatur-Seite
  • POST /dokumente/vertraege/sign/{token} – Signatur abschicken

Admin (/settings/admin/dokumente/vertrag):

  • GET /settings/admin/dokumente/vertrag/options
  • POST /settings/admin/dokumente/vertrag/options
  • GET /settings/admin/dokumente/vertrag/uploads
  • POST /settings/admin/dokumente/vertrag/uploads

  • VERTRAG ist Kern-Plugin: Es greift auf MIETER, VERMIETER, INVENTAR, TEMPLATING, KANBAN und MAIL zurück. Aktivieren Sie nur, was Sie wirklich brauchen.
  • Soft-deletete Verträge zählen weiter in der Statistik bis zum endgültigen Löschen.
  • Short-IDs: UUIDs werden in Listen und Detailansichten als Kurzform angezeigt (z. B. #123e4567). Die volle UUID sehen Sie im Tooltip (auf Mobilgeräten per Antippen) und können sie mit dem Copy-Button neben der Kurzform kopieren. Links und URLs nutzen weiterhin die volle UUID.

Die Vertrags-Funktionen gehoeren zum Plugin DOKUMENTE; Aktivierung und Gating bleiben bewusst am Plugin-Schluessel VERTRAG (kein Plugin-Rename). Die sieben Berechtigungs-Schluessel wurden von vertrag.* auf dokumente.* migriert (Data-Migration V69, einschl. aller Rollen-Zuordnungen) und erscheinen in der Sektion Dokumente der Berechtigungs-Matrix:

Alter Schluessel (Alias) Neuer Schluessel Wirkung
vertrag.vertrag.view dokumente.vertrag.view Vertragsliste und Vertragsdetails anzeigen
vertrag.vertrag.create dokumente.vertrag.create Neue Vertraege erstellen
vertrag.vertrag.edit dokumente.vertrag.edit Vertraege bearbeiten
vertrag.vertrag.delete dokumente.vertrag.delete Vertraege loeschen, wiederherstellen, endgueltig loeschen
vertrag.changelog.view dokumente.changelog.view Aenderungsprotokoll eines Vertrags anzeigen
vertrag.options.view dokumente.options.view Vertragsoptionen und Upload-Einstellungen anzeigen
vertrag.options.edit dokumente.options.edit Vertragsoptionen und Upload-Einstellungen aendern

Die alten Schluessel pruefen und schreiben unveraendert auf den neuen (kanonischen) Schluessel - PermissionService loest sie ueber PermissionAliases auf; ein Grant fuer dokumente.vertrag.view gilt also auch dem alten Key und umgekehrt. Die Aliasse sind eine Uebergangsphase und werden mit dem M37-Follow-up entfernt.

Dauerhafte URL-Weiterleitungen: Die alten Vertrags-URLs unter /vertrag/** (Uebersicht /vertrag/vertraege/**, Details, die oeffentliche Signatur-Seite /vertrag/sign/{token} inkl. ?lang=-Parameter sowie die Admin-Pfade /settings/admin/vertrag/**) leiten per HTTP 301 (GET) bzw. 307 (POST, mit Methode und Body) dauerhaft auf die neuen Pfade unter /dokumente/** um - inklusive Pfadsegmenten und Query-String. Diese Weiterleitung ist dauerhaft und nicht als temporater Ubergangsbestandteil geplant: Langfristig lebende Signatur-Links aus E-Mails und QR-Codes, Lesezeichen und Verlinkungen erreichen dauerhaft ihr Ziel und koennen nicht entfernt werden.