Riga di comando, API e MCP

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:

brew install yannickpulver/tap/bonbox

Accesso

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

bonbox login
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.

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

Server MCP (Claude & co.)

Collega bonbox a Claude o a qualsiasi altro assistente compatibile con MCP. Potrà cercare ricevute, creare fatture o segnarle come pagate. Aggiungi questo URL come connettore personalizzato (in Claude: Impostazioni → Connettori → Aggiungi connettore personalizzato), accedi con il tuo account bonbox e consenti l’accesso:

https://app.bonbox.io/api/v1/mcp

In Claude Code:

claude mcp add --transport http bonbox https://app.bonbox.io/api/v1/mcp

Richiede bonbox Pro

CLI, API e server MCP fanno parte di bonbox Pro.

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