Skip to content

Heilpraktiker plugin (EN)

anti43 edited this page Nov 19, 2026 · 1 revision

Heilpraktiker Plugin (German GebüH 85/2002, ICD-10, § 4 Nr. 14 UStG)

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.

Overview

  • Official GebüH 85/2002 catalog: All 144 official fee-schedule entries across 27 groups (codes 1–39.13; unassigned codes 12.3, 12.6, 39.3 are 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.

Installation

  1. Import heilpraktiker.jar from the plugins/ folder of the OpenYaBS distribution (or openyabs-plugins-<version>.zip) via Settings › Plugins › Import plugin.
  2. On startup, the plugin automatically creates its own tables (hp_patient_data and hp_invoice_data) in the active database.

Settings

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.

Commands & Workflow

Three commands are registered in the plugin menu:

  1. Heilpraktiker: GebüH-Katalog (144 Ziffern) importieren – creates all 144 GebüH services (GEBUEH-1 … GEBUEH-39.13) with 0 % VAT; existing SKUs are skipped.
  2. Heilpraktiker: Rechnungsvorlage (.fodt) speichern – exports the bundled heilpraktiker_rechnung.fodt template so you can register it under Settings › Templates.
  3. 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.

Template Placeholders ([hp.*])

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

Legal Notes (as of 2026)

  • 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.

See also

Clone this wiki locally