# Rechnungsstellung von Ihrem Terminal

Erstellen Sie Rechnungen, verwalten Sie Ausgaben, erfassen Sie Zahlungen und generieren Sie Berichte — alles von der Kommandozeile. Perfekt für Automatisierung, Scripting und KI-gestützte Workflows.

## Schnellinstallation

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

### Erste Schritte

## Installation

Installieren Sie das BillingNow CLI in Sekunden. Funktioniert auf macOS und Linux mit Node.js 18 oder höher.

1. ### Installer ausführen

Der Installer lädt das CLI herunter und richtet alles automatisch ein.

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

2. ### Zum PATH hinzufügen (falls angefordert)

Wenn der Installer eine PATH-Warnung anzeigt, fügen Sie diese Zeile zu Ihrem Shell-Profil hinzu:

```
   export PATH="$HOME/.local/bin:$PATH"
   ```

Dann starten Sie Ihr Terminal neu oder führen Sie aus `source ~/.zshrc` (oder `~/.bashrc`).

3. ### Authentifizieren

Melden Sie sich an, um das CLI mit Ihrem BillingNow-Konto zu verbinden. Dies öffnet Ihren Browser für eine sichere OAuth-Authentifizierung.

```
   $ bn login
   ```

4. ### Installation überprüfen

Prüfen Sie, ob alles funktioniert, indem Sie Ihren aktuellen Benutzer anzeigen:

```
   $ bn whoami
   ```

### Voraussetzungen

- Node.js 18 oder höher
- macOS oder Linux (Windows über WSL)
- curl oder wget
- BillingNow-Konto

### Alternative: API-Schlüssel-Login

Für CI/CD oder headless Umgebungen, authentifizieren Sie sich mit einem API-Schlüssel:

```
$ bn login --key YOUR_API_KEY
```

Generieren Sie API-Schlüssel in den Einstellungen Ihres BillingNow-Dashboards.

## Befehlsreferenz

Vollständige Liste der verfügbaren Befehle. Alle Befehle unterstützen `-f json` für maschinenlesbare Ausgabe.

### Rechnungen

`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

## KI-Agent-Integration

Verwenden Sie den BillingNow CLI Skill mit Claude Code oder jedem KI-Agenten, der benutzerdefinierte Skills unterstützt. Lassen Sie die KI Ihre Rechnungen in natürlicher Sprache verwalten.

### Beispiel-Prompts

Sie sagen:

"Erstelle eine Rechnung für Acme Inc für 10 Stunden Beratung zu 150€/Stunde"

Sie sagen:

"Zeige mir alle unbezahlten Rechnungen von diesem Monat"

Sie sagen:

"Verbuche eine Zahlung von 500€ für Rechnung INV-042"

Sie sagen:

"Erstelle einen Verkaufsbericht für Q4 2024"

### Einrichtung für Claude Code

Der Skill ist automatisch verfügbar, wenn Sie das CLI installieren:

Check skill status

```
$ bn skill status
```

Der Skill stellt Claude Code die gesamte Befehlsdokumentation bereit, damit es weiß, wie man Rechnungen erstellt, Ausgaben verwaltet, Zahlungen erfasst und mehr.

## Bereit zu starten?

Jetzt installieren und schneller

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

### Kostenlos nutzbar

Open Source

Keine Kreditkarte erforderlich

`bn invoice create`

Rechnungen erstellen

`bn payment create`

Zahlungen erfassen

`bn reporting sales`

Berichte generieren