Kundenportal
Zweck {#zweck}
Das Kundenportal ist der Self-Service-Bereich für deine Kunden: Auftragsstatus einsehen, Dokumente und Geräte-Handbücher laden und Angebote online annehmen — inkl. Unterschrift und AGB.
Öffentliche URL (Mandanten-Host): /customer-portal
Modul: Nur aktiv, wenn das Plattform-Modul Kundenportal (customer_portal) freigeschaltet ist. Ohne Modul antwortet die Route mit 404.
Was Kunden sehen {#was-kunden-sehen}
| Bereich | Inhalt |
|---|---|
| Login | VA-Nummer (Auftragsreferenz) + Kundennummer |
| Auftragsliste | Alle Aufträge dieses Kunden |
| Auftragsdetail | Status-Zeitleiste, Zeitplan, Leistungsübersicht, Kontakt |
| Dokumente | Angebot, Auftragsbestätigung, Lieferschein, Proforma, Rechnung |
| Handbücher | PDFs der gebuchten Artikel (siehe geräte-handbücher) |
Stornierungen sind nicht über das Portal möglich — nur per E-Mail oder Telefon (Hinweis steht im Portal).
Das Portal erscheint immer im hellen Erscheinungsbild (unabhängig vom Dark Mode der Mitarbeiter-App).
Login für Kunden {#login-für-kunden}
-
Kunde öffnet
/customer-portal(oder den Link aus dem Angebots-PDF). -
Felder: VA-Nummer (Auftragsreferenz, z. B.
JB-…) und Kundennummer (public_codedes Kunden). - Weiter — bei Erfolg landet er auf der Auftragsliste bzw. dem Auftrag.
Direktlink aus dem Angebot: /customer-portal/o/:token — füllt die VA-Nummer vor.
Nach 5 Fehlversuchen von derselben IP zur selben Referenz gilt eine Sperre von 15 Minuten.
Es gibt kein Passwort für Kunden — Authentifizierung läuft über Referenz + Kundennummer.
Angebot online annehmen {#angebot-online-annehmen}
Nur sichtbar, wenn der Auftrag im Status Angebot ist und noch keine aktive Annahme vorliegt:
- Checkbox Ich nehme dieses Angebot an.
- Checkbox Ich akzeptiere die AGB und Widerrufsbelehrung. (Texte aus den Organisations-PDF-Einstellungen, falls hinterlegt)
- Unterschrift zeichnen (Pad) oder PNG hochladen (max. 1 MB)
- Bestätigen
Danach:
- Auftragsstatus wechselt auf Bestätigt
-
Signiertes Angebot und Auftragsbestätigung werden erzeugt (Angebot mit Suffix
_unterz) - Annahme wird mit IP, Browser und Hash der AGB-Texte protokolliert
Flash für den Kunden: Bestätigung der Zusammenarbeit.
Dokumente im Portal {#dokumente-im-portal}
Sichtbar sind nur diese Dokumentarten: Angebot, Auftragsbestätigung, Lieferschein, Proforma-Rechnung, Rechnung. Ein signiertes Angebot wird als solches gekennzeichnet.
Geräte-Handbücher {#geräte-handbücher}
Handbücher, die am Artikel hochgeladen wurden, erscheinen automatisch für Aufträge, die diesen Artikel enthalten — ohne extra Freigabe-Schalter. Siehe geräte-handbücher.
Preise im Portal steuern {#preise-im-portal-steuern}
Pro Kunde (nicht pro Ort) unter Kunden bearbeiten → Bereich Notizen / Kundenportal-Preise:
| Option | Wirkung |
|---|---|
| Ausgeblendet | Keine Beträge |
| Nur netto | Nettobeträge |
| Nur brutto | Bruttobeträge (Standard) |
| Netto und brutto | Beide |
Portal-Link an Kunden {#portal-link-an-kunden}
Es gibt keinen separaten Button „Portal-Link senden“. Der Link wird automatisch in Angebots-PDFs (Mietauftrag und Verkauf) eingebettet, sobald das Modul aktiv ist:
Kundenportal: Angebot annehmen & Dokumente öffnen
Bereits angenommene / signierte Angebots-Kopien zeigen den CTA nicht mehr.
Freischaltung (Plattform) {#freischaltung-plattform}
Nur Plattform-Inhaber: /platform/organizations/:id → Bereich Module → Checkbox Kundenportal.
Deaktivierte Module sind in der App ausgeblendet und in der Device-API gesperrt.
Typische Fehler {#typische-fehler}
| Problem | Lösung |
|---|---|
| Portal-Seite 404 |
Modul customer_portal freischalten |
| Login schlägt fehl | VA-Nummer und Kundennummer prüfen; Sperre abwarten |
| Kein Annahme-Button | Auftrag muss Status Angebot haben |
| Keine Preise sichtbar | Kundenportal-Preise am Kunden prüfen |
| Handbücher fehlen | PDF am Artikel hochladen; Artikel muss auf dem Auftrag liegen |
Stand: November 2026