Beleg anlegen
bb_receipts_createCreates a receipt record in BuchhaltungsButler without a file, such as an incoming invoice from another system. Requires receipt type, counterparty, invoice number, date, amount, and currency.
Instructions
Legt in BuchhaltungsButler einen Beleg ohne Datei an, zum Beispiel den Datensatz einer Eingangsrechnung aus einem Vorsystem; Belegart, Gegenpartei, Rechnungsnummer, Belegdatum, Betrag und Währung sind Pflicht. Gibt es eine Belegdatei, stattdessen bb_receipts_upload nehmen: Nachträglich lässt sich an einen Beleg keine Datei mehr hängen. Mehrere Belege auf einmal legt bb_receipts_create_batch an. Erzeugt weder eine Buchung noch eine Zahlung. Schreibt in die echten Buchhaltungsdaten von BuchhaltungsButler. Rückgängig nur mit bb_receipts_delete, das den Beleg lediglich als gelöscht markiert; die API kennt keinen Endpunkt, der einen Beleg endgültig entfernt.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Belegdatum, also das Ausstellungsdatum, als YYYY-MM-DD, zum Beispiel 2026-04-26. Ein leerer String wird abgelehnt; das Feld stattdessen weglassen. | |
| amount | Yes | Bruttobetrag des Belegs. Dezimalpunkt, kein Tausendertrennzeichen, zum Beispiel 123.99. 0.00 ist kein gültiger Betrag. Ein negativer Betrag kennzeichnet eine Rückabwicklung, zum Beispiel -12.30. | |
| currency | Yes | Die Spezifikation nennt an /receipts/add nur USD, GBP und CHF, an der Stapelvariante dagegen 48 Codes und zugleich EUR als einzigen Enum-Wert. Die drei Angaben widersprechen sich; dieses Werkzeug prüft den Wert deshalb nicht vorab. EUR ist der Regelfall. Lehnt BuchhaltungsButler eine Währung ab, nennt die Fehlermeldung den erlaubten Vorrat. | |
| vat_rate | No | Umsatzsteuersatz des Belegs in Prozent als Zahl, zum Beispiel 19 oder 0. Weglassen, wenn der Beleg keinen oder mehrere Steuersätze trägt. In der Antwort des Einzelabrufs heißt das Feld vat. | |
| counterparty | Yes | Gegenpartei des Belegs: bei einer Eingangsrechnung der Rechnungssteller, bei einer Ausgangsrechnung der Empfänger, zum Beispiel Bürobedarf Nordwest GmbH. Ein leerer Wert wird abgelehnt. | |
| receipt_type | Yes | Belegart, kleingeschrieben und mit Leerzeichen. 'invoice inbound' ist eine Eingangsrechnung, 'invoice outbound' eine Ausgangsrechnung, 'credit inbound' eine Eingangsgutschrift nach § 14 UStG, 'credit outbound' eine Ausgangsgutschrift nach § 14 UStG. Der Parameter heißt in der API type; dieser Name ist dort siebenfach mit verschiedener Bedeutung belegt, deshalb der eindeutige Werkzeugname. | |
| date_delivery | No | Leistungs- oder Lieferdatum als YYYY-MM-DD, zum Beispiel 2026-04-26. Wegen der DATEV-Kompatibilität nimmt BuchhaltungsButler kein Leistungsdatum nach dem Belegdatum an. Ein leerer String wird abgelehnt; das Feld stattdessen weglassen. | |
| invoice_number | Yes | Rechnungsnummer des Belegs, zum Beispiel ER-2026-0001, höchstens 60 Zeichen. Die API ließe hier auch einen leeren Wert zu; dieser Server lehnt leere Zeichenketten grundsätzlich ab, weil sie an fast allen Feldern dieser API ein Validierungsfehler sind. In der Antwort der Suche heißt das Feld invoicenumber, ohne Unterstrich. | |
| creditor_debtor | No | Nummer des Personenkontos, dem der Beleg zugeordnet wird: bei Eingangsbelegen ein Kreditor, bei Ausgangsbelegen ein Debitor, zum Beispiel 70001. Nachschlagen mit bb_postingaccounts_search, das Sachkonten, Zahlungskonten, Debitoren und Kreditoren gemeinsam führt und sie über die Spalte type unterscheidet. Nutzbar nur, wenn Debitoren und Kreditoren beim Mandanten aktiviert sind, und passend zur Belegart. | |
| date_payment_due | No | Fälligkeitsdatum als YYYY-MM-DD, zum Beispiel 2026-05-26. Ein leerer String wird abgelehnt; das Feld stattdessen weglassen. In der Antwort der Suche heißt das Feld due_date, im Einzelabruf date_payment_due. | |
| payment_reference | No | Technische Zahlungsreferenz, zum Beispiel eine Amazon-Bestellnummer oder eine Vorgangsnummer von PayPal oder Stripe. Kein Verwendungszweck als Freitext. Stimmt sie, findet BuchhaltungsButler die passende Zahlung von selbst. | |
| payment_account_number | No | Sachkontonummer, die ein Zahlungskonto bezeichnet, zum Beispiel '1200'. Nicht das Sachkonto, auf das gebucht wird. Zahlungskonten auflisten mit bb_payment_accounts_list. Gesetzt wird der Beleg damit unmittelbar diesem Zahlungskonto zugeordnet; das Konto muss beim Mandanten als Zahlungskonto bestehen. Der Parameter heißt in der API account. | |
| link_to_receipt_id_by_customer | No | Die mandantenbezogene Nummer eines anderen Belegs, zu finden über bb_receipts_search. Keine globale Kennung. In Suchergebnissen erscheint sie als String; hier ohne Anführungszeichen übergeben. Beide Belege werden gemeinsam einer Zahlung zugeordnet, sobald einer von ihnen von Hand zugeordnet wird. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| created | No | ||
| message | No | ||
| success | Yes | ||
| endpoint | No | ||
| reversal | No | ||
| _contract_warnings | No | ||
| fields_not_returned | No |