buchhaltungsbutler
BuchhaltungsButler + Buchhaltung
Two jobs: (1) drive the user's BuchhaltungsButler (BB) account through API v1 with scripts/bb.sh; (2) decide how something is booked under German rules. Default assumption: the client is a UG (haftungsbeschränkt) — double-entry books, Bilanz, Körperschaftsteuer, no private accounts, no EÜR. Ask if the user mentions Einzelunternehmen, Freiberufler, EÜR or Privatentnahme, or if --check shows a chart other than SKR03/SKR04 (Kasse 1220/Bank 1260 = SKR45, Kasse 0920/Bank 0945 = SKR49).
Read on demand, not up front:
| Need | File |
|---|---|
Exact endpoint parameters, all 23 vat codes, error codes, batch item shapes, call sequences |
references/api.md |
| How BB models Belege / Zahlungen / Buchungen, Festschreibung, Steuerschlüssel (BU/GU), Kontenrahmen, Deb/Kred mode, month-end, exports | references/buchhaltungsbutler-konzepte.md |
| German law and practice (verified 2026-09): USt, §13b, E-Rechnung, Fristen, SKR03↔SKR04 table, 36-case Kontierung cheat sheet, red flags | references/buchhaltung-de.md |
1. Credentials and setup
Credentials (API Client, API Secret, API Key) live in the user's Bitwarden vault, item "BuchhaltungsButler API" (login username = client, password = secret, hidden field api_key). bb.sh fetches them per call with the Bitwarden CLI; nothing is cached on disk.