sevdesk-bookkeeping

sevDesk bookkeeping workflows

Procedural knowledge for driving the sevdesk-mcp server well. The server's own guardrails (drafts-only writes, read-only mode, dryRun) hold regardless of this skill — this file is about doing the work in the right order with few tokens, not about safety.

Orientation (once per session)

1. sevdesk_ping — verifies the token and returns two facts that change how you should work:
   • mode: READ-ONLY / DRY-RUN / read-write.
   • bookkeepingSystemVersion: 1.0 books with taxType, 2.0 with taxRule. Old documents may carry either; the tools decode both.
2. The server never guesses a tax rule: sevdesk_create_invoice and sevdesk_create_voucher require taxRuleId. Ask the user which treatment applies (regular VAT, §19 UStG, reverse charge…), and for vouchers read the allowed rules from sevdesk_receipt_guidance.

Monthly close

Run in this order; each step's output feeds the next conversation turn:

1. sevdesk_find_duplicates for the month — resolve duplicates first, they distort every later number.
2. sevdesk_audit_vat with from/to for the month. Work findings by severity.
3. sevdesk_reverse_charge_report for the month — give the user the §13b bases for the VAT return (deductible nets to zero but must be declared; rule 13 VAT is actually payable).
4. sevdesk_diff_receipt_folder if a receipt directory is allowlisted — unbooked receipts and unmatched bookings.
5. sevdesk_invoice_aging — open receivables, never-sent drafts.
6. sevdesk_subscription_gaps — expected recurring costs that are missing (a missing AWS invoice surfaces here, not in the audits).

Receipt triage (new expense documents)

1. sevdesk_receipt_guidance for the expense type — it returns the booking accounts and tax rules the account's own configuration allows.
2. sevdesk_upload_voucher_file then sevdesk_create_voucher with dryRun: true first; show the user the preview, then repeat without dryRun once confirmed.
3. Foreign supplier without VAT? Do the §13b check below before booking.