Freie Buchung anlegen
bb_postings_create_freeCreates a free posting in BuchhaltungsButler for complete journal entries without receipt or payment reference, e.g. transfers between ledger accounts. Use when no receipt or payment exists.
Instructions
Legt in BuchhaltungsButler eine freie Buchung an, also einen vollständigen Buchungssatz ohne Beleg- und Zahlungsbezug, etwa eine Umbuchung zwischen zwei Sachkonten. Zu nehmen, wenn weder ein Beleg noch eine Zahlung vorliegt; liegt ein Beleg vor, ist bb_postings_create_for_receipt richtig, liegt eine Zahlung vor, bb_postings_create_for_transaction. Der Aufruf erzeugt genau eine Buchungszeile; eine Splitbuchung über mehrere Zeilen nehmen die beiden genannten Werkzeuge über ihre Positionsliste entgegen. Soll- und Habenkonto werden hier ausdrücklich angegeben. Die Antwort nennt die erzeugte id_by_customer nicht. Schreibt in die echten Buchhaltungsdaten von BuchhaltungsButler. Eine festgeschriebene Buchung lässt sich nicht löschen, sondern nur mit bb_postings_cancel stornieren; der Storno bleibt dauerhaft sichtbar.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vat | Yes | Steuerschlüssel der Buchungszeile. '_pre' steht für Vorsteuer (Eingangsumsätze), '_vat' für Umsatzsteuer (Ausgangsumsätze), '_both' für Fälle mit beidem, etwa Reverse Charge nach §13b. Welcher Schlüssel zulässig ist, hängt vom Konto, vom Buchungsdatum und von den Mandanteneinstellungen ab. Die deutschen Bezeichnungen aller 23 Schlüssel stehen in der Resource bb://vat-keys. | |
| date | Yes | Buchungsdatum der freien Buchung als YYYY-MM-DD, zum Beispiel 2026-04-26. Ein leerer String wird abgelehnt; das Feld stattdessen weglassen. Die Parameterbeschreibung der Spezifikation nennt hier kein Format; YYYY-MM-DD ist aus dem Beispiel der Stapeldefinition abgeleitet. | |
| amount | Yes | Betrag der Buchungszeile. Dezimalpunkt, kein Tausendertrennzeichen, zum Beispiel 123.99. Negative Beträge lehnt BuchhaltungsButler ab; eine Gegenbuchung entsteht durch Vertauschen von postingaccount_debit und postingaccount_credit. | |
| postingtext | Yes | Buchungstext der Zeile, höchstens 128 Zeichen. | |
| cost_location | No | Kostenstelle, mandantenbezogen, nachschlagen mit bb_cost_locations_search. Höchstens 10 Zeichen. | |
| cost_location_two | No | Kostenstelle der zweiten Ebene, mandantenbezogen, nachschlagen mit bb_cost_locations_search. Höchstens 10 Zeichen. | |
| postingaccount_debit | Yes | Sollkonto der Buchung als Sachkontonummer, zum Beispiel 4980. Nachschlagen mit bb_postingaccounts_search. In der Leseantwort von bb_postings_search heißt dasselbe Konto debit_postingaccount_number. | |
| postingaccount_credit | Yes | Habenkonto der Buchung als Sachkontonummer, zum Beispiel 1600. Muss sich vom Sollkonto unterscheiden. Nachschlagen mit bb_postingaccounts_search. In der Leseantwort von bb_postings_search heißt dasselbe Konto credit_postingaccount_number. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| created | No | ||
| message | No | ||
| success | Yes | ||
| endpoint | No | ||
| reversal | No | ||
| _contract_warnings | No | ||
| fields_not_returned | No |