Skip to content

Kfz Werkstatt Plugin

anti43 edited this page Nov 19, 2026 · 1 revision

Kfz-Werkstatt-Plugin (workshop.jar)

English: Car repair shop plugin (EN) · Übersicht: Plugins

Das Kfz-Werkstatt-Plugin (workshop.jar) erweitert OpenYaBS um Fahrzeugverwaltung, Werkstattaufträge, Arbeitswerte (AW), Reifeneinlagerung, HU/AU-Erinnerungen und passende Dokumentvorlagen – vollständig in Deutsch und Englisch über die neue Plugin-Übersetzungs-API (ExtensionContext.tr), ohne den OpenYaBS-Kern mit branchenspezifischer Logik zu belasten.

Funktionen im Überblick

  • Fahrzeugverwaltung (1:n pro Kunde): Mehrere Fahrzeuge je Kontakt mit Kennzeichen, FIN/VIN (17-stellig nach ISO 3779), Hersteller/Modell/Typ, optionaler HSN/TSN, Erstzulassung, aktuellem Kilometerstand inkl. Einheit (km/mi), nächstem HU/AU- bzw. MOT-Termin (Monat/Jahr oder taggenau), Reifengröße, Aktiv-/Archiv-Status (verkauft/abgemeldet) und Notizen.
  • Reifeneinlagerung (§ 688 BGB): Saison (Sommer / Winter / Ganzjahr), Lagerort, radbezogene Profiltiefe in mm (VL/VR/HL/HR), DOT-Nummern, Felgentyp (Alu/Stahl) inkl. Radschrauben/-muttern, Einlagerungsdatum sowie Zustand/Vorschäden.
  • Belegverknüpfung (Angebot / Auftrag / Rechnung): Speichert einen Zeitpunkt-Snapshot von Kennzeichen und Kilometerstand direkt am Beleg, sodass historische Rechnungen auch nach Ummeldung oder Fahrzeugverkauf unverändert bleiben. Erfasst Annahme-/Abholdatum, Kundenbeanstandung, kundenbezogene Leistungsbeschreibung (getrennt von internen Werkstattnotizen), Altteile-Regelung sowie Kostenvoranschlag-Referenz und Nachtragsfreigabe (§ 649 Abs. 2 BGB).
  • Arbeitswerte (AW) & Standard-Leistungskatalog: Konfigurierbare AW pro Stunde (z. B. 12 AW/h = 5 Min./AW oder direkte Stundenabrechnung), Stundensätze (Mechanik, Elektrik/Diagnose, Karosserie/Lack) sowie Ein-Klick-Import gängiger Kfz-Leistungen in der aktiven Sprache.
  • Werkstatt-Übersicht & Plausibilitätsprüfung: Übersichtstab für anstehende/überfällige HU/AU-Termine und eingelagerte Radsätze sowie optionale Vorabprüfung beim Speichern (fehlendes Fahrzeug/km-Stand, unplausibler km-Rückgang inkl. km/mi-Umrechnung, ungültige FIN, Kostenvoranschlag-Überschreitung ohne Nachtragsfreigabe).
  • Vorlagen-Platzhalter & LibreOffice-Vorlagen: Stellt [ws.*]-Platzhalter bereit und liefert 6 vorgefertigte .fodt-Vorlagen (Werkstattrechnung, Werkstattauftrag, Reifen-Einlagerungsschein – jeweils DE & EN).

Installation

  1. workshop.jar aus dem Ordner plugins/ der OpenYaBS-Distribution (bzw. openyabs-plugins-<version>.zip) unter Einstellungen › Plugins › Plugin importieren einbinden.
  2. Beim Start legt das Plugin automatisch die plugin-eigenen Tabellen (workshop_schema_version, ws_vehicles, ws_tire_storage, ws_job_data) datenbankübergreifend (H2, Derby, MySQL/MariaDB, PostgreSQL) an.

Einstellungen

Unter Einstellungen › Plugins › Kfz-Werkstatt (je Datenbank gespeichert):

  • Standard-Einheit: km oder mi (wird pro Ablesung gespeichert).
  • Arbeitswerte (AW) pro Stunde: z. B. 12 (5 Min./AW) oder 0 für direkte Stundenabrechnung.
  • Stundensätze: Mechanik, Elektrik/Diagnose, Karosserie/Lack.
  • HU/AU-Erinnerung Vorlauf (Tage): Standard 30 Tage.
  • Kostenvoranschlag-Warnschwelle (%): Standard 15 % (zur rechtzeitigen Anzeige nach § 649 Abs. 2 BGB).
  • Werkstattaufträge und -rechnungen beim Speichern prüfen: nicht-blockierender Hinweisdialog (Trotzdem speichern?).

Befehle & Arbeitsablauf

Im Menü Plugins stehen vier Aktionen bereit:

  1. Werkstatt: Standard-Leistungskatalog importieren – legt gängige Leistungen (WS-INSP, WS-OIL, WS-BRAKE, WS-TIRE-SWAP, WS-TIRE-STORE, WS-DIAG, WS-MOT-PREP) in der aktiven Sprache an; bereits vorhandene Artikelnummern werden übersprungen.
  2. Werkstatt: Dokumentvorlagen (.fodt) speichern – exportiert alle 6 .fodt-Vorlagen (Rechnung, Auftrag, Einlagerungsschein in DE & EN) in einen gewählten Ordner.
  3. Werkstatt: HU/AU-Termine & Reifeneinlagerung – öffnet den Übersichtstab mit fälligen Prüfungen und eingelagerten Radsätzen.
  4. Werkstatt: Aktuellen Auftrag / Rechnung prüfen – führt die Plausibilitätsprüfung für den geöffneten Beleg aus.

In der Kontaktansicht erscheint oben ein grünes Banner mit Fahrzeuge & Reifen (inkl. Reifeneinlagerung und Werkstatthistorie), in der Belegansicht ein Banner mit Fahrzeug & Auftrag und Prüfen.

Vorlagen-Platzhalter ([ws.*])

Interne Werkstattnotizen werden bewusst nicht als Vorlagen-Platzhalter ausgegeben.

Platzhalter Inhalt
[ws.plate] Kennzeichen (Beleg-Snapshot hat Vorrang)
[ws.vin] FIN / VIN (ISO 3779)
[ws.makeModel] Hersteller / Modell / Typ
[ws.hsnTsn] HSN / TSN
[ws.firstRegistration] Erstzulassung
[ws.mileage] / [ws.mileageUnit] Kilometerstand (Snapshot) & Einheit (km/mi)
[ws.inspectionDue] Nächste HU/AU bzw. MOT
[ws.dropoffDate] / [ws.pickupDate] Annahme- / Abholdatum
[ws.complaint] Kundenbeanstandung
[ws.workSummary] Ausgeführte Arbeiten (kundenbezogen)
[ws.oldParts] Altteile-Regelung
[ws.awDefinition] AW-Definition (z. B. 12 AW/h (5 Min./AW))
[ws.quoteNumber] / [ws.quoteTotal] Zugehöriger Kostenvoranschlag
[ws.tireInfo] Eingelagerter Radsatz (Saison, Größe, Felgen, DOT)
[ws.tireStorageLocation] Lagerort
[ws.tireTreadDepth] Profiltiefe (VL / VR / HL / HR mm)
[ws.tireCondition] Zustand / Vorschäden

Siehe auch

Clone this wiki locally