Repository navigation
Kfz Werkstatt Plugin
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.
-
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./AWoder 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).
-
workshop.jaraus dem Ordnerplugins/der OpenYaBS-Distribution (bzw.openyabs-plugins-<version>.zip) unter Einstellungen › Plugins › Plugin importieren einbinden. - 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.
Unter Einstellungen › Plugins › Kfz-Werkstatt (je Datenbank gespeichert):
-
Standard-Einheit:
kmodermi(wird pro Ablesung gespeichert). -
Arbeitswerte (AW) pro Stunde: z. B.
12(5 Min./AW) oder0für direkte Stundenabrechnung. - Stundensätze: Mechanik, Elektrik/Diagnose, Karosserie/Lack.
-
HU/AU-Erinnerung Vorlauf (Tage): Standard
30Tage. -
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?).
Im Menü Plugins stehen vier Aktionen bereit:
-
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. -
Werkstatt: Dokumentvorlagen (.fodt) speichern – exportiert alle 6
.fodt-Vorlagen (Rechnung, Auftrag, Einlagerungsschein in DE & EN) in einen gewählten Ordner. - Werkstatt: HU/AU-Termine & Reifeneinlagerung – öffnet den Übersichtstab mit fälligen Prüfungen und eingelagerten Radsätzen.
- 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.
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 |
![]()
Download installation packages here!
Deutsch
- Dokumentation (DE)
- Beschreibung
- Hinweise und Neuerungen
- Datenbank
- E-Rechnung
- Kleinunternehmer
- Datenschutz (DSGVO)
- Journal
- GoBD
- SEPA-Lastschrift
- Kontaktliste
- QR-Code
- Dateinamen
- Shopify
- Kasse und TSE
- Vorlagen
- Spaltendefinition
- Skripte
Plugins (DE)
- Plugins (Übersicht)
- DATEV-Export
- GoBD-Plugin
- Heilpraktiker-Plugin
- Kfz-Werkstatt-Plugin
- Vereinsverwaltung-Plugin
- ScriptOnSavePlugin
- Plugins schreiben
English
- Documentation (EN)
- Notes and changes
- Database
- Journal
- Small business VAT exemption
- Data protection (GDPR)
- SEPA direct debit
- Contact list
- QR code
- File name defaults
- Shopify
- Cash register and TSE
- Templates
- Scripts
Plugins (EN)