Skip to content

Banking

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

sevdesk_bank_accounts_list 

List sevDesk bank accounts

Readread-onlyidempotent

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

Readread-onlyidempotent

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

Commitchanges statedestructivesupports dryRunasks the user to confirm

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

Readread-onlyidempotent

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

Commitchanges statedestructivesupports dryRunasks the user to confirm

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

Commitchanges statedestructivesupports dryRunasks the user to confirm

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

Readread-onlyidempotent

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.