# Facturation depuis votre terminal

Créez des factures, gérez les notes de frais, enregistrez les paiements et générez des rapports — le tout depuis la ligne de commande. Parfait pour l'automatisation, les scripts et les workflows IA.

## Installation rapide

```bash
$ curl -fsSL https://billingnow.com/cli/install.sh | bash
```

### Prérequis

- Node.js 18 ou supérieur
- macOS ou Linux (Windows via WSL)
- curl ou wget
- Compte BillingNow

## Premiers pas

### Installation

Installez le CLI BillingNow en quelques secondes. Fonctionne sur macOS et Linux avec Node.js 18 ou supérieur.

1. ### Exécutez l'installateur

L'installateur télécharge le CLI et configure tout automatiquement.
   
   ```bash
   $ curl -fsSL https://billingnow.com/cli/install.sh | bash
   ```
2. ### Ajouter au PATH (si demandé)

Si l'installateur affiche un avertissement PATH, ajoutez cette ligne à votre profil shell :
   
   ```bash
   export PATH="$HOME/.local/bin:$PATH"
   ```
   Puis redémarrez votre terminal ou exécutez `source ~/.zshrc` (ou `~/.bashrc`).
3. ### S'authentifier

Connectez-vous pour lier le CLI à votre compte BillingNow. Cela ouvre votre navigateur pour une authentification OAuth sécurisée.
   
   ```bash
   $ bn login
   ```
4. ### Vérifier l'installation

Vérifiez que tout fonctionne en affichant votre utilisateur actuel :
   
   ```bash
   $ bn whoami
   ```

### Alternative : Connexion par clé API

Pour les environnements CI/CD ou sans interface, authentifiez-vous avec une clé API :
   
   ```bash
   $ bn login --key YOUR_API_KEY
   ```

Générez des clés API depuis les Paramètres de votre tableau de bord BillingNow.

## Référence des commandes

Liste complète des commandes disponibles. Toutes les commandes supportent `-f json` pour une sortie lisible par machine.

- **Factures**
  - `bn invoice list` - List all invoices
  - `bn invoice list --status sent` - Filter by status
  - `bn invoice get <id>` - Get invoice details
  - `bn invoice find INV-001` - Find by number or ID
  - `bn invoice create --relation <id> --items '[{"name":"Service","quantity":1,"netPrice":100}]'` - Create new invoice
  - `bn invoice update <id> --due-date 2025-02-28` - Update invoice
  - `bn invoice status <id> sent` - Change status
  - `bn invoice delete <id>` - Delete invoice
  - `bn invoice generate-number <relation-id>` - Generate invoice number

## Intégration d'agents IA

Utilisez le skill CLI BillingNow avec Claude Code ou tout agent IA supportant les skills personnalisés. Laissez l'IA gérer vos factures en langage naturel.

### Exemples de prompts

- Vous dites : "Créer une facture pour Acme Inc pour 10 heures de conseil à 150€/heure"
- Vous dites : "Montre-moi toutes les factures impayées de ce mois"
- Vous dites : "Enregistrer un paiement de 500€ pour la facture INV-042"
- Vous dites : "Générer un rapport de ventes pour le T4 2024"

### Configuration pour Claude Code

Le skill est automatiquement disponible lors de l'installation du CLI :
   
   ```bash
   $ bn skill status
   ```

Prêt à commencer ?

## Installez maintenant et facturez plus vite

Faites tourner le CLI en moins d'une minute. Aucune configuration requise.
   
   ```bash
   $ curl -fsSL https://billingnow.com/cli/install.sh | bash
   ```

Gratuit

Open source

Sans carte bancaire

```bash
bn invoice create
```

```bash
bn payment create
```

```bash
bn reporting sales
```