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.
