¿Hay entorno de pruebas para la API?

Sí. El entorno de pruebas se activa usando una API key con prefijo beel_sk_test_. La URL base es la misma que en producción (https://app.beel.es/api/v1), así que puedes probar toda la funcionalidad sin emitir facturas reales ni enviar nada a la AEAT.

¿Las facturas creadas por API cumplen con Verifactu?

Sí, de forma automática. Cuando emites una factura para un emisor español, BeeL. la registra ante la AEAT, genera el QR oficial y te notifica el estado (aceptada/rechazada) vía webhook verifactu.status.updated. No necesitas añadir flags en el request.

¿Qué SDKs oficiales hay disponibles?

Node.js / TypeScript ya está disponible. Java y Python llegan pronto. Mientras tanto, puedes integrar cualquier lenguaje vía REST directo usando la especificación OpenAPI 3.0 publicada en docs.beel.es.

¿Cómo me autentico contra la API?

Usa el header Authorization: Bearer seguido de tu API key. Por ejemplo: Authorization: Bearer beel_sk_live_... en producción, o beel_sk_test_... en pruebas.

¿Qué eventos webhook ofrece BeeL.?

Cuatro eventos oficiales: invoice.emitted (factura creada y finalizada), invoice.email.sent (factura enviada por email), invoice.cancelled (factura cancelada), y verifactu.status.updated (estado Verifactu aceptado/rechazado por la AEAT).

¿Cuáles son los rate limits?

Los límites son por endpoint: validación de NIF 100 req/h (con API key), importación CSV 3/h (máx. 1.000 registros), importación Holded 5/h (máx. 5.000 registros), operaciones masivas hasta 50 facturas por request, y hasta 10 webhooks activos por cuenta.

¿Se integra con Stripe?

Sí. Conecta tu cuenta Stripe en el dashboard y BeeL. emite automáticamente la factura Verifactu-compliant cada vez que hay un pago, suscripción o renovación. También puedes hacerlo por API creando la factura manualmente al recibir el webhook de Stripe.

¿Puedo migrar mis clientes desde Holded?

Sí. Hay un endpoint de importación directa desde Holded que acepta hasta 5.000 registros por archivo y 5 importaciones por hora. No necesitas escribir código de migración.

¿Cómo funciona el pricing de la API?

El precio depende del volumen mensual de facturas emitidas. Los planes van desde 50 facturas/mes hasta 5.000. La facturación anual ofrece un ~20% de descuento sobre la mensual. No hay coste por llamada: sólo cuentan las facturas emitidas, no las de prueba ni los demás endpoints.

¿Qué soporte tengo como desarrollador?

Docs completos en docs.beel.es, especificación OpenAPI 3.0 descargable, ejemplos para cURL/Node/Python, y soporte por email con SLA para cuentas de pago.

API REST · OpenAPI 3.0

La API de facturación más completa de España

Verifactu, suscripciones recurrentes, multi-empresa y notificaciones en tiempo real — todo en una sola API.

7 días gratis · sin tarjeta · Modo test incluido

Node.js

import { BeeL } from '@beel_es/sdk';

const beel = new BeeL({ apiKey: process.env.BEEL_API_KEY! });

// Create a draft invoice
const invoice = await beel.invoices.create({
  type: 'STANDARD',
  recipient: { customer_id: '550e8400-e29b-41d4-a716-446655440000' },
  lines: [
    { description: 'Monthly subscription', quantity: 1, unit_price: 29.00, discount_percentage: 0 },
  ],
});

// Issue it to assign an invoice number and trigger VeriFactu
const issued = await beel.invoices.issue(invoice.id);
console.log(issued.invoice_number); // e.g. "A-2026/0001"

Todo lo que hace

Todo lo que tu negocio necesita para facturar en España

Mucho más que crear facturas: cobertura completa de lo que cualquier empresa española hace cada mes. Desde la suscripción recurrente hasta la rectificativa, sin features de coming soon.

Verifactu sin certificados

Registro automático en Hacienda con QR oficial. Rectificativas incluidas. El certificado digital lo gestionamos nosotros.

Suscripciones recurrentes

Crea una plantilla y BeeL. emite cada mes. Pausa, reanuda o salta periodos sin tocar nada.

Facturas programadas

Programa emisiones futuras como borrador o enviadas. Cambia la fecha o marca como pagada cuando quieras.

Migración sin sustos

Sube tu CSV o Excel y revisa una vista previa con errores y duplicados antes de importar.

Operaciones bulk

Crea, edita o elimina en lote con una sola petición atómica. Simula antes de ejecutar.

Varias empresas, una cuenta

Cada empresa con su NIF y acceso independiente. Ideal para gestorías, agencias y marketplaces.

Toda la fiscalidad española

IVA, IGIC, IPSI, IRPF y recargo de equivalencia configurados. Sin aprender regímenes fiscales.

Webhooks en tiempo real

Notificaciones firmadas con reintento automático en cada cambio de estado de tus facturas.

PDFs, Excel y emails

Descarga, exporta o envía facturas por email en una llamada. Borradores con marca de agua.

Code-first

Una factura en pocas líneas

El mismo endpoint REST funciona desde cualquier stack. Copia y pega en sandbox con el prefijo beel_sk_test_.

cURL

curl -X POST https://app.beel.es/api/v1/invoices \
  -H "Authorization: Bearer beel_sk_test_a1b2c3d4e5f6g7h8" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "STANDARD",
    "recipient": { "customer_id": "550e8400-e29b-41d4-a716-446655440000" },
    "lines": [
      {
        "description": "Monthly subscription",
        "quantity": 1,
        "unit_price": 29.00,
        "discount_percentage": 0
      }
    ]
  }'

