Riga di comando e API

La CLI di bonbox porta ricevute, fatture e clienti nel terminale. Comunica con l'API REST pubblica di bonbox usando il tuo normale account: nessuna credenziale aggiuntiva, nessun accesso diretto al database. Comoda per script, lavori in blocco e tutto ciò che preferisci automatizzare invece di cliccare.

Installazione

La CLI è un pacchetto Node (Node 20 o successivo) e si installa globalmente come bonbox:

npm i -g bonbox

In arrivo su npm. Fino alla pubblicazione puoi compilarla dal repository di bonbox:

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

Accesso

bonbox login apre il browser e ti autentica con Google o Apple, lo stesso account dell'app. La sessione viene salvata sul tuo computer e rinnovata automaticamente: basta farlo una volta.

bonbox login
bonbox login --provider apple
bonbox whoami

Comandi di tutti i giorni

Creare una fattura con le posizioni (<code>descrizione:quantità:prezzo unitario[:sconto]</code>) e salvare il PDF:

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

Segnare una fattura come pagata: l'entrata viene registrata contemporaneamente come ricevuta:

bonbox invoices paid 260830-001

Caricare una o più ricevute; importo, data e fornitore vengono riconosciuti automaticamente:

bonbox receipts scan lunch.jpg train-ticket.pdf

Elencare le ricevute del mese scorso in JSON, pronte per i tuoi script:

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

Vedere i tuoi clienti:

bonbox customers ls

Ogni comando accetta --json per la risposta grezza e --lang per la lingua di output. bonbox --help mostra tutto.

API

La CLI è solo un sottile strato sopra l'API REST pubblica su https://app.bonbox.io/api/v1. Se vuoi spingerti oltre – una tua integrazione, un job pianificato, uno script in un altro linguaggio – autenticati con un token bearer e chiamala direttamente. L'elenco completo degli endpoint si trova nel documento OpenAPI:

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

Richiede bonbox Pro

CLI e API fanno parte di bonbox Pro. Senza un abbonamento attivo l'API risponde con un 402 e non restituisce dati.

Altri argomenti

Avvio rapido Ricevute e scansione Fatture e QR Progetti e budget Rapporti e fisco Import ed export Multivaluta Consigli da pro

Pronto a semplificare la tua contabilità?

Scarica bonbox e inizia in pochi minuti.

App Store Google Play Web App