Premiers pas

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 :

brew install yannickpulver/tap/bonbox

Connexion

bonbox login ouvre votre navigateur et vous connecte avec Google, Apple ou e-mail + mot de passe – 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 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.

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

Nécessite bonbox Pro

Le CLI et l'API font partie de bonbox Pro.

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