Kontenblatt abrufen
bb_reports_get_ledgerRetrieve a ledger sheet for a posting account within a date range, including postings and running balance. No generation step required, so it works even in read-only mode.
Instructions
Liefert das Kontenblatt eines Sachkontos aus BuchhaltungsButler für einen Zeitraum, also dessen Buchungen mit laufendem Saldo. Anders als bb_reports_get_bwa und bb_reports_get_sums braucht es keinen Erzeugungsschritt und bleibt auch bei aktivem BB_MCP_READ_ONLY nutzbar. Weder limit noch offset: Ein stark bebuchtes Konto liefert alles auf einmal, lange Zeiträume also in Monatsfenster zerlegen. Ein leeres Kontenblatt ist kein Fehler, sondern ein Konto ohne Buchung.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"postingaccount_number": "<postingaccount_number>",
"date_from": "<date_from>",
"date_to": "<date_to>"
},
"name": "bb_reports_get_ledger"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| base | No | Datum der Periodenzuordnung: 'date' Buchungsdatum, 'date_delivery_else_date' Leistungsdatum und ersatzweise Buchungsdatum. Ohne Angabe 'date'. Mit dem zweiten Wert können Buchungen außerhalb des Rechnungsdatums erscheinen; nicht verifiziert. | |
| date_to | Yes | Letzter Tag des Zeitraums als YYYY-MM-DD, zum Beispiel 2026-03-31. Ein leerer String wird abgelehnt; das Feld stattdessen weglassen. Der Zeitraum schließt diesen Tag ein. | |
| date_from | Yes | Erster Tag des Zeitraums als YYYY-MM-DD, zum Beispiel 2026-01-01. Ein leerer String wird abgelehnt; das Feld stattdessen weglassen. Der Zeitraum schließt diesen Tag ein. | |
| response_format | No | 'concise' liefert nur die Felder, die einen Datensatz erkennbar machen und den nächsten Schritt erlauben. 'detailed' liefert den Datensatz so, wie die BuchhaltungsButler-API ihn ausgibt. Mit 'concise' beginnen und nur für die wenigen Datensätze auf 'detailed' wechseln, die wirklich geprüft werden müssen. Dieses Feld ist serverseitig und geht nicht an die API. | concise |
| postingaccount_number | Yes | Nummer des Sachkontos, dessen Kontenblatt geliefert wird, zum Beispiel 4920, als ganze Zahl ohne Anführungszeichen. Nachschlagen mit bb_postingaccounts_search. Zu einem Konto, das es nicht gibt, antwortet die API mit error_code 16. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | ||
| message | No | ||
| success | Yes | ||
| summary | No | ||
| endpoint | No | ||
| rows_returned | No | ||
| _contract_warnings | No |