euer-datev 0.1.0__tar.gz

euer_datev-0.1.0/LICENSE

@@ -0,0 +1,20 @@
+PROPRIETARY AND COMMERCIAL SOFTWARE LICENSE
+
+Copyright (c) 2026 Markus. All Rights Reserved.
+
+This software ("euer-datev") and its associated documentation files are proprietary 
+and confidential commercial software. 
+
+Unauthorized copying, distribution, modification, public display, reverse engineering, 
+decompilation, or dissemination of this software, via any medium, is strictly prohibited 
+without express prior written permission from the copyright holder.
+
+This software is licensed, not sold. Usage is subject to the purchase of a valid 
+commercial license key or subscription agreement.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, 
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR 
+PURPOSE, TITLE, AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE 
+FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
+DEALINGS IN THE SOFTWARE.

euer_datev-0.1.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: euer-datev
+Version: 0.1.0
+Summary: Offizieller DATEV-Export (EXTF 700) & Kanzlei-Schnittstelle für euer
+Author: Markus
+Project-URL: Documentation, https://euer-buchhaltung.de/docs/datev
+Keywords: datev,euer,buchhaltung,skr03,skr04,kanzlei,steuerberater,extf
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: coverage>=7.10; extra == "dev"
+Requires-Dist: ruff>=0.8; extra == "dev"
+Dynamic: license-file
+
+# euer-datev: Offizieller DATEV-Export (EXTF 700) & Kanzlei-Schnittstelle
+
+> **Die professionelle DATEV-Brücke für `euer`:** Exportiert deine EÜR-Buchhaltungsdaten und Belege mit einem einzigen Klick im offiziellen DATEV-Format — für die reibungslose Übernahme in **DATEV Kanzlei-Rechnungswesen**.
+
+---
+
+## Warum euer-datev?
+
+Viele Freelancer und Selbstständige führen ihre laufende Buchhaltung effizient mit `euer`, übergeben die Jahresdaten für den Jahresabschluss und die Steuererklärung aber an ihre Steuerberatung. 
+
+Das Problem: Steuerberater arbeiten mit **DATEV**. Wenn sie Belege, unformatierte Excel-Listen oder unstrukturierte CSVs erhalten, müssen die Daten händisch eingetippt werden. Das kostet Kanzleistunden und treibt das Steuerberaterhonorar unnötig in die Höhe.
+
+`euer-datev` löst dieses Problem an der Wurzel:
+
+* ⚡ **1-Klick DATEV-Export:** Generiert einen standardkonformen **DATEV EXTF-700 Buchungsstapel** (Kategorie 21), den der Steuerberater in 2 Sekunden einliest.
+* 📦 **Beleg-Packaging:** Packt alle zugehörigen Beleg-PDFs in ein ZIP-Archiv und referenziert sie im Feld `Beleglink` als Datei-/DMS-Referenz für die Kanzlei. (Hinweis: Vollautomatische Verknüpfung in DATEV Unternehmen online via XML-Schnittstelle online steht auf der Roadmap).
+* 📋 **SKR 03 & SKR 04 Unterstützung:** Automatische Kontenzuordnung über den Kontenrahmen (`[[ledger_accounts]]`) oder erprobte Kanzlei-Standards.
+* 🔍 **Pre-Flight Validierung:** Erkennt fehlende Konten, nicht zugeordnete Belege oder unklare Steuerfälle **vor** dem Export und liefert ein transparentes Prüfprotokoll.
+* 🔌 **Doppelte Flexibilität:** Funktioniert nahtlos als **Plugin** in der bestehenden `euer`-CLI (`euer datev export`) oder als eigenständiges **Standalone-Tool** (`euer-datev export`).
+
+---
+
+## Installation & Einrichtung
+
+### Als Plugin in einer bestehenden euer-Installation (Empfohlen)
+
+Wenn du `euer` über `pipx` installiert hast, installierst du das Add-on mit einem Befehl:
+
+```bash
+pipx inject euer euer-datev
+```
+
+Danach steht dir der Befehl `euer datev` direkt in deiner gewohnten CLI zur Verfügung:
+
+```bash
+euer datev --help
+```
+
+### Als Standalone-Tool
+
+Du kannst `euer-datev` auch unabhängig als eigenständige CLI installieren:
+
+```bash
+pipx install euer-datev
+```
+
+---
+
+## Quickstart
+
+### 1. Kontenrahmen konfigurieren (optional, aber empfohlen)
+
+Erzeuge dir eine passende Vorlage für deinen Kontenrahmen (Standard: SKR 03):
+
+```bash
+euer datev init-skr --skr 03
+```
+
+Kopiere den Block in deine `~/.config/euer/config.toml` (oder nutze `--write ~/.config/euer/config.toml`). Hier kannst du deine Berater- und Mandantennummer der Kanzlei hinterlegen:
+
+```toml
+[datev]
+berater_nummer = "1001"
+mandanten_nummer = "10001"
+skr = "03"
+
+[datev.accounts]
+"g-n26" = "1200"     # Bankkonto in SKR03
+"privat" = "1890"    # Privateinlage
+```
+
+### 2. Daten vorab prüfen
+
+Prüfe, ob alle Buchungen für das gewünschte Steuerjahr vollständig und DATEV-konform sind:
+
+```bash
+euer datev validate --year 2026
+```
+
+### 3. DATEV-Paket exportieren
+
+Erstelle das fertige Exportpaket (ZIP-Archiv mit Buchungsstapel, Belegen und Prüfprotokoll):
+
+```bash
+euer datev export --year 2026 --skr 03
+```
+
+Ausgabe:
+```text
+✅ DATEV-Exportpaket erfolgreich erstellt: /Users/.../exports/DATEV_EXTF_2026.zip
+   • 42 Buchungssätze (18.450,00 EUR)
+   • 42 Belege im Archiv abgelegt (Beleglink-Referenz)
+```
+
+Sende diese ZIP-Datei einfach an deinen Steuerberater!
+
+---
+
+## Anleitung für die Steuerberatungskanzlei
+
+So liest die Kanzlei das Exportpaket in **DATEV Kanzlei-Rechnungswesen** ein:
+
+1. **ZIP-Archiv entpacken:**  
+   Entpacken Sie `DATEV_EXTF_2026.zip`. Der Ordner enthält:
+   * `EXTF_Buchungsstapel.csv` (Offizieller DATEV EXTF-700 Stapel)
+   * `belege/` (Alle Beleg-PDFs)
+   * `PRUEFPROTOKOLL.txt` (Zusammenfassung und Validierungsbericht)
+
+2. **Buchungsstapel einlesen:**  
+   * In *Kanzlei-Rechnungswesen* das Mandat öffnen.
+   * Wählen Sie: **Bestand ➔ Importieren ➔ Stapelverarbeitung**.
+   * Format: **DATEV-Format**.
+   * Wählen Sie die Datei `EXTF_Buchungsstapel.csv` aus und klicken Sie auf **Importieren**.
+   * Die Buchungssätze stehen nun im Vorlauf zur Prüfung und Festschreibung bereit.
+
+3. **Digitale Belege (Datei-/DMS-Referenz):**  
+   * Der Ordner `belege/` enthält alle exportierten Belegdateien.
+   * Das Feld `Beleglink` in der CSV enthält die relative Dateireferenz (z. B. `belege/2026-03-15_rechnung.pdf`) zur einfachen Zuordnung im Dokumentenmanagementsystem (DMS) oder bei manueller Prüfung.
+   * Eine automatisierte Verknüpfung über die DATEV XML-Schnittstelle online befindet sich auf der Roadmap.
+
+---
+
+## CLI-Referenz
+
+### `export`
+Erzeugt den DATEV-Export:
+
+```bash
+euer datev export [OPTIONEN]
+```
+
+* `--year <JAHR>`: Steuerjahr filtern (z. B. `2026`)
+* `--quarter <1-4>`: Quartal filtern (z. B. `--quarter 1`)
+* `--month <1-12>`: Einzelnen Monat filtern (z. B. `--month 3`)
+* `--from-date / --to-date`: Datumsbereich im ISO-Format (`YYYY-MM-DD`)
+* `--skr <03|04>`: Kontenrahmen auswählen (Standard: `03`)
+* `--format <zip|csv>`: `zip` (inkl. Belege & Protokoll) oder `csv` (nur Buchungsstapel)
+* `-o, --output <PFAD>`: Zielpfad oder Zielverzeichnis
+* `--berater <NR>`: Beraternummer überschreiben
+* `--mandant <NR>`: Mandantennummer überschreiben
+* `--force`: Export trotz Validierungsfehlern erzwingen
+
+### `validate`
+Führt eine Vorab-Prüfung durch:
+
+```bash
+euer datev validate --year 2026
+```
+
+### `init-skr`
+Erzeugt empfohlene Konfigurationsblätter für SKR 03 oder SKR 04:
+
+```bash
+euer datev init-skr --skr 03
+```
+
+### `license`
+Lizenzschlüssel verwalten und aktivieren:
+
+```bash
+# Lizenzstatus abfragen
+euer datev license status
+
+# Lizenzschlüssel aktivieren
+euer datev license activate <DEIN_LIZENZSCHLUESSEL>
+```
+
+Weitere Details zum Lizenzmodell und Erwerb: [euer-buchhaltung.de/datev](https://euer-buchhaltung.de/datev)
+
+---
+
+## Technische Details & Spezifikation
+
+* **Format-Standard:** DATEV EXTF Version 700 / Kategorie 21 (Buchungsstapel).
+* **Zeichenkodierung:** Streng `Windows-1252 (ANSI)` mit `CRLF`-Zeilenumbruch.
+* **Umsatzsteuer & Reverse Charge:** Automatische Zuweisung gültiger DATEV-Berichtigungsschlüssel (z. B. BU `9` für 19 % Vorsteuer, BU `94` für § 13b Reverse Charge EU).
+* Detaillierte Spezifikationen: Siehe [`docs/DATEV_SPECIFICATION.md`](docs/DATEV_SPECIFICATION.md).
+
+---
+
+## Lizenz
+
+Proprietary Commercial Software. Copyright (c) 2026 Markus Keller. Alle Rechte vorbehalten.

euer_datev-0.1.0/README.md

@@ -0,0 +1,183 @@
+# euer-datev: Offizieller DATEV-Export (EXTF 700) & Kanzlei-Schnittstelle
+
+> **Die professionelle DATEV-Brücke für `euer`:** Exportiert deine EÜR-Buchhaltungsdaten und Belege mit einem einzigen Klick im offiziellen DATEV-Format — für die reibungslose Übernahme in **DATEV Kanzlei-Rechnungswesen**.
+
+---
+
+## Warum euer-datev?
+
+Viele Freelancer und Selbstständige führen ihre laufende Buchhaltung effizient mit `euer`, übergeben die Jahresdaten für den Jahresabschluss und die Steuererklärung aber an ihre Steuerberatung. 
+
+Das Problem: Steuerberater arbeiten mit **DATEV**. Wenn sie Belege, unformatierte Excel-Listen oder unstrukturierte CSVs erhalten, müssen die Daten händisch eingetippt werden. Das kostet Kanzleistunden und treibt das Steuerberaterhonorar unnötig in die Höhe.
+
+`euer-datev` löst dieses Problem an der Wurzel:
+
+* ⚡ **1-Klick DATEV-Export:** Generiert einen standardkonformen **DATEV EXTF-700 Buchungsstapel** (Kategorie 21), den der Steuerberater in 2 Sekunden einliest.
+* 📦 **Beleg-Packaging:** Packt alle zugehörigen Beleg-PDFs in ein ZIP-Archiv und referenziert sie im Feld `Beleglink` als Datei-/DMS-Referenz für die Kanzlei. (Hinweis: Vollautomatische Verknüpfung in DATEV Unternehmen online via XML-Schnittstelle online steht auf der Roadmap).
+* 📋 **SKR 03 & SKR 04 Unterstützung:** Automatische Kontenzuordnung über den Kontenrahmen (`[[ledger_accounts]]`) oder erprobte Kanzlei-Standards.
+* 🔍 **Pre-Flight Validierung:** Erkennt fehlende Konten, nicht zugeordnete Belege oder unklare Steuerfälle **vor** dem Export und liefert ein transparentes Prüfprotokoll.
+* 🔌 **Doppelte Flexibilität:** Funktioniert nahtlos als **Plugin** in der bestehenden `euer`-CLI (`euer datev export`) oder als eigenständiges **Standalone-Tool** (`euer-datev export`).
+
+---
+
+## Installation & Einrichtung
+
+### Als Plugin in einer bestehenden euer-Installation (Empfohlen)
+
+Wenn du `euer` über `pipx` installiert hast, installierst du das Add-on mit einem Befehl:
+
+```bash
+pipx inject euer euer-datev
+```
+
+Danach steht dir der Befehl `euer datev` direkt in deiner gewohnten CLI zur Verfügung:
+
+```bash
+euer datev --help
+```
+
+### Als Standalone-Tool
+
+Du kannst `euer-datev` auch unabhängig als eigenständige CLI installieren:
+
+```bash
+pipx install euer-datev
+```
+
+---
+
+## Quickstart
+
+### 1. Kontenrahmen konfigurieren (optional, aber empfohlen)
+
+Erzeuge dir eine passende Vorlage für deinen Kontenrahmen (Standard: SKR 03):
+
+```bash
+euer datev init-skr --skr 03
+```
+
+Kopiere den Block in deine `~/.config/euer/config.toml` (oder nutze `--write ~/.config/euer/config.toml`). Hier kannst du deine Berater- und Mandantennummer der Kanzlei hinterlegen:
+
+```toml
+[datev]
+berater_nummer = "1001"
+mandanten_nummer = "10001"
+skr = "03"
+
+[datev.accounts]
+"g-n26" = "1200"     # Bankkonto in SKR03
+"privat" = "1890"    # Privateinlage
+```
+
+### 2. Daten vorab prüfen
+
+Prüfe, ob alle Buchungen für das gewünschte Steuerjahr vollständig und DATEV-konform sind:
+
+```bash
+euer datev validate --year 2026
+```
+
+### 3. DATEV-Paket exportieren
+
+Erstelle das fertige Exportpaket (ZIP-Archiv mit Buchungsstapel, Belegen und Prüfprotokoll):
+
+```bash
+euer datev export --year 2026 --skr 03
+```
+
+Ausgabe:
+```text
+✅ DATEV-Exportpaket erfolgreich erstellt: /Users/.../exports/DATEV_EXTF_2026.zip
+   • 42 Buchungssätze (18.450,00 EUR)
+   • 42 Belege im Archiv abgelegt (Beleglink-Referenz)
+```
+
+Sende diese ZIP-Datei einfach an deinen Steuerberater!
+
+---
+
+## Anleitung für die Steuerberatungskanzlei
+
+So liest die Kanzlei das Exportpaket in **DATEV Kanzlei-Rechnungswesen** ein:
+
+1. **ZIP-Archiv entpacken:**  
+   Entpacken Sie `DATEV_EXTF_2026.zip`. Der Ordner enthält:
+   * `EXTF_Buchungsstapel.csv` (Offizieller DATEV EXTF-700 Stapel)
+   * `belege/` (Alle Beleg-PDFs)
+   * `PRUEFPROTOKOLL.txt` (Zusammenfassung und Validierungsbericht)
+
+2. **Buchungsstapel einlesen:**  
+   * In *Kanzlei-Rechnungswesen* das Mandat öffnen.
+   * Wählen Sie: **Bestand ➔ Importieren ➔ Stapelverarbeitung**.
+   * Format: **DATEV-Format**.
+   * Wählen Sie die Datei `EXTF_Buchungsstapel.csv` aus und klicken Sie auf **Importieren**.
+   * Die Buchungssätze stehen nun im Vorlauf zur Prüfung und Festschreibung bereit.
+
+3. **Digitale Belege (Datei-/DMS-Referenz):**  
+   * Der Ordner `belege/` enthält alle exportierten Belegdateien.
+   * Das Feld `Beleglink` in der CSV enthält die relative Dateireferenz (z. B. `belege/2026-03-15_rechnung.pdf`) zur einfachen Zuordnung im Dokumentenmanagementsystem (DMS) oder bei manueller Prüfung.
+   * Eine automatisierte Verknüpfung über die DATEV XML-Schnittstelle online befindet sich auf der Roadmap.
+
+---
+
+## CLI-Referenz
+
+### `export`
+Erzeugt den DATEV-Export:
+
+```bash
+euer datev export [OPTIONEN]
+```
+
+* `--year <JAHR>`: Steuerjahr filtern (z. B. `2026`)
+* `--quarter <1-4>`: Quartal filtern (z. B. `--quarter 1`)
+* `--month <1-12>`: Einzelnen Monat filtern (z. B. `--month 3`)
+* `--from-date / --to-date`: Datumsbereich im ISO-Format (`YYYY-MM-DD`)
+* `--skr <03|04>`: Kontenrahmen auswählen (Standard: `03`)
+* `--format <zip|csv>`: `zip` (inkl. Belege & Protokoll) oder `csv` (nur Buchungsstapel)
+* `-o, --output <PFAD>`: Zielpfad oder Zielverzeichnis
+* `--berater <NR>`: Beraternummer überschreiben
+* `--mandant <NR>`: Mandantennummer überschreiben
+* `--force`: Export trotz Validierungsfehlern erzwingen
+
+### `validate`
+Führt eine Vorab-Prüfung durch:
+
+```bash
+euer datev validate --year 2026
+```
+
+### `init-skr`
+Erzeugt empfohlene Konfigurationsblätter für SKR 03 oder SKR 04:
+
+```bash
+euer datev init-skr --skr 03
+```
+
+### `license`
+Lizenzschlüssel verwalten und aktivieren:
+
+```bash
+# Lizenzstatus abfragen
+euer datev license status
+
+# Lizenzschlüssel aktivieren
+euer datev license activate <DEIN_LIZENZSCHLUESSEL>
+```
+
+Weitere Details zum Lizenzmodell und Erwerb: [euer-buchhaltung.de/datev](https://euer-buchhaltung.de/datev)
+
+---
+
+## Technische Details & Spezifikation
+
+* **Format-Standard:** DATEV EXTF Version 700 / Kategorie 21 (Buchungsstapel).
+* **Zeichenkodierung:** Streng `Windows-1252 (ANSI)` mit `CRLF`-Zeilenumbruch.
+* **Umsatzsteuer & Reverse Charge:** Automatische Zuweisung gültiger DATEV-Berichtigungsschlüssel (z. B. BU `9` für 19 % Vorsteuer, BU `94` für § 13b Reverse Charge EU).
+* Detaillierte Spezifikationen: Siehe [`docs/DATEV_SPECIFICATION.md`](docs/DATEV_SPECIFICATION.md).
+
+---
+
+## Lizenz
+
+Proprietary Commercial Software. Copyright (c) 2026 Markus Keller. Alle Rechte vorbehalten.

euer_datev-0.1.0/euer_datev/__init__.py

@@ -0,0 +1,10 @@
+"""euer-datev: Offizieller DATEV-Export (EXTF 700) & Kanzlei-Schnittstelle für euer.
+
+Ermöglicht den dateibasierten 1-Klick-Export von Buchungsdaten und Belegen
+im offiziellen DATEV-Format zur nahtlosen Übernahme in DATEV Kanzlei-Rechnungswesen.
+"""
+
+VERSION = "0.1.0"
+__version__ = VERSION
+
+__all__ = ["VERSION", "__version__"]