Banking
7 tools in this toolset, each with its tier, traits, description and arguments.
sevdesk_bank_accounts_list
List sevDesk bank accounts
List the payment accounts (Zahlungskonten): bank accounts (Bankkonten), clearing accounts (Verrechnungskonten) and cash registers (Kasse), each with its balance (Saldo) at a day, today in Berlin by default. The balance is sevDesk's sum of the transactions it knows, not necessarily the bank's figure. IBANs show only their last four characters. Balances are fetched for at most 25 accounts per call. Use an account id with sevdesk_transactions_list to see its transactions (Umsätze).
asOfoptionalstring- Balance at the end of this day, YYYY-MM-DD; default today (Berlin).
includeArchivedoptionalboolean- Also list archived (archiviert) accounts. Default: false.
sevdesk_reconcile_suggest
Suggest matches for sevDesk bank transactions
Bank reconciliation (Kontoabgleich, Zuordnung): for unassigned bank transactions (Kontoumsätze, status created, or partly linked with a rest), rank the open invoices (Rechnungen), credit notes (Gutschriften) and vouchers (Belege, by Belegnummer) they most likely pay: exact open amount, document number in the purpose (Verwendungszweck), counterparty name, date; plus split suggestions (several documents adding up exactly). Each match has reasons, a confidence and the exact sevdesk_transaction_book call; book only after the user agrees. Call it directly: without arguments it scans the unassigned transactions of every bank account; pass transactionId, or checkAccountId and/or a value-date range to narrow it (page with offset). Imported bank accounts only: offline and cash accounts get their transactions from bookings. Read-only.
transactionIdoptionalinteger- One transaction (Umsatz) id; leave out to scan unassigned ones.
checkAccountIdoptionalinteger- Payment account (Zahlungskonto) id, from
sevdesk_bank_accounts_list. fromoptionalstring- First day to include, YYYY-MM-DD (Berlin time).
tooptionalstring- Last day to include, YYYY-MM-DD (Berlin time).
limitoptionalinteger- Transactions per call (default 10, at most 25). Default: 10.
offsetoptionalinteger- sevDesk transaction rows to skip: pass nextOffset from the previous call. Default: 0.
maxMatchesoptionalinteger- Most matches per transaction (default 3). Default: 3.
sevdesk_transaction_book
Book a sevDesk bank transaction to documents
Book (zuordnen) a bank transaction (Kontoumsatz) to documents: invoices (Rechnungen, money in), credit notes (Gutschriften, money out) or vouchers (Belege, by direction). Each allocation books a payment linked to the transaction; amount defaults to the smaller of the open amount and what is left. Up to 10 documents per call (split, e.g. one transfer for several invoices); a partly linked transaction (status 200) is bookable up to its rest. Guards: at most the unassigned amount in total, each at most the document's open amount unless paymentType says otherwise (cash_discount/Skonto, bank_fees, other_difference, reminder_charges: only when one document takes the whole transaction), same direction and currency. Candidates: sevdesk_reconcile_suggest. Commit tier: asks a human to confirm the preview; dryRun only previews. Undo: sevdesk_transaction_reset.
idrequiredinteger- Bank transaction (Umsatz) id, from
sevdesk_transactions_list. allocationsrequiredobject[]- Documents to book the transaction to, in this order.
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_transaction_get
Get a sevDesk bank transaction with its assignments
Show one bank transaction (Kontoumsatz) with its assignments (Zuordnungen): which invoices (Rechnungen), credit notes (Gutschriften) or vouchers (Belege) it was booked to, with how much, and the amount still unassigned (exact; from sevDesk's booking log). Use it before sevdesk_transaction_book (partly linked transactions, status 200, can be booked up to the remaining amount) and before sevdesk_transaction_reset (to see what would be undone). Find ids with sevdesk_transactions_list. Offline and cash accounts get their transactions from payment bookings, so they are booked already. Read-only.
idrequiredinteger- Bank transaction (Umsatz) id, from
sevdesk_transactions_list.
sevdesk_transaction_mark_private
Mark a sevDesk bank transaction as private
Mark an unbooked bank transaction (Kontoumsatz, status created) as private: outgoing money becomes a Privatentnahme (owner's withdrawal), incoming a Privateinlage (owner's deposit); it then counts as neither business expense nor income and is not matched to documents. Only for sole proprietors and partnerships (Einzelunternehmen, GbR); a GmbH or UG has no private withdrawals (book a shareholder loan or distribution instead). Commit tier: asks a human to confirm the preview; dryRun only previews. Undo: sevdesk_transaction_reset. Find transactions with sevdesk_transactions_list.
idrequiredinteger- Bank transaction (Umsatz) id, from
sevdesk_transactions_list. 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_transaction_reset
Undo the bookings of a sevDesk bank transaction
Undo a bank transaction's bookings (Zuordnung aufheben). A private transaction (Privatentnahme/-einlage) becomes unbooked again. A linked or booked one: every document it paid (Rechnung, Gutschrift, Beleg) is reset to open, because sevDesk cannot unlink a single transaction; that removes ALL payments of those documents, also other transactions' and cash bookings, which the preview lists. Refuses enshrined (festgeschrieben) transactions and documents. Check first with sevdesk_transaction_get. Commit tier: asks a human to confirm the preview; dryRun only previews. Afterwards book again with sevdesk_transaction_book.
idrequiredinteger- Bank transaction (Umsatz) id, from
sevdesk_transactions_list. 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_transactions_list
List sevDesk bank transactions
List bank transactions (Umsätze) of the payment accounts. Amounts are signed: positive = incoming, negative = outgoing (direction in/out). Filter by account id, date range, direction and status: created (offen, not yet booked), linked (verknüpft), private, auto_booked, booked (gebucht). Unbooked = status created. Status, direction and value-date ranges are checked here while reading up to 5000 rows per call; dateField=entry lets sevDesk filter by entry date instead (faster). offset/nextOffset count sevDesk rows, not matches: pass nextOffset while hasMore is true. Account ids: sevdesk_bank_accounts_list. Use detail=summary to browse/find. Use sevdesk_transaction_get for assignments and the amount still unassigned.
detailoptionalsummary |full - Use summary to browse/find; full (default) or the matching get tool for details. Default: "full".
checkAccountIdoptionalinteger- Payment account (Zahlungskonto) id.
fromoptionalstring- First day to include, YYYY-MM-DD (Berlin time).
tooptionalstring- Last day to include, YYYY-MM-DD (Berlin time).
dateFieldoptionalvalue |entry - Date that from/to apply to: value (Wertstellung, default; filtered here) or entry (the second date, see entryDate; sevDesk filters it itself). Default: "value".
statusoptionalcreated |linked | private | auto_booked | booked[] - Statuses to include, e.g. ['created'] for unbooked transactions.
directionoptionalin |out - in = incoming (positive), out = outgoing (negative).
limitoptionalinteger- Page size, 1–100. Default: 25.
offsetoptionalinteger- Rows to skip, for paging: pass the previous result's nextOffset. Default: 0.