Bank
7 Werkzeuge in dieser Gruppe, jedes mit Stufe, Eigenschaften, Beschreibung und Argumenten.
Die Beschreibung für das Modell und die Argumente stehen auf Englisch, so wie das Modell sie liest.
sevdesk_bank_accounts_list
Bankkonten auflisten
Listet Bankkonten, Verrechnungskonten und Kassen mit ihrem Saldo.
Für das Modell, auf Englisch
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
Zuordnungen für Umsätze vorschlagen
Schlägt für offene Kontoumsätze die Rechnungen, Gutschriften und Belege vor, die sie wahrscheinlich bezahlen.
Für das Modell, auf Englisch
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
Umsatz Dokumenten zuordnen
Ordnet einen Kontoumsatz einer oder mehreren Rechnungen, Gutschriften oder Belegen zu und bucht die Zahlungen.
Für das Modell, auf Englisch
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.
iderforderlichinteger- Bank transaction (Umsatz) id, from
sevdesk_transactions_list. allocationserforderlichobject[]- 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
Umsatz mit Zuordnungen abrufen
Zeigt einen Kontoumsatz mit seinen Zuordnungen und dem Betrag, der noch offen ist.
Für das Modell, auf Englisch
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.
iderforderlichinteger- Bank transaction (Umsatz) id, from
sevdesk_transactions_list.
sevdesk_transaction_mark_private
Umsatz als privat markieren
Bucht einen Kontoumsatz als Privatentnahme oder Privateinlage. Nur für Einzelunternehmen und GbR.
Für das Modell, auf Englisch
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.
iderforderlichinteger- 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
Zuordnung eines Umsatzes aufheben
Hebt die Zuordnung eines Kontoumsatzes auf. Die Vorschau zeigt, welche Zahlungen dabei wegfallen.
Für das Modell, auf Englisch
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.
iderforderlichinteger- 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
Kontoumsätze auflisten
Listet Kontoumsätze, gefiltert nach Konto, Zeitraum, Richtung und Status.
Für das Modell, auf Englisch
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.