Reports
9 tools in this toolset, each with its tier, traits, description and arguments.
sevdesk_cash_position
Cash position
Liquidität: balance (Kontostand) of every payment account (Zahlungskonto) on asOf as sevDesk computes it, with totals per currency. With outlookDays it adds an expected view from today to asOf + N days: receivables (Forderungen) and payables (Verbindlichkeiten) due by due date (Zahlungsziel/Fälligkeit), expected net and projected balance, labelled expected, not booked; overdue items are shown apart, and asOf must then be today or later. Prefer it over combining sevdesk_bank_accounts_list with invoice and voucher lists. Computed by this server from sevDesk records, not a sevDesk report.
asOfoptionalstring- Day of the balances (Stichtag), YYYY-MM-DD; default today (Berlin). With outlookDays it must be today or later (sevDesk only knows today's open items).
outlookDaysoptionalinteger- Add the expected in- and outflows due within this many days after asOf.
includeArchivedoptionalboolean- Also list archived accounts (archiviert). Default: false.
sevdesk_changed_since
Changes since
What changed in sevDesk since a point in time (sevDesk has no webhooks): contacts, invoices (Rechnungen), credit notes (Gutschriften), orders (Angebote/Aufträge), vouchers (Belege) and bank transactions (Umsätze) last updated at or after since, as compact rows (id, type, number/name, status, update time, link) with per-subject counts. Use it to sync or review recent changes instead of paging every list; details via the get tools. Up to limit rows per subject; to page on, pass one subject with offset = nextOffset. Credit notes and transactions have no sevDesk change filter and are checked here (up to 5,000 rows per call). Deleted records do not appear.
sincerequiredstring- Start: YYYY-MM-DD (00:00 Berlin) or an ISO 8601 date-time, e.g. 2026-11-01T08:00:00+01:00 (Berlin time without an offset).
subjectsoptionalcontacts |invoices | credit_notes | orders | vouchers | transactions[] - Which records to check; default all. Default: ["contacts","invoices","credit_notes","orders","vouchers","transactions"].
limitoptionalinteger- Changed records to return per subject, 1–100. Default: 20.
offsetoptionalinteger- sevDesk rows to skip (a previous nextOffset); only with exactly one subject. Default: 0.
sevdesk_csv_export
CSV export to a file
CSV-Export from sevDesk: invoices (Rechnungen), credit_notes (Gutschriften), vouchers (Belege), transactions (Kontoumsätze) or contacts (Kontakte), saved as a new file in SEVDESK_OUTPUT_DIR (on a remote server: a download link for the user) exactly as sevDesk sends it (UTF-8 with BOM, ';' separated, German headers), e.g. for Excel or the tax adviser. from/to filter by date in sevDesk (not for contacts); the file's date column is checked as well (periodCheck); at most 1000 rows per file (mayBeTruncated says when more may exist). Returns the path or link, size and row count, never the content; nothing changes in sevDesk. Every call creates another file. For totals use sevdesk_records_summarize instead.
subjectrequiredinvoices |credit_notes | vouchers | transactions | contacts - invoices, credit_notes, vouchers, transactions or contacts.
fromoptionalstring- First day to include, YYYY-MM-DD (Berlin time).
tooptionalstring- Last day to include, YYYY-MM-DD (Berlin time).
limitoptionalinteger- Most rows, 1–1000. Default: 1000.
sevdesk_datev_export
DATEV export to a ZIP file
DATEV-Export: let sevDesk build the DATEV booking data (Buchungsstapel, CSV in a ZIP) for a month, quarter, year or date range and save the ZIP as a new file in SEVDESK_OUTPUT_DIR (on a remote server: a download link for the user), e.g. for the tax adviser (Steuerberater). scope picks earnings, expenditure, transactions, cash register and assets (default all); exportByPaydate keeps only documents paid in the period; includeDocumentImages adds the receipts (larger). Write tier: it starts an export job in sevDesk, which may mark the documents as exported; it never enshrines (festschreiben). Needs the DATEV settings in sevDesk (Beraternummer, Mandantennummer, Wirtschaftsjahresbeginn); refused with guidance when they are missing. dryRun previews. The download link is never shown. Takes up to a few minutes.
yearoptionalinteger- Calendar year; alone for the whole year, or with month or quarter.
monthoptionalinteger- Month 1–12 (with year).
quarteroptionalinteger- Quarter 1–4 (with year).
fromoptionalstring- First day, YYYY-MM-DD (instead of year).
tooptionalstring- Last day, YYYY-MM-DD (instead of year).
scopeoptionalearnings |expenditure | transactions | cash_register | assets[] - What to include: earnings (Einnahmen), expenditure (Ausgaben), transactions (Kontoumsätze), cash_register (Kasse), assets (Anlagen). Default all. Default: ["earnings","expenditure","transactions","cash_register","assets"].
exportByPaydateoptionalboolean- Only paid documents whose pay date lies in the period (Zahlungsdatum).
includeDocumentImagesoptionalboolean- Add the document images (Belegbilder) to the ZIP; makes it much larger. Default: false.
dryRunoptionalboolean- Preview only: check the action and return exactly what it would do, without changing anything in sevDesk and without asking the user. Defaults to false.
sevdesk_payables_aging
Payables aging
Verbindlichkeiten / offene Posten: today's open and partially paid expense vouchers (Belege, Ausgaben) by days past their payment deadline (Fälligkeit) on asOf (Stichtag, today or later): not due, 1–30, 31–60, 61–90, over 90 days, each with count and outstanding = gross − paid per currency, plus the top suppliers (Lieferanten). Use it to plan payments; sevdesk_vouchers_list shows the single vouchers. Transferred vouchers (Überwiesen) count as paid, recurring templates (RV) are left out; amounts without a usable paid figure are marked approximate or unknown. Computed by this server from sevDesk records, not a sevDesk report.
asOfoptionalstring- Reference day (Stichtag), YYYY-MM-DD, today or later; default today (Berlin). sevDesk only knows today's open items, so a past day is refused; a later day ages today's open items as of that day.
topoptionalinteger- How many of the largest parties to list per currency. Default: 10.
sevdesk_profit_and_loss
Profit and loss (EÜR-style)
Einnahmenüberschussrechnung (EÜR)-style profit and loss for a month, quarter or year: net income by tax rule (Steuerregel), net expenses by booking account (Buchungskonto, number and name), the result, and VAT flows apart (Umsatzsteuer collected, Vorsteuer paid, VAT paid to or refunded by the Finanzamt). Fixed assets (Anlagegüter) are listed apart, without depreciation (AfA). basis: cash (default, Zufluss-/Abflussprinzip: payments sevDesk links to documents, by value date) or accrual (by document date). Positions are read one by one (up to 1,500 documents). Call it directly with the period: it reads the accounts and payments itself. Computed here from sevDesk data: not the Anlage EÜR (which works gross) and not a tax return.
yearoptionalinteger- Calendar year; alone for the whole year, or with month or quarter.
monthoptionalinteger- Month 1–12 (with year).
quarteroptionalinteger- Quarter 1–4 (with year).
fromoptionalstring- First day, YYYY-MM-DD (instead of year).
tooptionalstring- Last day, YYYY-MM-DD (instead of year).
basisoptionalcash |accrual - cash (by payment day, default) or accrual (by document date). Default: "cash".
sevdesk_receivables_aging
Receivables aging
Offene Posten / Forderungen: today's open and partially paid invoices by days overdue on asOf (Stichtag, today or later; due date = invoice date + Zahlungsziel): not due, 1–30, 31–60, 61–90, over 90 days, each with count and outstanding = gross − paid per currency, plus the top debtors. Use it for dunning (Mahnwesen) or 'who owes us what'; sevdesk_invoices_list with overdueOnly shows the single invoices. Amounts without a usable paid figure are marked approximate or unknown; SR, WKR templates and MA reminders are left out, negative invoices listed apart. Computed by this server from sevDesk records, not a sevDesk report.
asOfoptionalstring- Reference day (Stichtag), YYYY-MM-DD, today or later; default today (Berlin). sevDesk only knows today's open items, so a past day is refused; a later day ages today's open items as of that day.
topoptionalinteger- How many of the largest parties to list per currency. Default: 10.
sevdesk_records_summarize
Summarize sevDesk records
Auswertung: counts and exact sums of invoices (Rechnungen), credit notes (Gutschriften), vouchers (Belege) or bank transactions (Umsätze): net/tax/gross per currency (incoming/outgoing for transactions), optionally grouped by month, quarter, status, contact (Kunde/Lieferant) or account. Prefer it over paging list tools for totals such as revenue per month (Umsatz), expenses per supplier or amounts per status. Filters: from/to, status, contactId, kind (vouchers: expense/revenue), invoiceType, checkAccountId (transactions). Templates (recurring RV/WKR) and reminders (MA) are left out unless invoiceType asks for them. Reads up to 10,000 rows; truncated says if more existed. Computed by this server from sevDesk records, not a sevDesk report.
subjectrequiredinvoices |credit_notes | vouchers | transactions - invoices, credit_notes, vouchers or transactions (bank transactions).
groupByoptionalnone |month | quarter | status | contact | account - none, month, quarter, status, contact (customer/supplier; not for transactions) or account (transactions only). Default: "none".
fromoptionalstring- First day to include, YYYY-MM-DD (Berlin time).
tooptionalstring- Last day to include, YYYY-MM-DD (Berlin time).
statusoptionaldraft |open | partially_paid | paid | transferred | created | linked | private | auto_booked | booked - Invoices/credit notes: draft, open, partially_paid, paid. Vouchers: draft, open, transferred, partially_paid, paid. Transactions: created, linked, private, auto_booked, booked.
contactIdoptionalinteger- Customer (invoices, credit notes) or supplier (vouchers) contact id.
kindoptionalexpense |revenue - Vouchers only: expense (Ausgabe) or revenue (Einnahme).
invoiceTypeoptionalinvoice |advance | partial | final | cancellation | reminder | recurring - Invoices only: invoice (RE), advance (AR), partial (TR), final (ER), cancellation (SR), reminder (MA) or recurring (WKR template); reminders and templates count only when asked for here.
checkAccountIdoptionalinteger- Transactions only: payment account (Zahlungskonto) id.
maxGroupsoptionalinteger- Most groups to return; the rest are counted in groupsOmitted. Default: 50.
sevdesk_vat_summary
VAT return estimate (UStVA)
Umsatzsteuer-Voranmeldung (UStVA) estimate for a month, quarter or year: the form lines (Kennzahlen, 2026 form) with base and tax, e.g. Kz 81/86 domestic sales, 41 intra-EU supplies, 43 exports, 46/47 and 84/85 reverse charge (§13b), 89/93 acquisitions, 66/61/67 input VAT (Vorsteuer), plus the Kz 83 estimate, the Zusammenfassende Meldung (ZM) per buyer VAT id, OSS sales per country, and amounts it cannot place. Computed here from invoices, credit notes and vouchers (positions read one by one, up to 1,500 documents; slow for long periods). basis: accrual (Soll, default; sevDesk's API does not expose the account setting) or cash (Ist, from reconciled payments). It reads the account's tax regime itself (no need for sevdesk_account_info first); Kleinunternehmer accounts get no UStVA. An estimate to check, not a filing: submit via ELSTER.
yearoptionalinteger- Calendar year; alone for the whole year, or with month or quarter.
monthoptionalinteger- Month 1–12 (with year).
quarteroptionalinteger- Quarter 1–4 (with year).
fromoptionalstring- First day, YYYY-MM-DD (instead of year).
tooptionalstring- Last day, YYYY-MM-DD (instead of year).
basisoptionalaccrual |cash - accrual (Sollversteuerung, default) or cash (Istversteuerung).