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.
$ curl -fsSL https://billingnow.com/cli/install.sh | bashInstallazione
Installa il CLI BillingNow in pochi secondi. Funziona su macOS e Linux con Node.js 18 o superiore.
Esegui l'installer
L'installer scarica il CLI e configura tutto automaticamente.
$ curl -fsSL https://billingnow.com/cli/install.sh | bashAggiungi 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).
Autenticati
Accedi per collegare il CLI al tuo account BillingNow. Questo apre il browser per un'autenticazione OAuth sicura.
$ bn loginVerifica installazione
Controlla che tutto funzioni visualizzando il tuo utente attuale:
$ bn whoamiRequisiti
- 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_KEYGenera 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 listList all invoices
bn invoice list --status sentFilter by status
bn invoice get <id>Get invoice details
bn invoice find INV-001Find 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-28Update invoice
bn invoice status <id> sentChange 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 statusLo skill fornisce a Claude Code tutta la documentazione dei comandi, così sa come creare fatture, gestire spese, registrare pagamenti e altro.
bn invoice createbn payment createbn reporting sales