Ligne de commande et API

Le CLI bonbox amène vos justificatifs, factures et clients dans le terminal. Il dialogue avec l'API REST publique de bonbox à l'aide de votre compte habituel : aucun identifiant supplémentaire, aucun accès direct à la base de données. Idéal pour les scripts, les traitements en série et tout ce que vous préférez automatiser plutôt que cliquer.

Installation

Le CLI est un paquet Node (Node 20 ou plus récent) et s'installe globalement sous le nom bonbox :

npm i -g bonbox

Bientôt sur npm. En attendant sa publication, vous pouvez le compiler depuis le dépôt bonbox :

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

Connexion

bonbox login ouvre votre navigateur et vous connecte avec Google ou Apple – le même compte que dans l'application. La session est enregistrée sur votre machine et renouvelée automatiquement : une seule fois suffit.

bonbox login
bonbox login --provider apple
bonbox whoami

Commandes du quotidien

Créer une facture avec des positions (<code>description:quantité:prix unitaire[:remise]</code>) et enregistrer le PDF :

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

Marquer une facture comme payée – la recette est enregistrée en même temps comme justificatif :

bonbox invoices paid 260830-001

Téléverser un ou plusieurs justificatifs ; le montant, la date et le fournisseur sont reconnus automatiquement :

bonbox receipts scan lunch.jpg train-ticket.pdf

Lister les justificatifs du mois dernier en JSON, prêts pour vos propres scripts :

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

Afficher vos clients :

bonbox customers ls

Chaque commande accepte --json pour la réponse brute et --lang pour la langue de sortie. bonbox --help liste tout.

API

Le CLI n'est qu'une fine couche au-dessus de l'API REST publique disponible sur https://app.bonbox.io/api/v1. Pour aller plus loin – votre propre intégration, une tâche planifiée, un script dans un autre langage – authentifiez-vous avec un jeton bearer et appelez-la directement. La liste complète des points de terminaison figure dans le document OpenAPI :

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

Nécessite bonbox Pro

Le CLI et l'API font partie de bonbox Pro. Sans abonnement actif, l'API répond par un 402 et ne renvoie aucune donnée.

Autres sujets

Démarrage rapide Reçus & scan Factures & QR Projets & budgets Rapports & impôts Import & export Multidevises Astuces de pro

Prêt·e à simplifier ta comptabilité ?

Télécharge bonbox et lance-toi en quelques minutes.

App Store Google Play Web App