VERTRAG
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
- Öffnen Sie Vertrag → Verträge (
/dokumente/vertraege). - „Neu“ klicken (
/dokumente/vertraege/new). - Pflichtfelder ausfüllen:
- Mieter (Auswahl oder neu anlegen)
- Vermieter
- Zeitraum
- Speichern.
2) Vertrag bearbeiten
- Vertrag in der Liste anklicken (
/dokumente/vertraege/{id}). - Felder ändern und speichern.
- 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
- Auf der Detailseite den Bereich Inventar öffnen.
- Item auswählen (oder per Name suchen, „Quick add“).
- Menge setzen.
- 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/moveaufgerufen. - Siehe Plugin KANBAN für die Spalten-Konfiguration.
5) Vertrags-PDF erzeugen
- Auf der Detailseite (sofern TEMPLATING aktiv ist) im Template-Auswahlmenü eine VERTRAG-Vorlage wählen. „Standard“ nutzt die Standardvorlage für
VERTRAG. - 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). Mittemplate={uuid}wird die gewählte Vorlage on-the-fly gerendert. - Optional kann über
typeein 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
- Auf der Detailseite die Buttons „Als Rechnung generieren“ und „Rechnung als PDF“ nutzen (nur sichtbar, wenn TEMPLATING aktiv ist).
- „Als Rechnung generieren“ öffnet die HTML-Ansicht:
GET /dokumente/vertraege/{id}/generate?type=RECHNUNG. - „Rechnung als PDF“ erzeugt das PDF:
GET /dokumente/vertraege/{id}/pdf?type=RECHNUNG. - Ohne
template-Parameter wird die Standard-RECHNUNG-Vorlage verwendet. Mittemplate={uuid}wird eine explizit gewählteRECHNUNG-Vorlage gerendert; der Typ muss zur Vorlage passen, sonst erhält man einen Fehler (HTTP 400). - On-the-fly generierte Rechnungen werden nicht als Vertrags-Dokument gespeichert und nicht im Änderungslog protokolliert.
7) Vertrag unterschreiben lassen
a) Vermieter-Unterschrift (intern)
- Auf der Detailseite „Vermieter unterschreiben“ klicken (
POST /dokumente/vertraege/{id}/sign-vermieter). - Mit Maus / Touchpad / Stift unterschreiben → speichern.
b) Mieter-Unterschrift (per Link extern)
- Auf der Detailseite „Signatur-Link erzeugen“ klicken (
POST /dokumente/vertraege/{id}/sign/generate-token). - Es wird ein Token-Link erzeugt:
/dokumente/vertraege/sign/{token}. - Diesen Link an den Mieter senden (z.B. per Mail).
- Der Mieter öffnet den Link, sieht die Vertragsübersicht und unterschreibt direkt im Browser. Es ist kein Login nötig.
- 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– ListeGET /dokumente/vertraege/new– Neuer VertragPOST /dokumente/vertraege– AnlegenGET /dokumente/vertraege/{id}– DetailPOST /dokumente/vertraege/{id}– SpeichernGET /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– KommentarPOST /dokumente/vertraege/{id}/documents– Dokument hochladenGET /dokumente/vertraege/{id}/documents/{docId}– Dokument abrufenPOST /dokumente/vertraege/{id}/documents/{docId}/delete– Dokument löschenPOST /dokumente/vertraege/{id}/inventar– Inventar zuweisenPOST /dokumente/vertraege/{id}/inventar/by-name– Schnellsuche-InventarPOST /dokumente/vertraege/{id}/inventar/{itemId}/remove– Position entfernenPOST /dokumente/vertraege/{id}/techniker– Techniker setzenPOST /dokumente/vertraege/{id}/sign-vermieter– Vermieter-UnterschriftPOST /dokumente/vertraege/{id}/sign/generate-token– Mieter-Signatur-Link erzeugenPOST /dokumente/vertraege/kanban/move– Karte zwischen Spalten bewegenPOST /dokumente/vertraege/{id}/delete– Soft-DeletePOST /dokumente/vertraege/{id}/restore– WiederherstellenPOST /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/templatebleibt das Legacy-Verhalten:/pdfliefert das
gespeicherte, geschützte Vertrags-PDF (bzw. regeneriert es, wenn der Vertrag
nicht gesperrt ist),/generaterendert die Standard-VERTRAG-Vorlage. - Mit
typeodertemplatewird das Dokument on-the-fly gerendert und nicht
als Vertrags-Dokument gespeichert (kein Änderungslog-Eintrag). - Unbekannter
type, unbekanntetemplate-UUID oder Typ-Fehlmatch zwischentypeundtemplate→ HTTP 400 mit i18n-Fehlermeldung.
Öffentlich (nur mit Token):
GET /dokumente/vertraege/sign/{token}– Signatur-SeitePOST /dokumente/vertraege/sign/{token}– Signatur abschicken
Admin (/settings/admin/dokumente/vertrag):
GET /settings/admin/dokumente/vertrag/optionsPOST /settings/admin/dokumente/vertrag/optionsGET /settings/admin/dokumente/vertrag/uploadsPOST /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.