Facturación desde tuterminal

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.

Instalación rápida

$ curl -fsSL https://billingnow.com/cli/install.sh | bash

Node.js 18+

macOS & Linux

Salida JSON

Primeros pasos

Instalación

Instala el CLI de BillingNow en segundos. Funciona en macOS y Linux con Node.js 18 o superior.

  1. Ejecuta el instalador
    El instalador descarga el CLI y configura todo automáticamente.

    $ curl -fsSL https://billingnow.com/cli/install.sh | bash

  2. Añ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).

  3. Autenticarse
    Inicia sesión para conectar el CLI a tu cuenta BillingNow. Esto abre tu navegador para una autenticación OAuth segura.

    $ bn login

  4. Verificar instalación
    Comprueba que todo funciona viendo tu usuario actual:

    $ bn whoami

Requisitos

  • 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_KEY

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

Comandos

  • Facturas
    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

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 status

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

Instala ahora y factura más rápido

El CLI funciona en menos de un minuto. Sin configuración necesaria.

$ curl -fsSL https://billingnow.com/cli/install.sh | bash

Gratis

Código abierto

Sin tarjeta de crédito

Comandos adicionales

  • bn invoice create
    Crear facturas
  • bn payment create
    Registrar pagos
  • bn reporting sales
    Generar informes