Facturación desde tu terminal
Crea facturas, gestiona gastos, registra pagos y genera informes — todo desde la línea de comandos. Perfecto para automatización, scripting y flujos de trabajo con IA.
$ curl -fsSL https://billingnow.com/cli/install.sh | bashInstalación
Instala el CLI de BillingNow en segundos. Funciona en macOS y Linux con Node.js 18 o superior.
Ejecuta el instalador
El instalador descarga el CLI y configura todo automáticamente.
$ curl -fsSL https://billingnow.com/cli/install.sh | bashAñadir al PATH (si se solicita)
Si el instalador muestra una advertencia de PATH, añade esta línea a tu perfil de shell:
export PATH="$HOME/.local/bin:$PATH"Luego reinicia tu terminal o ejecuta source ~/.zshrc (o ~/.bashrc).
Autenticarse
Inicia sesión para conectar el CLI a tu cuenta BillingNow. Esto abre tu navegador para una autenticación OAuth segura.
$ bn loginVerificar instalación
Comprueba que todo funciona viendo tu usuario actual:
$ bn whoamiRequisitos
- Node.js 18 o superior
- macOS o Linux (Windows vía WSL)
- curl o wget
- Cuenta BillingNow
Alternativa: Login con clave API
Para entornos CI/CD o sin interfaz gráfica, autentícate con una clave API:
$ bn login --key YOUR_API_KEYGenera claves API desde Configuración en tu panel de BillingNow.
Referencia de comandos
Lista completa de comandos disponibles. Todos los comandos soportan -f json para salida legible por máquinas.
Facturas
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
Integración con agentes IA
Usa el skill CLI de BillingNow con Claude Code o cualquier agente IA que soporte skills personalizados. Deja que la IA gestione tus facturas con lenguaje natural.
Lenguaje natural
Pide a la IA que cree facturas, verifique el estado de pagos o genere informes en español.
Ejecución automática
La IA traduce tus solicitudes en comandos CLI y los ejecuta automáticamente.
Contexto inteligente
El skill proporciona documentación de comandos para que la IA sepa exactamente cómo ayudar.
Ejemplos de prompts
Tú dices:
"Crea una factura para Acme Inc por 10 horas de consultoría a 150€/hora"
Tú dices:
"Muéstrame todas las facturas sin pagar de este mes"
Tú dices:
"Registra un pago de 500€ para la factura INV-042"
Tú dices:
"Genera un informe de ventas del T4 2024"
Configuración para Claude Code
El skill está disponible automáticamente al instalar el CLI:
$ bn skill statusEl skill proporciona a Claude Code toda la documentación de comandos, para que sepa cómo crear facturas, gestionar gastos, registrar pagos y más.
bn invoice createbn payment createbn reporting sales