BuchhaltungsButler icon

BuchhaltungsButler

Interagiere mit der BuchhaltungsButler API

Actions33

Belege → Beleg Hochladen

AI-generated

Summary

Uploads a receipt (Beleg) to BuchhaltungsButler

Inputs

  • receiptFile (required) — Belegdatei als base64-kodierter String oder echter Datei-Upload
  • uploadReceiptType (required) — Art des Belegs (Eingangsrechnung, Ausgangsrechnung, Eingangs- oder Ausgangsgutschrift)
  • receiptUploadFields.fileName — Dateiname (ERFORDERLICH für base64-kodierte Dateien, wird ignoriert für echte Uploads)
  • receiptUploadFields.account — Buchungskonto-Nummer für direkte Zuweisung zu einem Zahlungskonto
  • receiptUploadFields.creditorDebtor — Kreditor- (bei Eingang) oder Debitor-Kontonummer für direkte Zuweisung
  • receiptUploadFields.counterparty — Rechnungssteller (bei Eingang) oder Empfänger (bei Ausgang). Hinweis: Wird bei E-Rechnungen ignoriert!
  • receiptUploadFields.invoiceNumber — Rechnungsnummer (max. 60 Zeichen). Hinweis: Wird bei E-Rechnungen ignoriert!
  • receiptUploadFields.date — Ausstellungsdatum des Belegs. Hinweis: Wird bei E-Rechnungen ignoriert!
  • receiptUploadFields.amount — Gesamtbetrag des Belegs (kann negativ sein, aber nicht 0.00). Hinweis: Wird bei E-Rechnungen ignoriert!
  • receiptUploadFields.currency — Währung (nur EUR akzeptiert). Hinweis: Wird bei E-Rechnungen ignoriert!
  • receiptUploadFields.vatRate — Mehrwertsteuersatz in Prozent. Hinweis: Wird bei E-Rechnungen ignoriert!
  • receiptUploadFields.paymentReference — Zahlungsreferenz (Amazon Order ID, PayPal Transaction ID, Stripe Transaction ID). Hinweis: Wird bei E-Rechnungen ignoriert!
  • receiptUploadFields.dateDelivery — Lieferdatum (WICHTIG: Darf nicht nach dem Belegdatum liegen wegen DATEV-Kompatibilität). Hinweis: Wird bei E-Rechnungen ignoriert!
  • receiptUploadFields.datePaymentDue — Zahlungsfälligkeitsdatum. Hinweis: Wird bei E-Rechnungen ignoriert!
  • receiptUploadFields.linkToReceiptIdByCustomer — id_by_customer eines anderen Belegs zur Verknüpfung (beide werden dann gemeinsam Transaktionen zugewiesen)

Output shape

object

Typischerweise enthält die API-Antwort die hochgeladene Beleg-ID und weitere Metadaten.

Examples

Example 1: Einfacher PDF-Upload mit Basis-64

receiptFile: , uploadReceiptType: 'invoice inbound', receiptUploadFields.fileName: 'rechnung.pdf'

Links

Discussion