Repository navigation
Heilpraktiker plugin (EN)
anti43 edited this page Nov 19, 2026
·
1 revision
Deutsch: Heilpraktiker-Plugin (DE)
The Heilpraktiker plugin (heilpraktiker.jar) adds support for German non-medical practitioners (Heilpraktiker) while keeping all country-specific and medical billing rules strictly outside OpenYaBS core.
-
Official GebüH 85/2002 catalog: All 144 official fee-schedule entries across 27 groups (codes
1–39.13; unassigned codes12.3,12.6,39.3are omitted) with official min/max fees and a one-click 0 % VAT service importer. -
Patient metadata & SOAP notes on contacts: Date of birth, insurance type (
Selbstzahler,PKV,Beihilfe,PKV + Beihilfe,Zusatzversicherung), written fee agreement flag (Honorarvereinbarung, § 630a BGB), and treatment documentation / SOAP notes (§ 630f BGB). - Medical invoice metadata: ICD-10-GM code(s), plain-text diagnosis, treatment date(s) / period, and a toggle between VAT-exempt medical treatment (§ 4 Nr. 14 lit. a UStG) and taxable prevention/wellness services.
-
GebüH & PKV/Beihilfe validation: Runs automatically before saving (optional) or on demand – checks required fields, VAT plausibility, GebüH upper fee bounds vs. written fee agreement, analog billing (
A <code>), and GebüH combination/exclusion rules. -
Template placeholders & bundled template: Contributes
[hp.*]placeholders to OpenYaBS Templates and includes a ready-to-use LibreOffice Flat ODT (.fodt) invoice template.
- Import
heilpraktiker.jarfrom theplugins/folder of the OpenYaBS distribution (oropenyabs-plugins-<version>.zip) via Settings › Plugins › Import plugin. - On startup, the plugin automatically creates its own tables (
hp_patient_dataandhp_invoice_data) in the active database.
Configured per database under Settings › Plugins › Heilpraktiker & GebüH:
-
Practitioner title (
[hp.practitionerTitle]), e.g.Heilpraktiker. -
License / public health authority (
[hp.licenseAuthority], § 1 HeilprG). -
VAT exemption notice (
[hp.ustgNotice], output only when an invoice is marked as medical treatment). - Default fee on GebüH import: Max fee, Midpoint (min/max), or Min fee.
- Validate invoices on save: Displays a confirmation dialog if warnings are found, without blocking intentional overrides.
Three commands are registered in the plugin menu:
-
Heilpraktiker: GebüH-Katalog (144 Ziffern) importieren – creates all 144 GebüH services (
GEBUEH-1…GEBUEH-39.13) with0 %VAT; existing SKUs are skipped. -
Heilpraktiker: Rechnungsvorlage (.fodt) speichern – exports the bundled
heilpraktiker_rechnung.fodttemplate so you can register it under Settings › Templates. - Heilpraktiker: Aktuelle Rechnung prüfen – runs the validation check on the currently open invoice.
Contact views display a banner with Patientendaten / SOAP, and invoice views display a banner with Diagnose & Behandlung and Prüfen.
| Placeholder | Value |
|---|---|
[hp.patientDob] |
Patient date of birth |
[hp.insuranceType] |
Insurance type (e.g. PKV, Beihilfe, Selbstzahler) |
[hp.honorarvereinbarung] |
Written fee agreement on file (ja / nein) |
[hp.icd10] |
Invoice ICD-10-GM code(s) |
[hp.diagnosis] |
Plain-text diagnosis |
[hp.treatmentDates] |
Treatment date(s) / period |
[hp.ustgNotice] |
VAT exemption notice (empty for non-medical/wellness invoices) |
[hp.practitionerTitle] |
Practitioner title from settings |
[hp.licenseAuthority] |
License / authority info from settings |
-
GebüH 85/2002: Comprises 144 official codes (
1–39.13). Civil-servant aid (Beihilfe) reimbursement limits may be lower than GebüH maximum fees. - Retention periods: Patient records must be kept for 10 years (§ 630f Abs. 3 BGB); accounting/invoice records are subject to an 8-year retention period as of 2025-01-01 (§ 14b UStG / § 147 AO, BEG IV).
- This plugin assists with formal checks and does not constitute legal or tax advice.
![]()
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)