# Interfaccia a riga di comando

## Automazione con IA

# Fatturazione dal tuo terminale

Crea fatture, gestisci spese, registra pagamenti e genera report — tutto dalla riga di comando. Perfetto per automazione, scripting e workflow con IA.

## Installazione rapida

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

**Node.js 18+**  
**macOS & Linux**

## Primi passi

### Installazione

Installa il CLI BillingNow in pochi secondi. Funziona su macOS e Linux con Node.js 18 o superiore.

1. ### Esegui l'installer
   L'installer scarica il CLI e configura tutto automaticamente.

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

2. ### Aggiungi al PATH (se richiesto)
   Se l'installer mostra un avviso PATH, aggiungi questa riga al tuo profilo shell:

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

Poi riavvia il terminale o esegui `source ~/.zshrc` (o `~/.bashrc`).

3. ### Autenticati
   Accedi per collegare il CLI al tuo account BillingNow. Questo apre il browser per un'autenticazione OAuth sicura.

$ bn login

4. ### Verifica installazione
   Controlla che tutto funzioni visualizzando il tuo utente attuale:

$ bn whoami

#### Requisiti

- Node.js 18 o superiore
- macOS o Linux (Windows via WSL)
- curl o wget
- Account BillingNow

#### Alternativa: Login con chiave API

Per ambienti CI/CD o headless, autenticati con una chiave API:

$ bn login --key YOUR_API_KEY

Genera chiavi API dalle Impostazioni nella tua dashboard BillingNow.

## Riferimento comandi

Lista completa dei comandi disponibili. Tutti i comandi supportano `-f json` per output leggibile da macchine.

**Fatture**  
`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

## Integrazione agenti IA

Usa lo skill CLI BillingNow con Claude Code o qualsiasi agente IA che supporti skill personalizzati. Lascia che l'IA gestisca le tue fatture con linguaggio naturale.

#### Linguaggio naturale

Chiedi all'IA di creare fatture, verificare lo stato dei pagamenti o generare report in italiano.

#### Esecuzione automatica

L'IA traduce le tue richieste in comandi CLI e li esegue automaticamente.

#### Contesto intelligente

Lo skill fornisce la documentazione dei comandi così l'IA sa esattamente come aiutarti.

### Esempi di prompt

- Tu dici: "Crea una fattura per Acme Inc per 10 ore di consulenza a 150€/ora"
- Tu dici: "Mostrami tutte le fatture non pagate di questo mese"
- Tu dici: "Registra un pagamento di 500€ per la fattura INV-042"
- Tu dici: "Genera un report delle vendite per il Q4 2024"

### Configurazione per Claude Code

Lo skill è automaticamente disponibile quando installi il CLI:

$ bn skill status

Lo skill fornisce a Claude Code tutta la documentazione dei comandi, così sa come creare fatture, gestire spese, registrare pagamenti e altro.

## Pronto per iniziare?

### Installa ora e fattura più veloce

Il CLI funziona in meno di un minuto. Nessuna configurazione richiesta.

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

**Gratuito**  
**Open source**  
**Senza carta di credito**

`bn invoice create`

Crea fatture  
    `bn payment create`

Registra pagamenti  
    `bn reporting sales`

Genera report