# 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

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

### Node.js 18+

### macOS & Linux

**Salida JSON**  
- [Instalación](/content/es/cli#installation/index.html)  
- [Comandos](/content/es/cli#commands/index.html)  
- [Integración IA](/content/es/cli#ai-integration/index.html)

## 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.
   
   ```bash
   $ 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:
   
   ```bash
   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.
   
   ```bash
   $ bn login
   ```

4. **Verificar instalación**  
   Comprueba que todo funciona viendo tu usuario actual:
   
   ```bash
   $ 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:

```bash
$ 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:

```bash
$ 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.

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

- [Crear cuenta gratis](https://app.billingnow.com/signup)  
- [Ver todos los comandos](/content/es/cli#commands/index.html)

### 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