Kommandozeile & API

Das bonbox CLI bringt Belege, Rechnungen und Kunden ins Terminal. Es spricht mit der öffentlichen bonbox-REST-API und nutzt dein normales bonbox-Konto – keine zusätzlichen Zugangsdaten, kein direkter Datenbankzugriff. Praktisch für Skripte, Massenarbeiten und alles, was du lieber automatisierst als klickst.

Installation

Das CLI ist ein Node-Paket (Node 20 oder neuer) und wird global als bonbox installiert:

brew install yannickpulver/tap/bonbox

Anmelden

bonbox login öffnet den Browser und meldet dich mit Google, Apple oder E-Mail + Passwort an – dasselbe Konto wie in der App. Die Sitzung wird lokal gespeichert und automatisch erneuert, du machst das also nur einmal.

bonbox login
bonbox whoami

Befehle für den Alltag

Rechnung mit Positionen erstellen (<code>Beschreibung:Menge:Einzelpreis[:Rabatt]</code>) und PDF speichern:

bonbox invoices create \
  --customer "Velo GmbH" \
  --item "Design work:8:145" \
  --item "Retainer:1:2000:10%" \
  --pdf invoice.pdf

Rechnung als bezahlt markieren – die Einnahme wird gleich als Beleg verbucht:

bonbox invoices paid 260830-001

Einen oder mehrere Belege hochladen; Betrag, Datum und Anbieter werden automatisch erkannt:

bonbox receipts scan lunch.jpg train-ticket.pdf

Belege des letzten Monats als JSON ausgeben, direkt weiterverwendbar in eigenen Skripten:

bonbox receipts ls --month 2026-08 --json

Kunden anzeigen:

bonbox customers ls

Jeder Befehl versteht --json für die rohe Antwort und --lang für die Ausgabesprache. bonbox --help zeigt alles.

API

Das CLI ist nur eine dünne Schicht über der öffentlichen REST-API unter https://app.bonbox.io/api/v1.

https://app.bonbox.io/api/v1/openapi.json

Benötigt bonbox Pro

CLI und API gehören zu bonbox Pro.

Weitere Themen

Schnellstart Belege & Scannen Rechnungen & QR Projekte & Budgets Berichte & Steuern Import & Export Mehrere Währungen Profi-Tipps

Bereit, deine Buchhaltung zu vereinfachen?

Lade bonbox herunter und starte in wenigen Minuten.

App Store Google Play Web App