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:

npm i -g bonbox

Kommt auf npm. Bis zur Veröffentlichung dort kannst du es aus dem bonbox-Repository bauen:

pnpm -C packages/cli build
node packages/cli/dist/cli.js --help

Anmelden

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

bonbox login
bonbox login --provider apple
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. Wer weiter gehen will – eigene Integration, geplanter Job, Skript in einer anderen Sprache – authentifiziert sich mit einem Bearer-Token und ruft sie direkt auf. Alle Endpunkte stehen im OpenAPI-Dokument:

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

Benötigt bonbox Pro

CLI und API gehören zu bonbox Pro. Ohne aktives Abo antwortet die API mit einem 402 und liefert keine Daten.

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