feat: SKR04 mapping, credit note reasons, audit prompt — 15 resources, 10 prompts

- Add einvoice://reference/skr04-mapping: 14 common invoice categories
  mapped to SKR04 accounts (DATEV standard chart of accounts)
- Add einvoice://reference/credit-note-reasons: 8 standardized credit
  note/correction reason codes with German descriptions and legal refs
- Add steuerprüfung_checkliste prompt: GoBD-compliant audit preparation
  checklist covering archiving, mandatory fields, VAT, corrections
- 537 tests, 2011 stmts, 100% coverage, ruff + mypy strict clean

Author: Mavengence

CHANGELOG.md

@@ -14,7 +14,7 @@ All notable changes to the einvoice-mcp project.
 - `einvoice_parse` — Parse XML/PDF into structured data
 - `einvoice_check_compliance` — Mandatory field checks with German suggestions
 
-#### MCP Resources (13)
+#### MCP Resources (15)
 - `einvoice://schemas/line-item` — JSON schema for line items
 - `einvoice://schemas/allowance-charge` — JSON schema for allowances/charges
 - `einvoice://schemas/item-attribute` — JSON schema for item attributes (BG-30)
@@ -28,8 +28,10 @@ All notable changes to the einvoice-mcp project.
 - `einvoice://system/kosit-status` — On-demand KoSIT validator health check
 - `einvoice://reference/e-rechnung-pflichten` — E-Rechnungspflichten Zeitplan 2020–2028
 - `einvoice://reference/br-de-rules` — Deutsche Geschäftsregeln (BR-DE) Referenz
+- `einvoice://reference/skr04-mapping` — SKR04 Kontenzuordnung (DATEV)
+- `einvoice://reference/credit-note-reasons` — Gutschrift-Gründe und Korrektur-Codes
 
-#### MCP Prompts (9)
+#### MCP Prompts (10)
 - `gutschrift_erstellen` — Credit note (381) creation guide
 - `reverse_charge_checkliste` — Reverse charge (§13b UStG) checklist
 - `xrechnung_schnellstart` — XRechnung quick start for public procurement
@@ -39,6 +41,7 @@ All notable changes to the einvoice-mcp project.
 - `handwerkerrechnung_35a` — Craftsman invoice for §35a EStG tax deduction
 - `typecode_entscheidungshilfe` — TypeCode decision tree (which code for which scenario)
 - `b2b_pflicht_2027` — B2B e-invoice mandate preparation checklist
+- `steuerprüfung_checkliste` — Tax audit readiness checklist (GoBD, §147 AO)
 
 #### EN 16931 Business Terms
 - BT-1..5 — Invoice number, date, type code, currency
@@ -118,4 +121,4 @@ All notable changes to the einvoice-mcp project.
 - Deployment guide (docs/DEPLOYMENT.md)
 - UBL format detection (rejects UBL with clear German error)
 - Pydantic validation errors with BT number references
-- 534 tests, 100% coverage (2011 stmts), ruff + mypy strict clean
+- 537 tests, 100% coverage (2011 stmts), ruff + mypy strict clean

README.md

