Skip to content

Reports

9 tools in this toolset, each with its tier, traits, description and arguments.

sevdesk_cash_position 

Cash position

Readread-onlyidempotent

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

Readread-onlyidempotent

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

Readchanges state

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

Draftchanges statesupports dryRun

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

Readread-onlyidempotent

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)

Readread-onlyidempotent

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

Readread-onlyidempotent

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

Readread-onlyidempotent

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)

Readread-onlyidempotent

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).