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
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"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_KEYRiferimento comandi
Lista completa dei comandi disponibili. Tutti i comandi supportano --format json per output leggibile da macchine.
Fatture
bn invoice listElenca tutte le fatturebn invoice list --status sentFiltra per statobn invoice get <id>Dettagli di una fatturabn invoice create --relation <id> --items '[{...}]'Crea fatturabn invoice status <id> sentCambia statobn invoice delete <id>Elimina fattura
Spese
bn expense listElenca tutte le spesebn expense create --relation <id> --total 500Crea spesabn expense analyze <id>Verifica analisi IAbn expense confirm <id>Conferma i dati estratti
Pagamenti
bn payment listElenca tutti i pagamentibn payment create --invoice <id> --amount 500Registra pagamento fatturabn payment update <id> --amount 550Aggiorna un pagamentobn payment delete <id>Elimina un pagamento
Clienti e Fornitori
bn relation list --type clientElenca i clientibn relation create --name "Acme Inc" --currency USDCrea relazionebn relation update <id> --email new@email.comAggiorna relazione
Report
bn reporting activity --period this-monthReport attivitàbn reporting sales --period this-yearRiepilogo venditebn reporting tax --years 2024,2025 --display-by quarterlyReport fiscale
Skill IA
bn skill installInstalla lo skill per agenti IAbn skill statusConfronta versione installata e CLIbn skill updateAggiorna alla versione corrente del CLI
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.
- Crea una fattura per Acme Inc per 10 ore di consulenza a 150€/ora
- Mostrami tutte le fatture non pagate di questo mese
- Registra un pagamento di 500€ per la fattura INV-042
- Genera un report delle vendite per il Q4 2024
Tutto quello che devi sapere
Non trovi la risposta che cercavi? Contatta il nostro team →
Non proprio. L’installazione è un comando, il login un altro, e da lì puoi gestire tutto in linguaggio naturale tramite Claude Code o qualsiasi agente IA. La CLI resta disponibile se vuoi il controllo diretto.
In ~/.billingnow/config.json sulla tua macchina. Il token è limitato al tuo account e puoi revocarlo in qualsiasi momento dal tuo pannello.
Sì. Usa bn login --key <api-key> con una chiave generata da Impostazioni → Chiavi API. È la via consigliata per CI/CD e server headless.
Su ogni comando list / get / create / update. Abbinalo a jq e puoi portare i dati di BillingNow ovunque.
Installa ora e fattura più veloce
Il CLI funziona in meno di un minuto. Nessuna configurazione richiesta.