Zum Inhalt springen

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

Lesenread-onlyidempotent

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

Lesenread-onlyidempotent

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

Buchenchanges statedestructivesupports dryRunasks the user to confirm

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

Lesenread-onlyidempotent

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

Buchenchanges statedestructivesupports dryRunasks the user to confirm

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

Buchenchanges statedestructivesupports dryRunasks the user to confirm

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

Lesenread-onlyidempotent

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.