Schadensgebuhren
Das Schadensmanagement-System ermoglicht es Flottenbetreibern, Schaden an Fahrzeugen zu melden, zu verfolgen und zu verwalten. Wenn ein Schaden gemeldet wird, erstellt das System eine Aufgabe in der Flottenverwaltungs-Warteschlange zur Untersuchung und Losung. Diese Anleitung behandelt, wie Schadensberichte funktionieren und wie sie in das Abrechnungssystem integriert sind.
Funktionsweise der Schadensmeldung
Aktuelle Implementierung
Das Schadensystem arbeitet als aufgabenbasierter Workflow:
Schaden erkannt
Schaden wird von Kunden, Aussendienst-Technikern oder durch IoT-Sensoren identifiziert
Bericht eingereicht
Schadensbericht wird uber API oder Dashboard eingereicht
Fahrzeug aufgelost
System identifiziert das Fahrzeug anhand der bereitgestellten Kennung
Aufgabe erstellt
Eine Aufgabe mit kritischer Prioritat wird in der Flottenbetrieb-Warteschlange erstellt
Untersuchung
Aufgabe erscheint im Dashboard zur Untersuchung durch Techniker
Bewertung
Schaden wird bewertet und mit Fotos dokumentiert
Losung
Gebuhren werden dem Kunden berechnet, falls zutreffend, Reparaturen geplant
Integration mit Aufgaben
Schadensberichte werden in der tasks-Tabelle gespeichert mit:
- Prioritat:
critical- gewahrleistet sofortige Sichtbarkeit - Tag:
[damage]-Prafix im Titel fur einfaches Filtern - Status:
open- wartet auf Untersuchung - Fahrzeugverknupfung: Mit dem beschadigten Fahrzeug verknupft
Kritische Prioritat
Schadensberichte werden immer mit kritischer Prioritat erstellt, um sicherzustellen, dass sie sofortige Aufmerksamkeit von Ihrem Betriebsteam erhalten.
Schadenserkennungsquellen
Schaden kann durch mehrere Kanale erkannt werden:
| Quelle | Beschreibung | Beispiel |
|---|---|---|
| Kunden | Meldung von Problemen uber die mobile App | "Roller-Bremse funktioniert nicht" |
| Aussendienst-Techniker | Bei Routineinspektionen | Fahrzeugchecks vor der Fahrt |
| Fahrtendefotos | KI- oder manuelle Uberprofung von Fotos | Schaden nach Fahrt sichtbar |
| IoT-Sensoren | Ungewohnliches Fahrzeugverhalten oder Alarme | Aufprallserkennung, Sturzalarme |
Schaden uber API melden
Endpunkt
POST /api/damages
Zweck: Erstellt eine neue Schadensberichts-Aufgabe fur ein Fahrzeug
Anfrageformat
{
"vehicle_number": "VEH-123",
"note": "Linker Lenker verbogen, moglicherweise durch Kollision"
}
Parameter
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
vehicle_number | string | Ja | Fahrzeugkennung (Nummer, QR oder UUID) |
note | string | Ja | Beschreibung des Schadens (mind. 1 Zeichen) |
Erfolgsantwort (200)
{
"ok": true
}
Fehlerantworten
| Status | Fehler | Ursache |
|---|---|---|
| 400 | Validierungsfehler | Ungultige oder fehlende Felder |
| 404 | Fahrzeug nicht gefunden | Fahrzeugkennung existiert nicht |
| 400 | Schaden konnte nicht hinzugefugt werden | Datenbankfehler |
Fahrzeugauflosung
Die Schadens-API akzeptiert mehrere Fahrzeugkennungsformate:
| Eingabetyp | Beispiel | Auflosungsmethode |
|---|---|---|
| Fahrzeugnummer | VEH-123 | Stimmt mit vehicle_number-Feld uberein |
| QR-Code | QR-ABC123 | Stimmt mit qr_code-Feld uberein |
| UUID | 550e8400-... | Stimmt mit id-Feld uberein |
| IoT IMEI | 123456789012345 | Stimmt mit iot_imei-Feld uberein |
Diese Flexibilitat ermoglicht Schadensberichte von:
- Aussendienst-Technikern, die QR-Codes scannen
- Kundensupport mit Fahrzeugnummern
- IoT-Systemen mit IMEI-Kennungen
- Backend-Systemen mit UUIDs
Schadens-Workflow
Schritt 1: Erkennung
Identifizieren Sie Schaden durch eine der Erkennungsquellen. Dokumentieren Sie so viele Details wie moglich uber Schadensort und -schwere.
Schritt 2: Berichterstellung
Reichen Sie den Schadensbericht ein uber:
- Den
/api/damages-Endpunkt - Direktes Erstellen einer Aufgabe im Dashboard mit
[damage]-Prafix
Schritt 3: Untersuchung
- Aufgabe erscheint im Dashboard unter Aufgaben oder Flottenbetrieb
- Kritische Prioritat gewahrleistet sofortige Sichtbarkeit
- Nach
[damage]-Tag filtern, um alle Schadensberichte zu sehen - Einem Techniker zur Untersuchung zuweisen
Schritt 4: Bewertung
Der Techniker sollte:
- Das Fahrzeug lokalisieren und inspizieren
- Den Schaden mit Fotos dokumentieren
- Reparaturkosten schatzen
- Feststellen, ob der Kunde haftbar ist
Schritt 5: Losung
Basierend auf der Bewertung:
- Geringer Schaden: In Aufgabe vermerken, als gelost schliessen
- Reparatur erforderlich: Wartung planen, Fahrzeugstatus aktualisieren
- Kunde haftbar: Abrechnungsprozess einleiten
Kunden fur Schaden belasten
Manueller Abrechnungsprozess
Derzeit werden Schadensgebuhren manuell uber das Dashboard abgerechnet:
Haftbaren Kunden identifizieren
Fahrthistorie des Fahrzeugs um den Schadenszeitpunkt prufen. Fahrtendefotos uberprufen, falls verfugbar.
Gebuhrenbetrag berechnen
Basierend auf Reparatur-/Ersatzkosten, Servicevereinbarungsbedingungen und Schadensschwere
Gebuhr anwenden
Zum Kundenprofil navigieren und Wallet-Abbuchung oder Stripe-Abbuchung erstellen
Aufgabe aktualisieren
Schadensaufgabe als abgeschlossen markieren mit Losungsnotizen
Wallet-Abbuchung
Fur Kunden mit Wallet-Guthaben konnen Sie ihr Wallet direkt belasten:
- Navigieren Sie zu Kunden und finden Sie den Kunden
- Zeigen Sie sein Profil an
- Erstellen Sie eine Wallet-Transaktion fur den Schadensbetrag
- Dokumentieren Sie den Geburungsgrund
Stripe-Abbuchung
Fur direkte Kartenabbuchungen, wenn das Wallet nicht ausreicht:
- Navigieren Sie zum Kundenprofil
- Verwenden Sie die Abbuchungsfunktion mit der gespeicherten Zahlungsmethode
- Fugen Sie eine Beschreibung hinzu: "Schadensgebuhr: [Beschreibung des Schadens]"
- Dokumentieren Sie die Aufgaben-ID und Fahrzeug-UUID als Referenz
Kundenkommunikation
Kommunizieren Sie immer mit dem Kunden, bevor Sie Schadensgebuhren anwenden. Erklaren Sie den Schaden, zeigen Sie Beweise und geben Sie ihm die Moglichkeit zu reagieren. Dies reduziert Streitigkeiten und erhalt Kundenbeziehungen.
Servicevereinbarungsbedingungen
Die Levy-Servicevereinbarung enthalt Bestimmungen zur Schadenshaftung:
Kundenverantwortlichkeiten
Gemas der Standard-Servicevereinbarung:
- Kunden sind fur Schaden wahrend ihrer Mietzeit verantwortlich
- Schadensgebuhren konnen fur nachlassige Nutzung berechnet werden
- Maximale Haftungsgrenzen konnen je nach Vereinbarungsbedingungen gelten
Schadensbewertungskategorien
| Kategorie | Beispiele | Typische Gebuhr |
|---|---|---|
| Geringfugig kosmetisch | Kratzer, Schrammen | 0-25 $ |
| Moderat | Dellen, zerbrochene Spiegel | 25-100 $ |
| Erheblich | Verbogene Rahmen, kaputte Displays | 100-500 $ |
| Schwerwiegend | Totalschaden, Diebstahl | Bis zu Ersatzkosten |
Beweisanforderungen
Fur erfolgreiche Schadensberechnung:
- Zeitstempelnachweis - Wann der Schaden aufgetreten ist
- Fahrtzuordnung - Welcher Kunde das Fahrzeug hatte
- Fotodokumentation - Vorher/Nachher-Bilder
- Schadensbewertung - Professionelle Bewertung
Dashboard-Integration
Schadensberichte anzeigen
- Navigieren Sie zu Dashboard > Aufgaben
- Nach Prioritat filtern:
Kritisch - Nach
[damage]im Titel suchen - Oder Tag-Filter verwenden, falls verfugbar
Aufgabenaktionen
| Aktion | Beschreibung |
|---|---|
| Zuweisen | Techniker zur Untersuchung zuweisen |
| Status aktualisieren | Durch Workflow-Stufen bewegen |
| Notizen hinzufugen | Erkenntnisse und Losung dokumentieren |
| Abschliessen | Aufgabe bei Losung schliessen |
| Mit Fahrt verknupfen | Mit spezifischer Fahrt verknupfen, falls identifiziert |
Flottenkarten-Ansicht
Beschadigte Fahrzeuge konnen:
- Mit speziellem Statusindikator markiert sein
- Aus der verfugbaren Flotte entfernt werden
- Zur Abholung markiert werden
Berichte und Analysen
Schadenstrends finden
Uberwachen Sie Schadensmuster, um zu identifizieren:
- Problematische Fahrzeuge mit wiederholten Schaden
- Hochschadens-Standorte oder -zonen
- Zeitmuster (Wochenende vs. Wochentag)
- Kundenmuster
Nutzliche Abfragen
Schadensaufgaben der letzten 30 Tage
SELECT
DATE(created_at) as date,
COUNT(*) as damage_count
FROM tasks
WHERE title LIKE '[damage]%'
AND created_at > NOW() - INTERVAL '30 days'
GROUP BY DATE(created_at)
ORDER BY date;
Fahrzeuge mit den meisten Schadensberichten
SELECT
v.vehicle_number,
v.model,
COUNT(t.id) as damage_count
FROM vehicles v
JOIN tasks t ON t.vehicle_uuid = v.id
WHERE t.title LIKE '[damage]%'
GROUP BY v.id, v.vehicle_number, v.model
ORDER BY damage_count DESC
LIMIT 20;
Ungeloste Schadensberichte
SELECT
t.id,
t.title,
t.created_at,
v.vehicle_number,
t.assigned_to
FROM tasks t
JOIN vehicles v ON v.id = t.vehicle_uuid
WHERE t.title LIKE '[damage]%'
AND t.status IN ('open', 'in_progress')
ORDER BY t.created_at ASC;
Bewahrte Praktiken
Fur Aussendienst-Techniker
- Beschreibend sein - Spezifischen Schadensort und -typ angeben
- Schatzungen einbeziehen - Reparaturschwierigkeit vermerken, falls bekannt
- Fotos machen - Schaden vor der Reparatur visuell dokumentieren
- Schnell handeln - Kritische Prioritat bedeutet sofortige Aufmerksamkeit
Fur Flottenmanager
- Taglich uberprufen - Schadensberichte jeden Morgen prufen
- Muster verfolgen - Problematische Fahrzeuge oder Standorte identifizieren
- Grundlich dokumentieren - Aufzeichnungen fur Haftungszwecke fuhren
- Nachverfolgen - Sicherstellen, dass alle Schadensberichte zur Losung gelangen
Fur Kundensupport
- Vor Berechnung verifizieren - Schadenzuordnung bestatigen
- Klar kommunizieren - Gebuhren dem Kunden erklaren
- Streitigkeiten dokumentieren - Kundenantworten aufzeichnen
- Bei Bedarf eskalieren - Komplexe Falle an das Management weiterleiten
Zukunftige Erweiterungen
Das Schadensystem ist fur Erweiterungen geplant:
Geplante Funktionen
-
Dedizierte Schadenstabelle
- Getrennt von Aufgaben fur bessere Verfolgung
- Einschliesslich Kostenschatzungen, Fotos, Haftungsstatus
- Verknupfung mit spezifischen Fahrten
-
Automatische Abrechnung
- Automatische Gebuhren basierend auf Schadensbewertung
- Integration mit Zahlungswiederholungs-System
- Kundenbenachrichtigungs-Workflow
-
Foto-KI-Analyse
- Automatische Schadenserkennung aus Fahrtendefotos
- Schweregrad-Klassifizierung
- Vorher/Nachher-Vergleich
-
Versicherungsintegration
- Schadensanmeldungs-Workflow
- Versicherungs-API-Integration
- Deckungsverfolgung
-
Schadensbewertung
- Fahrzeugschadens-Historie-Score
- Vorausschauende Wartungsausloser
- Flottengesundheits-Metriken
Fehlerbehebung
Haufige Probleme
"Fahrzeug nicht gefunden"-Fehler
Ursache: Fahrzeugkennung stimmt mit keinem Datensatz uberein
Losungen:
- Fahrzeugnummernformat uberprufen
- Prufen, ob Fahrzeug in der Datenbank existiert
- Alternative Kennungen versuchen (QR, IMEI, UUID)
Aufgabe erscheint nicht im Dashboard
Ursache: Filter- oder Berechtigungsproblem
Losungen:
- Aufgabenfilter loschen
- Unterkonto-Zugang des Benutzers prufen
- Uberprufen, ob Aufgabe erstellt wurde (Datenbank prufen)
Kunde kann nicht belastet werden
Ursache: Kunde hat keine Zahlungsmethode oder unzureichendes Guthaben
Losungen:
- Prufen, ob Kunde Zahlungsmethoden hinterlegt hat
- Uberprufen, ob Stripe-Kunden-ID existiert
- Wallet-Abbuchung erwagen, wenn Guthaben vorhanden
- Kunden kontaktieren, um Zahlungsmethode hinzuzufugen
Diagnoseabfragen
Prufen, ob Fahrzeug existiert
SELECT id, vehicle_number, qr_code, status
FROM vehicles
WHERE vehicle_number = 'VEH-123'
OR qr_code = 'VEH-123';
Schadensaufgaben fur ein Fahrzeug finden
SELECT t.*, v.vehicle_number
FROM tasks t
JOIN vehicles v ON v.id = t.vehicle_uuid
WHERE v.vehicle_number = 'VEH-123'
AND t.title LIKE '[damage]%'
ORDER BY t.created_at DESC;
Aktuelle Schadensberichte
SELECT
t.id,
t.title,
t.status,
t.created_at,
v.vehicle_number
FROM tasks t
JOIN vehicles v ON v.id = t.vehicle_uuid
WHERE t.title LIKE '[damage]%'
ORDER BY t.created_at DESC
LIMIT 20;
Nachste Schritte
- Stripe-Einrichtung - Stripe-Integration konfigurieren
- Zahlungsmethoden - Kundenkarten verwalten
- Automatische Ruckerstattungen - Wie automatische Ruckerstattungen funktionieren
Schadensmanagement bereit
Mit einem klaren Workflow fur Schadensmeldung und -losung konnen Sie Ihre Flotteninvestition schutzen und gleichzeitig faire Kundenbeziehungen pflegen. Regelmasige Uberwachung von Schadenstrends hilft, Probleme zu identifizieren, bevor sie kostspielig werden.