Stammdaten durchsuchen
bb_masterdata_searchSearch payment accounts, posting accounts, debtors, creditors, and cost locations by name or number without knowing the list. Omit query for a master-data overview at session start.
Instructions
Findet ein Zahlungskonto, ein Sachkonto, einen Debitor, einen Kreditor oder eine Kostenstelle über den Namen oder die Nummer, ohne dass man vorher wissen muss, in welcher Liste der Eintrag geführt wird. Ohne query kommt stattdessen der Arbeitskontext für den Sitzungsanfang: Zahlungskonten und Kostenstellen als Liste, der Kontenrahmen als Zusammenfassung. Ersetzt für die Frage nach einer Nummer bb_payment_accounts_list, bb_cost_locations_search, bb_postingaccounts_search, bb_debtors_search und bb_creditors_search; Adresse und Bankverbindung liefern weiterhin nur diese Einzelwerkzeuge. Die Einzelkonten des Kontenrahmens kommen nie vollständig mit, er wiegt grob 60.000 Token. Höchstens 5 Aufrufe an die API; die Antwort sagt in bundle.complete, wenn dabei etwas offen geblieben ist.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| areas | No | Bereiche, in denen gesucht wird; ohne Angabe alle fünf. payment_accounts sind die Zahlungskonten (Kassen, Bank- und Kreditkartenkonten), posting_accounts die Sachkonten des Kontenrahmens, debtors die Kundenkonten, creditors die Lieferantenkonten, cost_locations die Kostenstellen. posting_accounts, debtors und creditors stammen aus demselben Endpunkt und kosten gemeinsam nicht mehr als einer davon. | |
| query | No | Suchbegriff, 2 bis 100 Zeichen. Teilzeichenkette ohne Beachtung der Groß- und Kleinschreibung, geprüft gegen den Namen und gegen die Kontonummer beziehungsweise den code. Beispiel: PayPal, Müller GmbH, 1200. Ohne Angabe kommt der Überblick über die Stammdaten statt einer Trefferliste. | |
| max_hits | No | Höchstzahl der Treffer JE BEREICH, nicht insgesamt, 1 bis 100, Vorgabe 20. Der Wert wirkt serverseitig und geht nicht an die API; gesucht wird immer im vollständig gelesenen Bestand, gekappt wird erst die Ausgabe. | |
| 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 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| areas | No | ||
| notes | No | ||
| query | No | ||
| bundle | Yes | ||
| debtors | No | ||
| success | Yes | ||
| creditors | No | ||
| cost_locations | No | ||
| payment_accounts | No | ||
| posting_accounts | No |