klara_account_picker
ChatGPTKontenauswahl für Buchungszeilen, inklusive der links-Werte, die klara_prepare_booking für Kasse- und Bank-Konten braucht. Serverseitig zwischengespeichert – einmal pro Arbeitsschritt abrufen.
klara_account_statement
ChatGPTKontoauszug eines Kontos für eine Periode, wie in KLARA unter Buchhaltung > Berichte > Kontodetails: Eröffnungssaldo, alle Bewegungen, Schlusssaldo. Sortierung fest, älteste zuerst; blättern mit offset in Schritten von limit.
klara_accounting_config
ChatGPTBuchhaltungs-Einstellungen der aktuellen Firma lesen.
klara_accounting_tags
ChatGPTDie Tags, die auf Buchungszeilen der Firma vorkommen – Filterwerte für klara_search_bookings. Schreibweisen bleiben wie erfasst.
klara_accounts
ChatGPTKontenplan aus KLARA lesen – ganz oder ein einzelnes Konto per Kontonummer. Diese Daten ändern sich selten und werden serverseitig zwischengespeichert – einmal pro Arbeitsschritt abrufen, nicht einmal pro Datensatz. Für die Kontenauswahl von Buchungszeilen (inkl. links-Werte) gibt es klara_account_picker.
klara_addable_salary_items
ChatGPTWelche Lohnpositionen auf den offenen Payslip einer Person dürfen. Liefert zusätzlich contract_id und payslip_id – beide brauchst du für klara_prepare_salary_item. Ist der Payslip versiegelt, nimmt er nichts mehr an; dann muss die Position vor dem Abschluss des Lohnlaufs erfasst werden.
klara_article_categories
ChatGPTArtikelkategorien lesen – ganze Liste oder eine per Id.
klara_article_details
ChatGPTEin Artikel mit allen Feldern, optional Varianten, Set-Bestandteile und Bild. Bilder kommen Base64-codiert zurück, weil die API sie als Binärdaten liefert.
klara_article_filters
ChatGPTArtikelfilter lesen – ganze Liste oder einen per Id.
klara_audit_log
ChatGPTZeigt, welche KLARA-MCP-Tools mit deinem API-Key aufgerufen wurden: Zeit, Tool, Ergebnis, Dauer, Anfrage-id und bei Schreibaktionen die Freigabe-id. Gespeichert sind nur diese Angaben, keine Suchbegriffe, Datensätze oder Zusammenfassungen. Du siehst die Aufrufe aller Verbindungen mit demselben API-Key (zum Beispiel Claude und ChatGPT), nie die anderer Keys. Einträge werden nach 90 Tagen gelöscht. Die Anfrage-id hilft dem Support beim Zuordnen.
klara_balance_sheet
ChatGPTBilanz per Stichtag, wie in KLARA unter Buchhaltung > Berichte > Bilanz: Umlauf- und Anlagevermögen, Fremd- und Eigenkapital mit Gruppen, Konten und Unterkonten, optional mit Vergleichsstichtag. Rein lesend, braucht die Berechtigung ACCOUNTING.
klara_bank_accounts
ChatGPTBankkonten der Firma lesen (für Rechnungen und Bankabgleich).
klara_bank_open_positions
ChatGPTOffene Positionen der Bank-Abstimmung.
klara_bank_transactions
ChatGPTNoch nicht abgeglichene Banktransaktionen der Firmen-Bankkonten (Buchhaltung > Bankabgleich).
klara_booking_types
ChatGPTBuchungsarten aus KLARA lesen. Serverseitig zwischengespeichert.
klara_business_case
ChatGPTEinen einzelnen Geschäftsfall per Id lesen.
klara_business_case_from_template
ChatGPTLiest den Geschäftsfall, den KLARA aus einer Vorlage ableitet – die fertige Buchungsvorlage mit Konten und MWST, rein lesend.
klara_business_case_templates
ChatGPTGeschäftsfall-Vorlagen lesen: ganzer Katalog, nur die der aktuellen Firma oder eine einzelne per Id. Serverseitig zwischengespeichert.
klara_cancel_pending
ChatGPTVerwirft eine vorbereitete Aktion endgültig – samt allfälligem Beleg- oder Bild-Inhalt. Die Vorbereitung müsste danach neu erstellt werden; auf KLARA-Daten wirkt das Verwerfen nicht.
klara_city
ChatGPTEine Ortschaft im KLARA-Ortsverzeichnis nachschlagen – nützlich, wenn KLARA eine Adresse wegen der Ortsschreibweise ablehnt.
klara_company_vats
ChatGPTDie in der Firma hinterlegten MWST-Sätze lesen.
klara_confirm
ChatGPTFührt eine Aktion aus, die die Nutzerin oder der Nutzer auf der Freigabeseite (approval_url aus dem prepare-Schritt) mit Authenticator-Code oder Passkey freigegeben hat. Du kannst die Freigabe nicht selbst erteilen und brauchst keinen Code. Rufe das Tool erst auf, wenn die Person sagt, dass sie freigegeben hat. Wirkt auf echte KLARA-Daten; Rechnungsversand und Lohnpositionen sind nicht rückholbar, und ein freigegebener Rechnungsversand verlässt KLARA Richtung externer Empfängerinnen und Empfänger (E-Mail).
klara_customer_open_positions
ChatGPTOffene Posten einer Kundschaft oder eines Lieferanten am Stichtag (Buchhaltung > Offene Posten), mit Verlauf: Buchung, Zahlungen, Gutschriften, Mahnungen.
klara_exchange_rate
ChatGPTWechselkurs einer Währung zu CHF lesen.
klara_financial_years
ChatGPTGeschäftsjahre der aktuellen Firma lesen.
klara_general_ledger
ChatGPTHauptbuch: die Kontoauszüge aller Konten einer Periode, Abschnitt für Abschnitt nach Kontonummer. Für ein einzelnes Konto ist klara_account_statement handlicher; für Übersichten klara_balance_sheet oder klara_profit_and_loss. Mit account_from und account_to auf einen Kontenbereich eingrenzen, sonst wird es lang.
klara_get_booking
ChatGPTEine Buchung mit allen Soll- und Haben-Zeilen, Konten, MWST und Tags – wie beim Aufklappen im KLARA-Journal.
klara_get_customer
ChatGPTEinzelne Kundschaft mit allen Feldern, optional Kontakte und Zusatzadressen.
klara_get_invoice
ChatGPTEine Rechnung samt Empfänger, Positionen, Status, Buchungsstatus und Fälligkeit. Die id findest du mit klara_list_invoices (Suche, Statusfilter, Blättern).
klara_income_expenses
ChatGPTBetriebsertrag und Betriebsaufwand (Material, Personal, übriger Aufwand) pro Monat einer Periode – die Kennzahl des KLARA-Dashboards.
klara_invoice_pdf
ChatGPTRendert die Rechnung als PDF und gibt den extrahierten Text zurück. Rein lesend: KLARA rendert das PDF bei Bedarf, verschickt aber nichts. Entwürfe: bei Status DRAFT antwortet KLARA mit einem Serverfehler statt einer sauberen Absage. Der Server übersetzt das in eine klare Meldung.
klara_list_invoices
ChatGPTSucht und blättert die Rechnungen der Firma, neueste zuerst. Jede Zeile ist eine Zusammenfassung: id, Code, Nummer, Betreff, Betrag, Daten, Kundschaft und beide Statusfelder (status = Dokumentstatus, bookingStatus = Zahlungsstatus aus der Buchhaltung). Positionen, Empfänger und Anhänge liefert erst klara_get_invoice mit der id. Wichtig: Der Parameter status verhält sich wie der Filter der KLARA-Rechnungsübersicht und wird in den Zeilen nicht zurückgespiegelt. Für den genauen Zahlungsstatus nimm booking_status. Blättern: offset in Schritten von limit erhöhen, bis weniger als limit Zeilen zurückkommen. Braucht die Berechtigung FINANCE.
klara_lookup_articles
ChatGPTArtikel gezielt nachschlagen: nach Artikelnummern oder als Varianten-Liste. Ergänzt klara_search_articles: dort suchst du per Stichwort, hier holst du bekannte Nummern oder die aufgelöste Variantenliste.
klara_order_documents
ChatGPTDokumente der Auftragsverwaltung zu einer Auftragsnummer nachschlagen. Rein lesend, ohne Nebenwirkung. Die Nummernlogik der Firma liest klara_order_numbering; die nächste freie Nummer zieht klara_prepare_next_number, weil sie den Zähler vorrückt.
klara_order_numbering
ChatGPTLiest, wie KLARA die Dokumentnummern bildet (automatisch oder MANUAL). Rein lesend – der Zähler rückt dabei NICHT vor.
klara_partner_amounts
ChatGPTOffene Beträge und monatliche Zahlungen einer Kundschaft, eines Lieferanten oder aller Partner – die Zahlen der Diagramme in der Kundenansicht von KLARA.
klara_payroll_file_check
ChatGPTPrüft, ob KLARA die Lohn-Interface-Datei für ein Drittsystem erzeugen kann. Zurück kommen nur Format und Grösse der Datei, nie ihr Inhalt. Die Datei enthält Lohnrohdaten (je nach Format inklusive AHV-Nummern); solche Daten verlassen den Server bewusst nicht. Den Export selbst lädt die Person in KLARA unter Lohn herunter.
klara_pending_actions
ChatGPTListet die vorbereiteten, noch nicht bestätigten Schreibaktionen.
klara_prepare_address_create
ChatGPTLegt eine Zusatzadresse bei einer Kundschaft an. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm. Die Hauptadresse gehört zum Kundendatensatz selbst und läuft über klara_prepare_customer_update.
klara_prepare_address_delete
ChatGPTLöscht eine Zusatzadresse endgültig – es wird aber nichts sofort gelöscht: Die Antwort enthält Zusammenfassung und Freigabe-URL, gelöscht wird erst nach Freigabe über klara_confirm.
klara_prepare_address_update
ChatGPTÄndert eine Zusatzadresse einer Kundschaft. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm.
klara_prepare_article_create
ChatGPTLegt einen neuen Artikel an. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm. Artikel schreiben darf nur die Rolle «Kundenbeziehungen» oder ein Administrator. Artikelnummern vorher mit klara_lookup_articles prüfen – sie sind pro Firma eindeutig.
klara_prepare_article_delete
ChatGPTLöscht einen Artikel endgültig – es wird aber nichts sofort gelöscht: Die Antwort enthält Zusammenfassung und Freigabe-URL, gelöscht wird erst nach Freigabe über klara_confirm.
klara_prepare_article_image_delete
ChatGPTLöscht ein Artikelbild endgültig – es wird aber nichts sofort gelöscht: Die Antwort enthält Zusammenfassung und Freigabe-URL, gelöscht wird erst nach Freigabe über klara_confirm.
klara_prepare_article_image_upload
ChatGPTLädt ein Artikelbild hoch: ohne image_id wird es hinzugefügt, mit image_id ersetzt es das bestehende Bild. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm.
klara_prepare_article_update
ChatGPTÄndert einen bestehenden Artikel. KLARA ersetzt beim Ändern das ganze Objekt; der Server liest den Bestand und übernimmt alle nicht angegebenen Pflichtfelder von dort – so lässt sich etwa nur die MWST korrigieren. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm.
klara_prepare_articles_bulk
ChatGPTLegt mehrere Artikel in einem Aufruf an (nur Anlegen, kein Ändern). Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm. Artikelnummern vorher mit klara_lookup_articles prüfen – bei Dubletten bricht der ganze Aufruf ab, und die Nummern sind pro Firma eindeutig.
klara_prepare_booking
ChatGPTBereitet eine manuelle Buchung vor, ohne sie zu erfassen. Der Server prüft vorab, was KLARA sonst erst beim Speichern abweist: mindestens zwei Zeilen, ausgeglichene Soll- und Haben-Summe, positive Beträge. Tenant und Firma kommen aus den Zugangsdaten, entsprechende Felder im Body ignoriert KLARA.
klara_prepare_catalog_assign
ChatGPTWeist eine Artikelkategorie oder einen Artikelfilter einer Liste von Artikeln zu. Die Zuordnung ersetzt die bisherige Auswahl dieser Artikel. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm.
klara_prepare_catalog_create
ChatGPTLegt eine neue Artikelkategorie oder einen neuen Artikelfilter an. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm. Die bestehenden Einträge liest du mit klara_article_categories und klara_article_filters.
klara_prepare_catalog_delete
ChatGPTLöscht eine Artikelkategorie oder einen Artikelfilter endgültig – es wird aber nichts sofort gelöscht: Die Antwort enthält Zusammenfassung und Freigabe-URL, gelöscht wird erst nach Freigabe über klara_confirm. Die Artikel selbst bleiben, verlieren aber diese Zuordnung.
klara_prepare_catalog_update
ChatGPTÄndert eine Artikelkategorie oder einen Artikelfilter. Beim Ändern ersetzt KLARA den ganzen Datensatz – nicht angegebene Felder werden geleert. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm.
klara_prepare_contact_create
ChatGPTLegt eine Ansprechperson bei einer Kundschaft an. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm. Die bestehenden Kontakte liest du mit klara_get_customer und include_contacts=true.
klara_prepare_contact_delete
ChatGPTLöscht eine Ansprechperson endgültig – es wird aber nichts sofort gelöscht: Die Antwort enthält Zusammenfassung und Freigabe-URL, gelöscht wird erst nach Freigabe über klara_confirm.
klara_prepare_contact_update
ChatGPTÄndert eine Ansprechperson einer Kundschaft. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm.
klara_prepare_customer_create
ChatGPTLegt eine neue Kundschaft an (Person oder Firma). Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm. Vor dem Anlegen immer klara_search_customers nutzen: KLARA hat kein Upsert und keine Eindeutigkeitsprüfung auf E-Mail, Duplikate im Kundenstamm sind hinterher mühsam zu bereinigen.
klara_prepare_customer_delete
ChatGPTLöscht eine Kundschaft endgültig – es wird aber nichts sofort gelöscht: Die Antwort enthält Zusammenfassung und Freigabe-URL, gelöscht wird erst nach Freigabe über klara_confirm.
klara_prepare_customer_update
ChatGPTÄndert eine bestehende Kundschaft. KLARA kennt kein PATCH – der Server liest den aktuellen Stand, ersetzt nur die angegebenen Felder und schickt das ganze Objekt zurück. Es wird nichts geschrieben: Die Antwort enthält eine Zusammenfassung und eine Freigabe-URL; ausgeführt wird erst nach Freigabe über klara_confirm.
klara_prepare_invoice
ChatGPTBereitet eine Rechnung vor, ohne sie zu erstellen oder zu ändern. Mit customer_id und items entsteht eine vollständige Rechnung: Empfänger, Auftrag und Positionszeilen. Doku-Lage (Spec-Stand 25.08.2026): order und orderItems – inklusive des Tippfehlers itemNumer – stehen in den offiziellen Request-Beispielen der Spezifikation und die Beschreibung von POST /core/v1/invoices dokumentiert den Ablauf; im Invoice-SCHEMA fehlen alle drei Strukturen weiterhin, und documentAddress kommt nirgends vor. Schreibend an einer echten Rechnung bestätigt (19.08.2026). Ohne customer_id und items entsteht nur ein Beleg mit Total, Datum und Betreff – ohne Empfänger und ohne Position. Das ist selten das, was gewollt ist. Verbuchen ohne PDF: laut Spezifikation erzeugt status=INVOICED die Buchung, aber KEIN Rechnungs-PDF (anders als die Oberfläche). Das PDF entsteht erst mit klara_invoice_pdf; wer es an der Buchung haben will, hängt die printedFileId danach mit klara_prepare_receipt_attachment an. Nummerierung: bei automatischer Nummerierung holt der Server die nächste Dokumentnummer erst beim Bestätigen, damit eine verworfene Vorbereitung keine Lücke hinterlässt. Nummeriert die Firma manuell, braucht es invoice_number – der Zähler wird dann nicht angefasst. Direktes Verbuchen funktioniert: status=INVOICED (der Default) erstellt und verbucht in einem Schritt – live bewiesen am 02.09.2026. Intern legt der Server dafür einen Entwurf an und verbucht ihn sofort per Update, weil KLARAs POST den Status INVOICED nicht annimmt. Es braucht dafür auf jeder Position ein Buchungs-Tag (tag) und zur MWST den MWST-Fall (vat_case) – beides erbt eine Position mit article_number vom Artikel – sowie iban_chf; alle drei prüft der Server vor dem Staging und sagt klar, was fehlt. DRAFT ist die Wahl, wenn die Rechnung vor dem Verbuchen noch kontrolliert werden soll: erstellen, mit klara_get_invoice prüfen, dann mit invoice_id und status=INVOICED verbuchen. Der Server verknüpft die Kundschaft am Auftrag (order.customer) selbst, schreibt die MWST als verschachteltes vat-Objekt (vatCode, rate, masterId) auf die Positionen und übernimmt MWST und Buchungs-Tag vom Artikel – all das macht KLARA über die API nicht von allein.
klara_prepare_next_number
ChatGPTBereitet das Ziehen einer nächsten Nummer vor. Das sind technisch Leseabfragen, aber sie haben eine Nebenwirkung: jeder Aufruf rückt den Zähler vor und hinterlässt eine Lücke, wenn die Nummer nicht verwendet wird. Deshalb läuft es wie jeder Schreibzugriff über klara_confirm. Nur ziehen, wenn die Nummer gleich verwendet wird. Für Rechnungen brauchst du das nicht: klara_prepare_invoice holt die Nummer selbst im richtigen Moment.
klara_prepare_receipt_attachment
ChatGPTBereitet vor, einen Beleg an eine bestehende Buchung zu hängen. Achtung, das ist die schärfste Stelle der API: KLARA ersetzt beim Anhängen die komplette Beleg-Liste der Buchung, und es gibt keinen Endpoint, um die bisherigen Beleg-ids zu lesen. Was nicht in keep_document_ids steht, ist danach nicht mehr verknüpft. Für eine neue Buchung ist der Beleg-Parameter von klara_prepare_booking der sichere Weg.
klara_prepare_salary_item
ChatGPTBereitet eine variable Lohnposition auf einem offenen Payslip vor. Erfasst werden Stunden, Zulagen oder Boni. Der Payslip muss offen sein; nach dem Abschluss des Lohnlaufs nimmt er nichts mehr an. Welche Wertfelder erlaubt sind, sagt klara_addable_salary_items – nur die dort genannten setzen.
klara_prepare_send_invoice
ChatGPTBereitet den Versand einer verbuchten Rechnung vor, ohne zu senden. Der Versand selbst ist echt und nicht wiederholbar: er verschickt eine E-Mail, legt einen Brief in die Zustellkette oder stellt über ePost oder eBill zu, und überschreibt die vermerkte Versandart. Entwürfe und stornierte Rechnungen weist KLARA ab.
klara_profit_and_loss
ChatGPTErfolgsrechnung für eine Periode, wie in KLARA unter Buchhaltung > Berichte > Erfolgsrechnung: Ertrag, Aufwand und Ergebnis mit Gruppen und Konten, optional mit Vergleichsperiode. Rein lesend, braucht die Berechtigung ACCOUNTING.
klara_search_articles
ChatGPTSucht Artikel – mit search_key über die Volltextsuche, sonst über die Artikelliste.
klara_search_bookings
ChatGPTJournal der Buchhaltung durchsuchen (Buchhaltung > Journal), neueste zuerst. Jede Zeile ist der Buchungskopf mit Titel, Total, Daten und Beleg-ids; die Soll- und Haben-Zeilen liefert klara_get_booking mit der id. Deckt alle Geschäftsjahre ab.
klara_search_customers
ChatGPTSucht Kundschaft. Blättern läuft über offset in Schritten von limit.
klara_search_employees
ChatGPTMitarbeitendenverzeichnis mit Suche, Filter und Sortierung. E-Mail-Adressen werden maskiert; für Lohnpositionen brauchst du nur die employee_id.
klara_spendings_and_earnings
ChatGPTAufwand (Material, Personal, übriger) und Ertrag einer Periode nach Kategorie, verglichen mit einer Vorperiode – die Kennzahl des KLARA-Dashboards.
klara_sub_accounts
ChatGPTUnterkonten eines Kontos in der Reihenfolge von KLARA, z. B. die Bankkonten von 1020 oder die Kassen von 1000. Die Werte passen als reference-Filter in klara_account_statement (SUB_ACCOUNT:Kategorie:id).
klara_vat_cases
ChatGPTMWST-Fälle lesen (z. B. TAXABLE_SUPPLY) – die gültigen vat_case-Werte für Artikel und Rechnungspositionen.
klara_vat_included_setting
ChatGPTLiest, ob Preise in der Firma inklusive oder exklusive MWST geführt werden.
klara_vat_master
ChatGPTMWST-Katalog (master-vats) lesen: ganze Liste, nur aktuell gültige oder einen Eintrag per Id. Liefert die gültigen vat_code-Werte für Artikel. Serverseitig zwischengespeichert.
klara_vat_profile
ChatGPTMWST-Profil der aktuellen Firma lesen (Abrechnungsart, Saldosteuersatz).
klara_vat_report
ChatGPTLiest die MWST-Abrechnung einer Periode. Der Server ruft den Endpoint bewusst mit recalculate=false auf – die Neuberechnung würde den gespeicherten Report verändern und ist über dieses Werkzeug nicht möglich. Neu berechnen lässt sich die Abrechnung in KLARA.
klara_vat_suggestions
ChatGPTMWST-Vorschläge von KLARA lesen.
klara_vat_types
ChatGPTMWST-Arten lesen – ganze Liste oder eine per Id.
klara_whoami
ChatGPTZeigt Firma, Auth-Art und – auf Wunsch – welche Bereiche offen sind. Nützlich als erster Aufruf: eine KLARA-Rolle öffnet nur einen Teil der API, und ohne passendes Abo bleibt eine Funktion auch für Administratoren zu.