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
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"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_KEYReferencia de comandos
Lista completa de comandos disponibles. Todos los comandos soportan --format json para salida legible por máquinas.
Facturas
bn invoice listListar todas las facturasbn invoice list --status sentFiltrar por estadobn invoice get <id>Ver detalles de una facturabn invoice create --relation <id> --items '[{...}]'Crear facturabn invoice status <id> sentCambiar estadobn invoice delete <id>Eliminar factura
Gastos
bn expense listListar todos los gastosbn expense create --relation <id> --total 500Crear gastobn expense analyze <id>Ver estado del análisis IAbn expense confirm <id>Confirmar datos extraídos
Pagos
bn payment listListar todos los pagosbn payment create --invoice <id> --amount 500Registrar pago de facturabn payment update <id> --amount 550Actualizar un pagobn payment delete <id>Eliminar un pago
Clientes y Proveedores
bn relation list --type clientListar clientesbn relation create --name "Acme Inc" --currency USDCrear relaciónbn relation update <id> --email new@email.comActualizar relación
Informes
bn reporting activity --period this-monthInforme de actividadbn reporting sales --period this-yearResumen de ventasbn reporting tax --years 2024,2025 --display-by quarterlyInforme fiscal
Skills IA
bn skill installInstalar skill para agentes IAbn skill statusComparar versión instalada con el CLIbn skill updateActualizar a la versión actual del CLI
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.
- Crea una factura para Acme Inc por 10 horas de consultoría a 150€/hora
- Muéstrame todas las facturas sin pagar de este mes
- Registra un pago de 500€ para la factura INV-042
- Genera un informe de ventas del T4 2024
Todo lo que necesitas saber
¿No encuentras la respuesta que buscas? Contacta con nuestro equipo →
No realmente. La instalación es un comando, el login es otro, y a partir de ahí puedes manejarlo todo con lenguaje natural vía Claude Code o cualquier agente IA. El CLI sigue ahí si quieres control directo.
En ~/.billingnow/config.json en tu máquina. El token está limitado a tu cuenta y puedes revocarlo en cualquier momento desde tu panel.
Sí. Usa bn login --key <api-key> con una clave generada en Ajustes → Claves API. Es la vía recomendada para CI/CD y servidores headless.
En todos los comandos list / get / create / update. Combínalo con jq y podrás llevar los datos de BillingNow a cualquier parte.
Instala ahora y factura más rápido
El CLI funciona en menos de un minuto. Sin configuración necesaria.