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

  1. 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).

  1. Autenticati

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

$ bn login

  1. 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