Doku erstellt

2026-02-03 14:48:53 +01:00 · 2026-02-03 14:48:53 +01:00 · 562c69ef46
commit 562c69ef46
parent 0b545ea47e
2 changed files with 148 additions and 69 deletions
--- a/ChangeLog.md
+++ b/ChangeLog.md
@ -1,5 +1,56 @@
-# CHANGELOG MODULE STEUER FOR [DOLIBARR ERP CRM](https://www.dolibarr.org)
+# Changelog - EÜR Deutschland Modul

-## 1.0
+## Version 1.0.0 (2026-02)

-Initial version
+### Neu
+- **EÜR Übersicht** (`steuerindex.php`)
+  - Dashboard mit Einnahmen/Ausgaben/Gewinn
+  - Jahres- und Monatsfilter
+  - Schnellzugriff auf alle Funktionen
+
+- **Buchungsverwaltung** (`buchung_list.php`, `buchung_card.php`)
+  - Liste aller Buchungen (automatisch + manuell)
+  - Manuelle Buchungen erstellen/bearbeiten/löschen
+  - Integration mit Dolibarr Rechnungen
+
+- **Anlage EÜR** (`euer_bericht.php`)
+  - Offizielles EÜR-Format
+  - Alle Zeilen 10-87
+  - Automatische Berechnung
+
+- **USt-Voranmeldung** (`ustva.php`)
+  - ELSTER-Kennzahlen (Kz 81, 86, 66, 83, etc.)
+  - WISO Steuer Zeilenzuordnung
+  - Monats-/Quartalsansicht
+  - Jahresübersicht
+
+- **Gewerbesteuer** (`gewerbesteuer.php`)
+  - Vollständige Berechnung
+  - Konfigurierbarer Hebesatz
+  - Hinzurechnungen/Kürzungen
+  - ESt-Anrechnung (§ 35 EStG)
+
+- **WISO Export** (`export_wiso.php`)
+  - WISO EÜR Format (CSV)
+  - DATEV Format (CSV)
+  - UStVA Werte (CSV)
+  - Datenvorschau
+
+- **Kontenplan** (`konten.php`)
+  - SKR03-Kontenrahmen
+  - EÜR-Zeilen-Zuordnung
+  - USt-Kennzahlen
+
+- **Sprachdateien**
+  - Deutsch (de_DE)
+  - Englisch (en_US)
+
+- **Datenbank**
+  - Automatische Tabellenerstellung bei Modulaktivierung
+  - SKR03-Konten werden automatisch eingefügt
+
+### Technisch
+- PHP 7.4+ kompatibel
+- Dolibarr 14.0+ kompatibel
+- Zufluss-/Abflussprinzip implementiert
+- Zurück-Buttons auf allen Seiten
--- a/README.md
+++ b/README.md
@ -1,96 +1,124 @@
-# STEUER FOR [DOLIBARR ERP & CRM](https://www.dolibarr.org)
+# EÜR Deutschland - Dolibarr Modul

-## Features
+Einnahmen-Überschuss-Rechnung (EÜR) Modul für Dolibarr ERP & CRM.

-Description of the module...
+## Funktionen

-<!--
-![Screenshot steuer](img/screenshot_steuer.png?raw=true "Steuer"){imgmd}
-->
+Dieses Modul bietet eine vollständige EÜR-Lösung für deutsche Kleinunternehmer, Freiberufler und Selbständige:

