convez.ai
PluginFinanceiroAvançado
tgw013

HGB Accounting Plugin

tgw013/HGB-accounting-plugin

Contabilidade alemã HGB/DATEV para Claude com conformidade GoBD

Ver no GitHub
BomPluginScore · de 0 a 100

Plugin de contabilidade e finanças para empresas alemãs (GmbH/UG) que implementa HGB, SKR03/SKR04, conformidade GoBD e export DATEV. Gera lançamentos contábeis em diário, declaração de IVA, folha de pagamento e fechamentos mensais/anuais com suporte a alocação de custos e séries recorrentes.

Instalação

$npx convez-ai tgw013/HGB-accounting-plugin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
1
Acompanhando
0
Saúde
100%
Último commit
há 5 meses
Versão
v2.7.2
Issues abertas
0
Contribuidores
2

Casos de uso

  • Registrar lançamentos contábeis em GmbH/UG com SKR03 ou SKR04
  • Gerar exports DATEV-EXTF determinísticos (byte-idênticos) para importação em software contábil
  • Preparar declarações de IVA (USt-Voranmeldung) e fechamentos fiscais
  • Distribuir custos entre múltiplas centros de custo (KOST-Splitt)
  • Gerenciar lançamentos recorrentes (mensais/trimestrais) com conformidade regulatória

Veredito

Plugin robusto e bem documentado para contabilidade alemã, com 16 skills e export DATEV verificado. Excelente para automação de rotinas contábeis, mas requer revisão por contador/auditor antes de uso produtivo — não substitui consultoria fiscal.

README

A tradução para o português deste README ainda está na fila.

germany-accounting