Los ejemplos usan una API key de test — puedes correrlos sin afectar producción.

¿Tu caso de uso ya está resuelto?

Arquitecturas listas para SaaS, marketplaces, ERP, agencias, developer tools y apps personalizadas. O mira cómo empezar con los SDKs oficiales.

Pricing transparente, sin sorpresas

Pagas por facturas emitidas en producción. El sandbox es ilimitado y gratis.

starter

15,90€/mes

o 19,90€/mes facturación mensual

50 facturas/mes

growth

24,90€/mes

o 32,90€/mes facturación mensual

250 facturas/mes

pro

49,90€/mes

o 64,90€/mes facturación mensual

1,000 facturas/mes

scale

79,90€/mes

o 109,90€/mes facturación mensual

2,500 facturas/mes

enterprise

129,90€/mes

o 164,90€/mes facturación mensual

5,000 facturas/mes

Precios con facturación anual. Ahorra ≈ 20% frente al pago mensual. Al suscribirte aceptas los Términos y Condiciones, incluidas las condiciones de uso de la API.

Preguntas frecuentes

Empieza a facturar desde tu código hoy

Modo test gratuito. Pasa a producción cuando estés listo.

7 días gratis · sin tarjeta · Soporte por email

import { BeeL } from '@beel_es/sdk'; const beel = new BeeL({ apiKey: process.env.BEEL_API_KEY! }); // Create a draft invoice const invoice = await beel.invoices.create({ type: 'STANDARD', recipient: { customer_id: '550e8400-e29b-41d4-a716-446655440000' }, lines: [ { description: 'Monthly subscription', quantity: 1, unit_price: 29.00, discount_percentage: 0 }, ], }); // Issue it to assign an invoice number and trigger VeriFactu const issued = await beel.invoices.issue(invoice.id); console.log(issued.invoice_number); // e.g. "A-2026/0001"

curl -X POST https://app.beel.es/api/v1/invoices \ -H "Authorization: Bearer beel_sk_test_a1b2c3d4e5f6g7h8" \ -H "Content-Type: application/json" \ -d '{ "type": "STANDARD", "recipient": { "customer_id": "550e8400-e29b-41d4-a716-446655440000" }, "lines": [ { "description": "Monthly subscription", "quantity": 1, "unit_price": 29.00, "discount_percentage": 0 } ] }'