Docs
Docs
Allesda
DE | EN
Plugins
Allesda
DE | EN
Plugins

VERTRAG

Dokumentation
Zurück

VERTRAG

Wofür ist das?

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

Typische Aufgaben (Alltag)

  • Vertrag anlegen und Daten pflegen
  • Inventar zuweisen
  • PDF generieren
  • 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

Schritt-für-Schritt

1) Vertrag anlegen

1. Öffnen Sie Vertrag → Verträge (/vertrag/vertraege).
2. „Neu“ klicken (/vertrag/vertraege/new).
3. Pflichtfelder ausfüllen:

  • Mieter (Auswahl oder neu anlegen)
  • Vermieter
  • Zeitraum

4. Speichern.

2) Vertrag bearbeiten

1. Vertrag in der Liste anklicken (/vertrag/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 /vertrag/vertraege/kanban/move aufgerufen.
  • Siehe Plugin KANBAN für die Spalten-Konfiguration.

5) Vertrags-PDF erzeugen

1. Auf der Detailseite „PDF generieren“ wählen (/vertrag/vertraege/{id}/generate).
2. Die fertige PDF kann direkt geöffnet (/vertrag/vertraege/{id}/pdf) oder heruntergeladen werden.

> Layout / Inhalt der PDF wird über das TEMPLATING-Plugin gesteuert. Dort legen Sie Vertragsvorlagen an und wählen die Standardvorlage.

6) Vertrag unterschreiben lassen

#### a) Vermieter-Unterschrift (intern)
1. Auf der Detailseite „Vermieter unterschreiben“ klicken (POST /vertrag/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 /vertrag/vertraege/{id}/sign/generate-token).
2. Es wird ein Token-Link erzeugt: /vertrag/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.

7) Vertrag löschen / wiederherstellen

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

8) 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.

Admin-Einstellungen

Optionen (/settings/admin/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/vertrag/uploads)

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

Häufige Fragen / Probleme

„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?

Technische URLs (Kurzreferenz)

Nutzerbereich (/vertrag/vertraege):

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

Öffentlich (nur mit Token):

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

Admin (/settings/admin/vertrag):

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

Hinweise

  • 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.