Ein Finanz- und Buchhaltungs-Plugin für Cowork (Anthropic's agentische Desktop-App) — funktioniert auch in Claude Code. Auf deutsche Rechtslage portiert: HGB, DATEV-SKR03/04, USt-Voranmeldung, Lohn, GoBD/IKS, eBilanz-Vorbereitung. Geltungsbereich GmbH + UG.

⚠ Hinweis: Automatisiertes Hilfsmittel auf Basis öffentlich verifizierter Quellen (DATEV-SKR03/04 2025+2026, HGB/EStG/UStG/KStG/SGB Stand 2026-05, BMF-Vordruckmuster). Ersetzt keine Steuerberatung. Output ist Vorschlag — vor produktiver Buchung mit Steuerberater/Wirtschaftsprüfer abgleichen.

Status: v2.7.2. 16 Skills + 16 Commands, 128 Konten gegen DATEV-PDFs 2025+2026 verifiziert, DATEV-EXTF-Export deterministisch (Python-Serializer mit PORTAL-verifizierter Feld-Inventar; identische Eingabe → byte-identische CSV via SHA-256, GoBD-relevant) + Automatikkonten-Schutz (verhindert REW00305) + Wiederkehrende Buchungen (Formatkategorie 65 v4 für monatliche/quartalsweise Serien) + KOST-Splitt (eine Buchung über mehrere Kostenstellen verteilen via kost_allocations) + buchungssatz erweitert (Belege + Abschlussbuchungen § 249/§ 250, JSON-Handoff für datev-export) + bwa-kommentierung (BWA-/GuV-Kommentierung, Pendant zu financial-statements) + EXTF-Saldo-Fix (vollständige Konto-an-Gegenkonto-Zeilen self-balancing → keine Doppelbuchung beim Import). Vorgänger-Tags: v1.1.0, v2.0.0-alpha, v2.0.0, v2.0.1, v2.1.0, v2.3.0, v2.5.0, v2.6.0, v2.7.0, v2.7.1.


Quick Overview (English)

A finance and accounting plugin for German GmbH/UG entities — HGB-compliant journal entries with SKR03/SKR04, VAT pre-registration, payroll, monthly/annual close, and GoBD/IKS compliance. Primarily designed for Cowork; also works in Claude Code. Inspired by Anthropic's finance plugin (US-focused), independently ported to German law. Output is a draft — review with a Steuerberater (German tax advisor) before productive use.


Installation

Cowork (empfohlen für Nicht-Entwickler)

Cowork installiert Plugins über ZIP-Upload (kein Slash-Command-Marketplace wie Claude Code).

  1. Lade die fertige ZIP von der Releases-Seite herunter — germany-accounting-vX.Y.Z.zip (Asset der jeweiligen Release).
  2. In Cowork: Plugin-Bereich öffnen → neues Plugin hinzufügen → ZIP hochladen.
  3. Skills + Commands stehen sofort zur Verfügung.

⚠ Nicht GitHub's grünen "Code → Download ZIP" Button benutzen — dort liegt alles in einem Wrapper-Ordner HGB-accounting-plugin-main/, was Cowork nicht versteht. Immer die Release-ZIP nutzen.

Falls eine Release-ZIP fehlt (zwischen Releases): GitHub-ZIP entpacken, in den entpackten Ordner gehen, dort .claude-plugin, commands, skills, config, scripts/generate_extf.py, .mcp.json etc. markieren und neu zippen (Windows: Rechtsklick → "In ZIP-Datei komprimieren"). Diese neue ZIP in Cowork hochladen.

Claude Code (für Entwickler)

Innerhalb einer aktiven Claude-Code-Session:

/plugin marketplace add tgw013/HGB-accounting-plugin
/plugin install germany-accounting@hgb-accounting

Oder als Shell-Shortcut (analog zu Anthropic's Finance-Plugin-README):

claude plugins add tgw013/HGB-accounting-plugin

Voraussetzungen: Claude Code (npm install -g @anthropic-ai/claude-code, Node 18+). Bei privatem Repo zusätzlich gh auth login.

Lokale Entwicklung: claude --plugin-dir ./HGB-accounting-plugin lädt das Plugin direkt aus einem Klon ohne Marketplace.

Doku-Quellen: Discover and install plugins, Plugin marketplaces.


Skills (16)

Skills stellen Hintergrundwissen und Workflow-Logik bereit. Claude wählt sie automatisch passend zur Aufgabe; Zugriff erfolgt über die Slash-Commands oder über natürliche Aufforderungen ("Erstelle Buchungssatz für …").

SkillTypAnthropic-PendantZweck
buchung-grundlagenknowledgejournal-entry-prep (Knowledge)Abschlussbuchungen-Wissen: RAP § 250, Rückstellungen § 249, Bewertung, HGB-vs-Steuerbilanz, DATEV-Praxis
buchungssatzworkflowjournal-entry (zu journal-entry-prep)Beleg ODER Abschlussbuchung → Buchungsvorschlag (SKR03/04, USt-Tatbestand, §-Begründung) + JSON-Handoff für datev-export
monatsabschlussworkflowclose-managementMonats-Closing-Checkliste, Abgrenzungen, USt-VA-Vorbereitung
ust-voranmeldungworkflow— (DE-spezifisch)KZ-Mapping nach BMF-Vordruckmuster USt 1 A, ELSTER-fähige Aufstellung
lohnabrechnungworkflow— (DE-spezifisch)Brutto-Netto, SV, LSt, bAV §3 Nr.63, Minijob/Midijob, Verbuchung
jahresabschlussworkflowclose-management + financial-statementsHGB-Aufstellung (Bilanz §266, GuV §275, Anhang §284-288)
ebilanzworkflowfinancial-statements (sinngemäß)Datenpaket-Vorbereitung für ERiC/DATEV (kein Direktversand)
abstimmungworkflowreconciliationBank, Kasse, OP-Debitoren/-Kreditoren, USt, Intercompany, EWB/PWB
abweichungsanalyseworkflowvariance-analysisPlan-Ist-Decomposition (Preis/Menge/Mix), Forecast — Tiefenanalyse einer Position
bwa-kommentierungworkflowfinancial-statements (Kommentierungs-Teil)BWA-/GuV-Kommentierung aus DATEV-BWA: kanonische GuV-Tabelle, Materialitäts-Flagging, Folgefragen (delegiert Tiefe an abweichungsanalyse)
gobd-konformitaetknowledge— (DE-spezifisch)BMF-GoBD 28.11.2019: Festschreibung, Z1/Z2/Z3, Verfahrensdokumentation
iks-pruefungmethodologysox-testing + audit-supportIKS nach IDW PS 261 / 5 COSO-Komponenten (ersetzt SOX in DE)
hinschg-meldewesenknowledge— (DE-spezifisch)HinSchG-Pflichten ab 50 MA, Meldestelle, Fristen, Bußgeldrahmen
datev-exportworkflow— (DACH-spezifisch)DATEV-Buchungsstapel-CSV (EXTF-Format) — deterministisch (SHA-256, GoBD), DATEV-Prüfprogramm-validiert, mit Automatikkonten-Schutz + Wiederkehrende Buchungen + KOST-Splitt; konsumiert den JSON-Handoff aus buchungssatz
wiederkehrende-buchungenworkflow— (DACH-spezifisch)Wiederkehrende DATEV-Buchungen (Format Kategorie 65, Version 4): Serien-Definition statt Copy-Paste (Miete, Beitragsüberträge, Bestandsprovisionen)
steuerberater-handoffworkflow— (DACH-spezifisch)Strukturiertes Übergabe-Paket (Sachverhalt + Vorschlag + § + Belege)

Slash-Commands (16)

Jeder Skill hat einen gleichnamigen Slash-Command zum direkten Aufruf:

/buchung-grundlagen · /buchungssatz · /monatsabschluss · /ust-voranmeldung · /lohnabrechnung · /jahresabschluss · /ebilanz · /abstimmung · /abweichungsanalyse · /bwa-kommentierung · /gobd-konformitaet · /iks-pruefung · /hinschg-meldewesen · /datev-export · /wiederkehrende-buchungen · /steuerberater-handoff


Beispiel-Workflows

Monatsabschluss April

/monatsabschluss
  → Saldenliste 04/2026 hochladen
  → Bank-Auszüge aller Konten (PDF/CSV)
  → OP-Listen Debitoren + Kreditoren

Plugin liefert:
  - Closing-Checkliste (was ist OK, was ist offen)
  - Vorgeschlagene Nachbuchungen (Abgrenzungen, RST-Anpassungen)
  - BWA-Kommentar

Anschluss:
/ust-voranmeldung 04/2026   → KZ-Aufstellung + Zahllast/Erstattung
/datev-export               → Buchungsstapel-CSV der Vorschläge
/steuerberater-handoff      → Übergabe-Brief an StB

Einzel-Buchungssatz mit § 13b

/buchungssatz
  → "Rechnung Acme Cloud Ltd. (IE), 1.500 € netto, SaaS Mai 2026"

Plugin erkennt § 13b Abs. 1 UStG, baut Buchung mit
SKR04 6840/3837/1407/3300, schlägt KZ 46/47/67 in USt-VA vor,
begründet mit §-Verweis.

Jahresabschluss-Vorbereitung

/jahresabschluss
  → Saldenliste GJ vor Umbuchungen
  → Inventur-Liste
  → Anlagengitter
  → AfA-Lauf-Ergebnis

Plugin liefert:
  - Größenklasse-Bestimmung (§ 267 HGB)
  - Bilanz § 266 + GuV § 275 (Markdown + Excel)
  - Anhang-Gerüst (§§ 284-288)
  - Steuerrückstellungs-Berechnung (KSt + GewSt + Solz)

/ebilanz   → Datenpaket-Vorbereitung
/steuerberater-handoff   → Übergabe an StB für ELSTER/Bundesanzeiger

IKS-Selbstbewertung vor Prüfung

/iks-pruefung
  → Prozess-Beschreibungen, Berechtigungskonzept, bestehende Kontrollen

Plugin liefert:
  - Reife-Score je COSO-Komponente
  - Lücken-Liste mit Priorität
  - Maßnahmen-Backlog mit Frist + Verantwortlichem

Wo kommen die Daten her?

Anthropic's Pendant verbindet sich via MCP an ERP / Data-Warehouse / BI-Tools. Bei uns sind MCP-Integrationen Stand v2.0.0 noch geplant (siehe .mcp.json). Bis dahin liefert der Anwender die Daten manuell — Claude kann sie aus mehreren Formaten lesen:

Daten-TypQuelleFormatWie übergeben
BelegeEingangs-/Ausgangs-RechnungenPDF, Foto (JPG/PNG), oder Text-PasteDirekt in die Konversation hochladen oder einfügen
SaldenlisteDATEV Unternehmen online / DATEV Rechnungswesen / LexwareExcel-Export (XLSX), CSV, PDFHochladen
BankauszügeOnline-BankingPDF, CSV, MT940Hochladen
OP-ListenDATEV-OPOS-Auswertung / LexwareExcel, CSV, PDFHochladen
LohnjournalDATEV LODAS / DATEV Lohn und Gehalt / Lexware Lohn / PersonioExcel, CSV, PDFHochladen
AnlagengitterDATEV AnlagenverwaltungExcel, PDFHochladen
Plan/BudgetExcel-Planung internExcel, CSV, Text-TabelleHochladen oder einfügen
MA-StammdatenHR-SystemCSV / strukturierte ListeEinfügen oder Skill-Frage beantworten
VertragsdatenVerträge (Miete, Versicherung, bAV, GF-Anstellungsvertrag)PDF, TextHochladen + kurze Zusammenfassung des Sachverhalts

Praxis-Tipp: Daten lokal halten — Cowork läuft auf deinem Rechner. Keine Cloud-Synchronisation der Belege ohne ausdrückliche Freigabe; DSGVO-Pflichten bleiben beim Anwender.

Geplante MCP-Integrationen (in .mcp.json als evaluating):

  • datev_finrobotics (Read-only EXTF-Import aus DATEV-Exporten)
  • datev_badrix (Read + Write inkl. EXTF-Export für DATEV-Import)
  • bank_hbci (HBCI/FinTS Bank-API)
  • elster (XML-Vorbereitung — kein Direktversand)

Vergleich: germany-accounting (DE/HGB) vs. Anthropic Finance Plugin (US/GAAP)

Architektur: identisch — Knowledge/Workflow-Trennung, source-fidelity-Disziplin, Markdown + CSV + Excel als Output. Inhalt: portiert auf DE-Rechtslage. Wo US-spezifisch (z.B. SOX), durch das deutsche Äquivalent (IDW PS 261) ersetzt. Plus DACH-spezifische Skills (USt-VA, Lohn, GoBD, DATEV-Export, StB-Handoff).

Skills

Anthropic Finance (US-GAAP)germany-accounting (HGB)Status
journal-entry-prepbuchung-grundlagen (Knowledge)übernommen
journal-entrybuchungssatz (Workflow)übernommen + DE-USt-Tatbestände + SKR03/04
reconciliationabstimmungübernommen + EWB/PWB-Logik nach HGB
financial-statementsjahresabschluss + ebilanz + bwa-kommentierungaufgeteilt: HGB-Aufstellung (Bilanz/GuV) + eBilanz-Datenpaket + BWA-/GuV-Kommentierung
variance-analysisabweichungsanalyseübernommen, gleiche Methodik
close-managementmonatsabschluss + jahresabschlussaufgeteilt nach Periode
sox-testingiks-pruefungSOX 404 ersetzt durch IDW PS 261 / COSO
audit-supportteilweise in iks-pruefung, gobd-konformitaetaufgeteilt
—ust-voranmeldungDE-neu — keine US-Entsprechung (Bund-Sales-Tax dezentral)
—lohnabrechnungDE-neu — US-Payroll grundsätzlich anders
—gobd-konformitaetDE-neu — BMF-spezifisches Verwaltungsrecht
—hinschg-meldewesenDE-neu — EU-Whistleblower-Richtlinie + HinSchG
—datev-exportDACH-neu — DATEV-EXTF-Standard
—wiederkehrende-buchungenDACH-neu — DATEV wiederkehrende Buchungen (Format Kategorie 65)
—steuerberater-handoffDACH-neu — StB-System hat keine US-Entsprechung

Slash-Commands

Anthropicgermany-accountingHinweis
/journal-entry/buchungssatzOutput formatär identisch (Soll/Haben + §)
/reconciliation/abstimmungOutput formatär identisch
/income-statement(im /jahresabschluss-Output enthalten)GuV ist Teil der Bilanz/GuV-Aufstellung
/variance-analysis/abweichungsanalyseIdentische Decomposition-Logik
/sox-testing/iks-pruefungIDW-PS-261-Framework statt SOX-Walkthroughs
(financial-statements)/bwa-kommentierungBWA-/GuV-Kommentierung auf DATEV-BWA-Basis
—10 weitere DE-Commandssiehe Skills-Tabelle oben

Geltungsbereich

  • In Scope: GmbH, UG (haftungsbeschränkt)
  • Out of Scope (architektonisch erweiterbar): AG, KGaA, GmbH & Co. KG, OHG, KG, eGbR/GbR, Einzelunternehmen, Vereine, Stiftungen

Details: config/shared/entity-types.json, docs/SCOPE.md.

Mehrjahres-Config

config/{year}/ enthält jahres-spezifische Werte (Sätze, BBG, Mindestlohn, Kontenrahmen-Wording, Fristen, USt-VA-KZ-Codes). Aktuell verifiziert: 2025 + 2026. Stub: 2027. Pointer in config/active-year.json.

Output-Formate

  • Markdown — Buchungsvorschläge, Begründungen, Quellen-Verweise (Default)
  • DATEV-Buchungsstapel-CSV (EXTF) — importfähig in DATEV-Software
  • Excel-Tabellen — Abstimmungen, Analysen, Bilanz/GuV
  • Steuerberater-Handoff-Brief — strukturiert für StB-Übergabe

Nicht enthalten: direkter ELSTER-Versand, Bundesanzeiger-Offenlegung, eBilanz-XBRL-Übermittlung — bleibt bei Anwender / StB.

Quellen

docs/SOURCES.md — alle Primärquellen (HGB/EStG/UStG/etc. auf gesetze-im-internet.de, DATEV-PDFs, BMF-Schreiben, SGB, IDW).

Lizenz

Apache License 2.0 — siehe LICENSE. Lineage-Hinweis im LICENSE-Footer, vollständige Provenienz in docs/PROVENANCE.md.

Beiträge

CONTRIBUTING.md. Insbesondere willkommen: Verifikation gegen aktuelle Rechtslage, Erweiterungen für weitere Rechtsformen, MCP-Server-Anbindung an DATEV.

Verwandte Projekte

Ver o original no GitHub

Bom para

Relacionados