-Other external modules are available on [Dolistore.com](https://www.dolistore.com).
+### EÜR Übersicht
+- Automatische Berechnung von Einnahmen und Ausgaben aus Dolibarr-Rechnungen
+- Zufluss-/Abflussprinzip (Ist-Versteuerung)
+- Jahres- und Monatsübersicht
+- Gewinn/Verlust-Anzeige

-## Translations
+### USt-Voranmeldung (UStVA)
+- Alle ELSTER-Kennzahlen (Kz 81, 86, 66, 83, etc.)
+- WISO Steuer Zeilenzuordnung
+- Monatliche und quartalsweise Ansicht
+- Jahresübersicht mit allen Perioden

-Translations can be completed manually by editing files in the module directories under `langs`.
+### Gewerbesteuer-Berechnung
+- Automatische Berechnung aus EÜR-Gewinn
+- Konfigurierbarer Hebesatz
+- Hinzurechnungen und Kürzungen
+- ESt-Anrechnung nach § 35 EStG

-<!--
-This module contains also a sample configuration for Transifex, under the hidden directory [.tx](.tx), so it is possible to manage translation using this service.
+### Anlage EÜR
+- Offizielles Format der Anlage EÜR
+- Alle relevanten Zeilen (10-87)
+- Export-Funktion

-For more information, see the [translator's documentation](https://wiki.dolibarr.org/index.php/Translator_documentation).
+### WISO Export
+- CSV-Export im WISO EÜR Format
+- DATEV-Format für Steuerberater
+- UStVA-Werte als CSV

-There is a [Transifex project](https://transifex.com/projects/p/dolibarr-module-template) for this module.
-->
+### Kontenplan
+- Vereinfachter SKR03-Kontenrahmen
+- EÜR-Zeilen-Zuordnung
+- USt-Kennzahlen-Mapping

+### Manuelle Buchungen
+- Zusätzliche Buchungen erfassen
+- Für Belege außerhalb von Dolibarr
+- Vollständige CRUD-Funktionalität

 ## Installation

-Prerequisites: You must have Dolibarr ERP & CRM software installed. You can download it from [Dolistore.org](https://www.dolibarr.org).
-You can also get a ready-to-use instance in the cloud from https://saas.dolibarr.org
+### Voraussetzungen
+- Dolibarr ERP & CRM >= 14.0
+- PHP >= 7.4
+- MySQL/MariaDB

+### Installation
+1. Modul in `/custom/steuer/` kopieren
+2. In Dolibarr als Admin anmelden
+3. Setup → Module → "EÜR Deutschland" aktivieren
+4. Die Datenbanktabellen werden automatisch erstellt

-### From the ZIP file and GUI interface
+### Nach der Installation
+Das Modul erscheint im Hauptmenü unter "EÜR" mit folgenden Untermenüs:
+- Übersicht
+- Buchungen
+- Anlage EÜR
+- USt-Voranmeldung
+- Gewerbesteuer
+- WISO Export
+- Kontenplan

-If the module is a ready-to-deploy zip file, so with a name `module_xxx-version.zip` (e.g., when downloading it from a marketplace like [Dolistore](https://www.dolistore.com)),
-go to menu `Home> Setup> Modules> Deploy external module` and upload the zip file.
+## Verwendung

-<!--
+### Datenquellen
+Das Modul liest automatisch aus:
+- **Kundenrechnungen** (llx_facture) → Einnahmen
+- **Lieferantenrechnungen** (llx_facture_fourn) → Ausgaben
+- **Zahlungen** für Zufluss-/Abflussprinzip

-Note: If this screen tells you that there is no "custom" directory, check that your setup is correct:
+### Zufluss-/Abflussprinzip
+- Einnahmen werden zum Zahlungseingang erfasst
+- Ausgaben werden zum Zahlungsausgang erfasst
+- Entspricht der Ist-Versteuerung für EÜR

- In your Dolibarr installation directory, edit the `htdocs/conf/conf.php` file and check that following lines are not commented:
+### WISO Steuer Integration
+1. Gehe zu "WISO Export"
+2. Wähle Jahr und Format
+3. Exportiere CSV
+4. Importiere in WISO Steuer

-    ```php
-    //$dolibarr_main_url_root_alt ...
-    //$dolibarr_main_document_root_alt ...
-    ```
+### UStVA übertragen
+1. Gehe zu "USt-Voranmeldung"
+2. Wähle Monat/Quartal
+3. Übertrage die Kennzahlen in ELSTER oder WISO:
+   - Kz 81 → Umsätze 19%
+   - Kz 86 → Umsätze 7%
+   - Kz 66 → Vorsteuer
+   - Kz 83 → Zahllast/Erstattung

- Uncomment them if necessary (delete the leading `//`) and assign the proper value according to your Dolibarr installation
+## Datenbanktabellen

-    For example :
+Das Modul erstellt folgende Tabellen:
+- `llx_steuer_konto` - SKR03 Kontenrahmen
+- `llx_steuer_buchung` - Manuelle Buchungen
+- `llx_steuer_ustva` - UStVA-Daten (optional)
+- `llx_steuer_gewerbe` - Gewerbesteuer-Daten (optional)

-    - UNIX:
-        ```php
-        $dolibarr_main_url_root_alt = '/custom';
-        $dolibarr_main_document_root_alt = '/var/www/Dolibarr/htdocs/custom';
-        ```
+## Hinweise

-    - Windows:
-        ```php
-        $dolibarr_main_url_root_alt = '/custom';
-        $dolibarr_main_document_root_alt = 'C:/My Web Sites/Dolibarr/htdocs/custom';
-        ```
-->
+- Dieses Modul ersetzt keine Steuerberatung
+- Alle Werte vor Abgabe prüfen
+- Für die offizielle Steuererklärung WISO Steuer oder ELSTER verwenden

-<!--
+## Lizenz

-### From a GIT repository
+GPLv3 oder (nach Wahl) jede spätere Version. Siehe COPYING für Details.

-Clone the repository in `$dolibarr_main_document_root_alt/steuer`
+## Autor

-```shell
-cd ....../custom
-git clone git@github.com:gitlogin/steuer.git steuer
-```
+Eduard Wisch - 2026

-->
+## Support

-### Final steps
-
-Using your browser:
-
-  - Log into Dolibarr as a super-administrator
-  - Go to "Setup"> "Modules"
-  - You should now be able to find and enable the module
-
-
-
-## Licenses
-
-### Main code
-
-GPLv3 or (at your option) any later version. See file COPYING for more information.
-
-### Documentation
-
-All texts and readme's are licensed under [GFDL](https://www.gnu.org/licenses/fdl-1.3.en.html).
+Bei Fragen oder Problemen:
+- GitHub Issues
+- Dolibarr Forum