@@ -3,7 +3,7 @@
 [![CI](https://github.com/Mavengence/einvoice-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Mavengence/einvoice-mcp/actions/workflows/ci.yml)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-534%20passed-brightgreen.svg)](#compliance-proof)
+[![Tests](https://img.shields.io/badge/tests-537%20passed-brightgreen.svg)](#compliance-proof)
 [![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](#module-coverage)
 
 **MCP-Server for German e-invoice compliance — XRechnung 3.0 & ZUGFeRD 2.x**
@@ -20,7 +20,7 @@ Germany mandated e-invoice reception for B2B as of January 2025 (BMF 2024-11-15)
 
 ## Compliance Proof
 
-**534 tests | 100% coverage (2011 stmts) | 0 failures | lint clean (ruff + mypy strict)**
+**537 tests | 100% coverage (2011 stmts) | 0 failures | lint clean (ruff + mypy strict)**
 
 *Run `make test` to verify.*
 
@@ -301,6 +301,8 @@ Every mandatory Business Term is tested in generated XML output:
 | `einvoice://system/kosit-status` | On-demand KoSIT-Validator Statusabfrage |
 | `einvoice://reference/e-rechnung-pflichten` | Zeitplan E-Rechnungspflichten 2020–2028 mit Rechtsgrundlagen |
 | `einvoice://reference/br-de-rules` | Deutsche Geschäftsregeln (BR-DE-1..24) mit Lösungshinweisen |
+| `einvoice://reference/skr04-mapping` | SKR04-Kontenzuordnung für häufige Rechnungsarten (DATEV) |
+| `einvoice://reference/credit-note-reasons` | Gutschrift-Gründe und Korrektur-Codes mit Empfehlungen |
 
 ### MCP Prompts
 
@@ -315,6 +317,7 @@ Every mandatory Business Term is tested in generated XML output:
 | `handwerkerrechnung_35a` | Handwerkerrechnung nach §35a EStG |
 | `typecode_entscheidungshilfe` | Entscheidungshilfe: Welcher TypeCode für welchen Anlass? |
 | `b2b_pflicht_2027` | Checkliste: B2B E-Rechnungspflicht ab 2027 vorbereiten |
+| `steuerprüfung_checkliste` | E-Rechnungen für Betriebsprüfung vorbereiten (GoBD, §147 AO) |
 
 ---
 

src/einvoice_mcp/server.py

@@ -437,6 +437,247 @@ def br_de_rules() -> str:
     )
 
 
+@mcp.resource("einvoice://reference/skr04-mapping")
+def skr04_mapping() -> str:
+    """SKR04-Kontenzuordnung für häufige Rechnungsarten.
+
+    Mapping von typischen Eingangsrechnungs-Kategorien zu
+    SKR04-Konten (Standardkontenrahmen 04, DATEV).
+    """
+    return json.dumps(
+        {
+            "title": "SKR04 — Typische Kontenzuordnung für Eingangsrechnungen",
+            "chart": "SKR04 (DATEV)",
+            "note": "Nur als Orientierung — die exakte Zuordnung hängt vom "
+            "individuellen Kontenplan des Unternehmens ab.",
+            "mappings": [
+                {
+                    "category": "Büromaterial / Bürobedarf",
+                    "account": "6815",
+                    "description": "Bürobedarf",
+                    "tax_rate": "19%",
+                },
+                {
+                    "category": "IT-Dienstleistung / Software",
+                    "account": "6570",
+                    "description": "Fremdleistungen / IT-Dienstleistungen",
+                    "tax_rate": "19%",
+                },
+                {
+                    "category": "Beratung / Consulting",
+                    "account": "6825",
+                    "description": "Rechts- und Beratungskosten",
+                    "tax_rate": "19%",
+                },
+                {
+                    "category": "Miete / Büromiete",
+                    "account": "6310",
+                    "description": "Miete (unbewegliche Wirtschaftsgüter)",
+                    "tax_rate": "19% oder 0%",
+                },
+                {
+                    "category": "Telefon / Internet",
+                    "account": "6805",
+                    "description": "Telefon",
+                    "tax_rate": "19%",
+                },
+                {
+                    "category": "Reisekosten",
+                    "account": "6670",
+                    "description": "Reisekosten Arbeitnehmer",
+                    "tax_rate": "19% / 7% / 0%",
+                },
+                {
+                    "category": "Werbung / Marketing",
+                    "account": "6600",
+                    "description": "Werbekosten",
+                    "tax_rate": "19%",
+                },
+                {
+                    "category": "Porto / Versand",
+                    "account": "6810",
+                    "description": "Porto",
+                    "tax_rate": "19% oder 0%",
+                },
+                {
+                    "category": "Reparatur / Instandhaltung",
+                    "account": "6470",
+                    "description": "Reparaturen und Instandhaltung",
+                    "tax_rate": "19%",
+                },
+                {
+                    "category": "Versicherung",
+                    "account": "6400",
+                    "description": "Versicherungen",
+                    "tax_rate": "0% (steuerbefreit)",
+                },
+                {
+                    "category": "Strom / Gas / Wasser",
+                    "account": "6325",
+                    "description": "Gas, Strom, Wasser",
+                    "tax_rate": "19%",
+                },
+                {
+                    "category": "Wareneinkauf",
+                    "account": "5000",
+                    "description": "Einkauf Roh-, Hilfs- und Betriebsstoffe",
+                    "tax_rate": "19% oder 7%",
+                },
+                {
+                    "category": "Kfz-Kosten",
+                    "account": "6520",
+                    "description": "Kfz-Kosten",
+                    "tax_rate": "19%",
+                },
+                {
+                    "category": "Fortbildung / Schulung",
+                    "account": "6830",
+                    "description": "Fortbildungskosten",
+                    "tax_rate": "19% oder 0%",
+                },
+            ],
+        },
+        ensure_ascii=False,
+        indent=2,
+    )
+
+
+@mcp.resource("einvoice://reference/credit-note-reasons")
+def credit_note_reasons() -> str:
+    """Gutschrift-Gründe (Credit Note Reason Codes) nach EN 16931.
+
+    Standardisierte Gründe für Gutschriften und Korrekturrechnungen
+    mit deutschen Beschreibungen und Empfehlungen.
+    """
+    return json.dumps(
+        {
+            "title": "Gutschrift- und Korrektur-Gründe",
+            "type_codes": {
+                "381": "Gutschrift (Credit Note)",
+                "384": "Korrekturrechnung (Corrected Invoice)",
+            },
+            "reasons": [
+                {
+                    "code": "1",
+                    "reason_de": "Retoure / Rückgabe",
+                    "reason_en": "Return of goods",
+                    "type_code": "381",
+                    "note": "Gesamte oder teilweise Rückgabe der Ware",
+                },
+                {
+                    "code": "2",
+                    "reason_de": "Preisänderung / Rabatt nachträglich",
+                    "reason_en": "Price correction",
+                    "type_code": "381",
+                    "note": "Nachträglicher Rabatt oder Preisanpassung",
+                },
+                {
+                    "code": "3",
+                    "reason_de": "Mengenabweichung",
+                    "reason_en": "Quantity difference",
+                    "type_code": "381",
+                    "note": "Liefermenge weicht von Rechnungsmenge ab",
+                },
+                {
+                    "code": "4",
+                    "reason_de": "Fehlerhafte Rechnungsdaten",
+                    "reason_en": "Invoice data error",
+                    "type_code": "384",
+                    "note": "Falsche Adresse, USt-IdNr., oder andere Stammdaten",
+                },
+                {
+                    "code": "5",
+                    "reason_de": "Umsatzsteuer-Korrektur",
+                    "reason_en": "Tax correction",
+                    "type_code": "384",
+                    "note": "Falscher Steuersatz oder -kategorie auf Originalrechnung",
+                },
+                {
+                    "code": "6",
+                    "reason_de": "Mängelrüge / Qualitätsmangel",
+                    "reason_en": "Quality deficiency",
+                    "type_code": "381",
+                    "note": "Minderung wegen mangelhafter Leistung (§437 BGB)",
+                },
+                {
+                    "code": "7",
+                    "reason_de": "Doppelte Rechnungsstellung",
+                    "reason_en": "Duplicate invoice",
+                    "type_code": "381",
+                    "note": "Vollständige Gutschrift der doppelt gestellten Rechnung",
+                },
+                {
+                    "code": "8",
+                    "reason_de": "Kulanz / Goodwill",
+                    "reason_en": "Goodwill gesture",
+                    "type_code": "381",
+                    "note": "Freiwillige Gutschrift ohne rechtliche Verpflichtung",
+                },
+            ],
+            "wichtig": [
+                "Gutschrift (381) muss IMMER die Originalrechnungsnummer referenzieren (BT-25)",
+                "Korrekturrechnung (384) ersetzt die fehlerhafte Rechnung vollständig",
+                "Teilkorrekturen: Gutschrift (381) + neue Rechnung (380) ausstellen",
+                "§14 Abs. 2 Satz 3 UStG: Berichtigung nur durch neues Dokument möglich",
+            ],
+        },
+        ensure_ascii=False,
+        indent=2,
+    )
+
+
+@mcp.prompt()
+def steuerprüfung_checkliste() -> str:
+    """Checkliste: E-Rechnungen für die Steuerprüfung vorbereiten.
+
+    Leitfaden zur Vorbereitung auf eine Betriebsprüfung mit
+    Fokus auf E-Rechnungs-Compliance und GoBD-Archivierung.
+    """
+    return (
+        "# Steuerprüfung — E-Rechnungs-Checkliste\n\n"
+        "## 1. Archivierung (GoBD-konform)\n"
+        "- [ ] E-Rechnungen im **Originalformat** archiviert (XML, nicht nur PDF)\n"
+        "- [ ] **10 Jahre** Aufbewahrungsfrist (§147 AO, §14b UStG)\n"
+        "- [ ] **Unveränderbarkeit** sichergestellt (kein nachträgliches Editieren)\n"
+        "- [ ] **Maschinelle Auswertbarkeit** gewährleistet (GoBD Tz. 128)\n"
+        "- [ ] Verfahrensdokumentation vorhanden\n\n"
+        "## 2. Pflichtangaben prüfen (§14 UStG)\n"
+        "- [ ] BT-1: Rechnungsnummer (fortlaufend, eindeutig)\n"
+        "- [ ] BT-2: Rechnungsdatum\n"
+        "- [ ] BT-27..40: Vollständige Verkäufer-Angaben (Name, Anschrift, USt-IdNr.)\n"
+        "- [ ] BT-44..55: Vollständige Käufer-Angaben\n"
+        "- [ ] Positionen: Menge, Art, Entgelt, Steuersatz, Steuerbetrag\n"
+        "- [ ] BT-81: Zahlungsart angegeben\n"
+        "- [ ] BT-20: Zahlungsbedingungen\n\n"
+        "## 3. Umsatzsteuer-Prüfung\n"
+        "- [ ] Steuersätze korrekt (19%, 7%, 0% mit Begründung)\n"
+        "- [ ] Reverse Charge (§13b): Hinweis vorhanden, 0% Steuer\n"
+        "- [ ] Innergemeinschaftliche Lieferungen: USt-IdNr. beider Parteien\n"
+        "- [ ] Steuerbefreiungen: Befreiungsgrund (BT-120) und Code (BT-121)\n"
+        "- [ ] Vorsteuerabzug: Alle Voraussetzungen erfüllt?\n\n"
+        "## 4. Gutschriften und Korrekturen\n"
+        "- [ ] Gutschriften (381) referenzieren Originalrechnung (BT-25)\n"
+        "- [ ] Korrekturrechnungen (384) referenzieren Originalrechnung (BT-25)\n"
+        "- [ ] Keine 'informellen' Korrekturen per E-Mail oder PDF\n"
+        "- [ ] Stornierungen vollständig dokumentiert\n\n"
+        "## 5. Validierung\n"
+        "- [ ] Alle E-Rechnungen gegen **KoSIT-Validator** geprüft\n"
+        "- [ ] XRechnung: BR-DE-Regeln erfüllt\n"
+        "- [ ] ZUGFeRD: PDF/A-3 Konformität sichergestellt\n"
+        "- [ ] IBAN/BIC-Formate korrekt\n\n"
+        "## 6. B2B-Pflicht (ab 2025/2027/2028)\n"
+        "- [ ] Empfang von E-Rechnungen sichergestellt (seit 01.01.2025)\n"
+        "- [ ] Versand vorbereitet (ab 2027 für Umsatz > 800K€, ab 2028 für alle)\n"
+        "- [ ] Format: EN 16931 (XRechnung oder ZUGFeRD)\n\n"
+        "## Typische Prüfungsschwerpunkte:\n"
+        "1. **Rechnungsnummern-Lücken** — fehlende Nummern im Kreis\n"
+        "2. **Vorsteuerabzug** — alle formellen Voraussetzungen erfüllt?\n"
+        "3. **Reverse Charge** — §13b korrekt angewendet?\n"
+        "4. **Innergemeinschaftliche Lieferungen** — ZM abgegeben?\n"
+        "5. **Archivierung** — GoBD-Konformität nachweisbar?"
+    )
+
+
 @mcp.prompt()
 def b2b_pflicht_2027() -> str:
     """Checkliste: B2B E-Rechnungspflicht ab 2027 vorbereiten.

tests/unit/test_comprehensive.py

@@ -6985,6 +6985,53 @@ def test_br_de_rules_resource(self) -> None:
             assert "fix" in rule
 
 
+    def test_skr04_mapping_resource(self) -> None:
+        from einvoice_mcp.server import skr04_mapping
+
+        text = skr04_mapping()
+        data = json.loads(text)
+        assert data["chart"] == "SKR04 (DATEV)"
+        assert "mappings" in data
+        assert len(data["mappings"]) >= 10
+        categories = {m["category"] for m in data["mappings"]}
+        assert "Büromaterial / Bürobedarf" in categories
+        assert "IT-Dienstleistung / Software" in categories
+        for m in data["mappings"]:
+            assert "account" in m
+            assert "description" in m
+            assert "tax_rate" in m
+
+    def test_credit_note_reasons_resource(self) -> None:
+        from einvoice_mcp.server import credit_note_reasons
+
+        text = credit_note_reasons()
+        data = json.loads(text)
+        assert "reasons" in data
+        assert len(data["reasons"]) >= 8
+        assert "381" in data["type_codes"]
+        assert "384" in data["type_codes"]
+        assert "wichtig" in data
+        for r in data["reasons"]:
+            assert "code" in r
+            assert "reason_de" in r
+            assert "type_code" in r
+
+
+class TestSteuerprüfungPrompt:
+    """Test the audit readiness prompt."""
+
+    def test_steuerprüfung_checkliste(self) -> None:
+        from einvoice_mcp.server import steuerprüfung_checkliste
+
+        text = steuerprüfung_checkliste()
+        assert "GoBD" in text
+        assert "§147 AO" in text or "§14b UStG" in text
+        assert "10 Jahre" in text
+        assert "Reverse Charge" in text
+        assert "BT-25" in text
+        assert "KoSIT" in text
+
+
 class TestB2BPflichtPrompt:
     """Test the B2B mandate prompt."""