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

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

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

¿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).

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

Agencia Digital

Hito completado, factura emitida

Integra la API de BeeL. en tu CRM o gestor de proyectos. Cuando marcas un entregable como completado, la factura se emite, se envía al cliente y se registra en Verifactu sin que nadie abra una plantilla.

7 días gratis · sin tarjeta · Sandbox ilimitado · Compatible con Notion, ClickUp, Monday, Asana y custom

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
      }
    ]
  }'

Por qué automatizar facturación en tu agencia

Más creatividad, menos administración

Las agencias viven del tiempo facturable. Cada minuto que tu equipo pasa editando una factura es un minuto que no pasa creando valor.

Facturación por hitos y entregables

Proyectos con anticipo, prototipo y entrega final requieren una factura por fase. La API emite cada una al marcar el hito, sin riesgo de olvidos ni de importes mal copiados.

Retainers y servicios recurrentes

Para mantenimientos mensuales o servicios continuos, programa un cron que llame a /invoices el día 1 de cada mes. Tus clientes reciben su factura puntualmente sin que nadie lo recuerde.

Subcontratación y colaboradores

Factura al cliente final el total del proyecto con una sola llamada. Si tu operación lo requiere, usa múltiples API keys para separar entidades legales cuando hay freelancers con su propia facturación.

Verifactu incluido

Cada factura cumple con el Real Decreto 1007/2023: hash encadenado, QR oficial, envío automático a la AEAT y webhook verifactu.status.updated para reaccionar al veredicto.

Cash flow acelerado

Reduces el tiempo entre terminar el trabajo y cobrar de días a segundos. La factura sale cuando el hito se completa, no cuando alguien en administración llega al email.

Visibilidad financiera en tiempo real

GET /invoices con filtros por cliente, fecha y estado. Construye dashboards internos con facturado, pendiente de cobro y proyecciones sin exportar nada a Excel.

Código real

De hito completado a POST /invoices

El mismo endpoint funciona desde tu webhook de Notion, tu action de ClickUp o tu n8n. Pasa los datos del hito y BeeL. hace el resto.

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
      }
    ]
  }'

Sandbox con prefijo beel_sk_test_. Idempotency-Key = milestone_id para evitar duplicados si la automatización se reintenta.

Cómo integras la API con tu flujo

Conecta tu CRM o gestor de proyectos con BeeL. usando webhooks, cron jobs o plataformas low-code. Lo tienes funcionando en una tarde.

1
Defines hitos y precios en tu CRM
Cada proyecto lleva sus hitos facturables (anticipo 30%, prototipo 30%, entrega 40%). Guardas el customer_id de BeeL. y el importe por hito en tu base de datos.
2
Tu equipo marca el hito como completado
Cuando el entregable se cierra, el cambio dispara un webhook o una automatización (n8n, Make, Zapier) con los datos del hito — customer_id, importe, descripción.

La automatización llama a POST /invoices

Tu sistema hace la llamada REST a BeeL. con el Idempotency-Key = milestone_id. BeeL. genera la factura, le asigna número y la registra en Verifactu.

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"

4
Cliente recibe PDF automáticamente
BeeL. envía el PDF profesional con tu logo al email del cliente. El cliente lo contabiliza en segundos. Puedes incluir link de pago si usas Stripe o similar.
5
Tu CRM se actualiza con el invoice_id
Guardas el invoice_id en tu CRM enlazado al hito para trazabilidad. Tu dashboard pasa de 'pendiente' a 'facturado' y alimenta tus reportes financieros.

Preguntas frecuentes para agencias

La factura sale cuando el hito se completa

Deja de perder horas copiando datos entre tu CRM y tu facturación. BeeL. se encarga — tu equipo factura desde el mismo botón donde marca el trabajo como hecho.

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

Hito completado, factura emitida

7 días gratis · sin tarjeta · Sandbox ilimitado · Compatible con Notion, ClickUp, Monday, Asana y custom

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 } ] }'

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"

Hito completado, factura emitida

Facturación por hitos y entregables

Retainers y servicios recurrentes

Subcontratación y colaboradores

Verifactu incluido

Cash flow acelerado

Visibilidad financiera en tiempo real

De hito completado a POST /invoices

Cómo integras la API con tu flujo

Defines hitos y precios en tu CRM

Tu equipo marca el hito como completado

La automatización llama a POST /invoices

Cliente recibe PDF automáticamente

Tu CRM se actualiza con el invoice_id

¿Las facturas creadas por API cumplen con Verifactu?

¿Cómo me autentico contra la API?

¿Hay entorno de pruebas para la API?

¿Qué eventos webhook ofrece BeeL.?

¿Qué SDKs oficiales hay disponibles?

¿Cómo funciona el pricing de la API?

La factura sale cuando el hito se completa

Hito completado, factura emitida

Facturación por hitos y entregables

Retainers y servicios recurrentes

Subcontratación y colaboradores

Verifactu incluido

Cash flow acelerado

Visibilidad financiera en tiempo real

De hito completado a POST /invoices

Cómo integras la API con tu flujo

Defines hitos y precios en tu CRM

Tu equipo marca el hito como completado

La automatización llama a POST /invoices

Cliente recibe PDF automáticamente

Tu CRM se actualiza con el invoice_id

¿Las facturas creadas por API cumplen con Verifactu?

¿Cómo me autentico contra la API?

¿Hay entorno de pruebas para la API?

¿Qué eventos webhook ofrece BeeL.?

¿Qué SDKs oficiales hay disponibles?

¿Cómo funciona el pricing de la API?

La factura sale cuando el hito se completa