Sin escribir código
landingCli.features.items.0.description
CLI oficial
Factura desde la terminal
Emite facturas Verifactu, valida NIFs y exporta datos sin salir de la consola. Sin montar una integración: agent-first, con salida JSON y sandbox por defecto.
Node.js 20+ · sandbox gratis e ilimitado · npm i -g @beel_es/cli
terminal
La consola que también entienden tus agentes
Pensada para humanos y para asistentes de IA: comandos predecibles, salida JSON y seguridad por defecto.
Sandbox por defecto
Cada comando usa tu clave de test salvo que pases --live. Nada llega a la AEAT por error: pasar a producción es siempre explícito.
Salida JSON, lista para scripts
Las respuestas salen como JSON: encadénalas con jq, mételas en un script o en tu pipeline de CI. Y códigos de salida con significado.
Agent-first
beel commands lista toda la API en una sola llamada y beel docs search busca la documentación en local. Tu asistente de IA puede facturar sin que le expliques nada.
Idempotencia automática
Cada POST lleva su Idempotency-Key. Si reintentas, no duplicas: el servidor devuelve la respuesta original.
El ciclo completo
Facturas, clientes, productos, series, validación de NIF y webhooks. Y un escape genérico, beel request, para cualquier endpoint nuevo.
Instalar
Instálala en un comando
Global con npm, o sin instalar nada con npx (ideal para CI y agentes). Requiere Node.js 20 o superior.
npm (global)
Recetas
Lo que harás el primer día
Comandos reales del patrón beel <recurso> <acción>. La lista completa y siempre al día sale de beel commands.
Facturas
Los ejemplos usan beel_sk_test_ — pruébalos en tu sandbox sin consecuencias.
De cero a tu primera factura en 4 pasos
Unos minutos desde el install hasta una factura emitida en sandbox.
- 1
Instala la CLI
npm install -g @beel_es/cli. Requiere Node.js 20 o superior.
npm (global) - 2
Pon tu API key de test
Una clave con prefijo beel_sk_test_ en la variable BEEL_API_KEY. En sandbox nada se envía a la AEAT.
terminal$ export BEEL_API_KEY=beel_sk_test_a1b2c3d4e5f6g7h8 - 3
Crea y emite
beel invoices create deja el borrador; beel invoices issue le asigna número y dispara Verifactu.
terminal - 4
Descúbrelo todo
beel commands te da el índice completo en JSON y beel docs search busca la documentación en local. Sin leer manuales.
terminal
La suite de desarrollador
¿Quieres la integración montada sola?
La CLI, el SDK tipado y el plugin de Claude Code son la misma caja de herramientas. Instala el plugin y Claude monta la integración por ti —y la verifica con la CLI contra el sandbox antes de tocar producción.
SDK de Node/TypeScript
El código que tu producto envía a producción: tipado, con reintentos automáticos e idempotencia.
$npm i @beel_es/sdk
VerCLI
Opera y automatiza desde la terminal o tu CI. Agent-first y sandbox por defecto.
$npx @beel_es/cli invoices create
Plugin de Claude Code
Claude lee la doc y monta la integración por ti, y la verifica con la CLI contra el sandbox.
$/plugin install beel-api@beel
VerLa CLI es gratis. Pagas por facturas emitidas.
Úsala todo lo que quieras en sandbox sin coste. Solo pagas cuando emites en producción.
Preguntas frecuentes
¿Necesito saber programar para usar la CLI?
No. Si te manejas con la terminal, ejecutas comandos como beel invoices create o beel nif validate y ya está. No tienes que escribir ni mantener una integración.
¿Es seguro? ¿Puedo tocar producción sin querer?
La CLI usa el sandbox por defecto: cada comando va con tu clave de test salvo que pases --live. Una clave de producción sin --live da error, nunca un envío silencioso a la AEAT.
¿La puede usar un agente de IA?
Sí, está diseñada para eso. La salida es JSON, los códigos de salida tienen significado, beel commands expone toda la API en una llamada y beel docs search busca la documentación en local. Un asistente puede facturar de forma autónoma y segura.
¿Cuándo uso la CLI y cuándo el SDK?
La CLI es para operar, automatizar y scriptear desde la terminal o CI, y para agentes. El SDK de Node/TypeScript es para la integración que tu producto envía a producción, con tipos y reintentos. Muchos equipos usan los dos.
¿Funciona en CI/CD?
Sí. Usa npx @beel_es/cli para ejecutar siempre la última versión sin instalar, pasa la API key por variable de entorno y aprovecha los códigos de salida para fallar el pipeline cuando toque.
¿Qué necesito para instalarla?
Node.js 20 o superior. Instálala global con npm install -g @beel_es/cli o úsala sin instalar con npx @beel_es/cli.
Tu terminal, facturando Verifactu
Instálala, prueba en sandbox gratis y pasa a producción cuando quieras.
Node.js 20+ · sandbox gratis · sin tarjeta