API REST

Una API diseñada para no fallar

Idempotencia nativa, webhooks firmados, sandbox real contra la AEAT, SDKs oficiales y cumplimiento Verifactu sin tocar XML. Una API de facturación pensada por y para desarrolladores.

Leer documentación Explorar la API

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

Diferenciadores técnicos

Qué hace diferente a la API de BeeL.

No es otra API de facturación genérica. Cada decisión de diseño resuelve un problema real que los desarrolladores encuentran al integrar facturación en España.

Numeración sin huecos

Cada factura recibe un número secuencial garantizado. Sin huecos, sin duplicados, sin race conditions. La API gestiona la concurrencia por ti.

Idempotencia nativa

Repite cualquier petición con la misma clave de idempotencia y obtienes el mismo resultado. Sin duplicados, sin efectos colaterales. Seguro para reintentos automáticos.

Webhooks firmados con HMAC

Cada webhook lleva una firma HMAC-SHA256 que puedes verificar. Si tu servidor no responde, reintentamos con backoff exponencial hasta 72 horas.

Sandbox real contra la AEAT

El entorno de pruebas no es un mock: envía facturas al staging de la AEAT. Usa el prefijo beel_sk_test_ y prueba todo el flujo antes de ir a producción.

SDKs oficiales

Node.js/TypeScript, Java y Python. Tipado completo, manejo de errores consistente y ejemplos para cada endpoint. npm install @beel/sdk y a facturar.

Documentación para humanos y para IA

OpenAPI 3.0 completa, llms.txt para modelos de lenguaje, y documentación interactiva con ejemplos copiables. Tu copiloto de código también puede integrar BeeL.

Soporte prioritario para desarrolladores

Canal directo con el equipo de ingeniería. Si encuentras un bug o necesitas ayuda con la integración, no hablas con un bot: hablas con quien escribió el código.

Multi-empresa con API keys aisladas

Gestiona varias empresas desde una sola integración. Cada empresa tiene sus propias API keys, series de facturación y datos fiscales completamente aislados.

Verifactu sin XML ni certificados

Envía un JSON, recibe una factura firmada con hash SHA-256 encadenado, código QR de la AEAT y registro Verifactu completo. Nosotros nos encargamos del XML, los certificados y el envío a Hacienda.

BeeL. API vs alternativas típicas

Comparativa técnica punto por punto. Sin marketing, solo hechos.

Característica	BeeL.	API típica
Idempotencia nativa
Webhooks firmados (HMAC)
Sandbox contra AEAT staging
SDKs oficiales (Node, Java, Python)
Spec OpenAPI 3.0 publicada
Verifactu nativo (sin XML)
Multi-empresa con keys aisladas
Soporte directo con ingeniería

Empieza a integrar en 5 minutos

Documentación completa, SDKs listos y sandbox gratuito. Sin reuniones de ventas, sin esperas.

Ir a la documentación

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

Característica

BeeL.

API típica

Idempotencia nativa

Webhooks firmados (HMAC)

Sandbox contra AEAT staging

SDKs oficiales (Node, Java, Python)

Spec OpenAPI 3.0 publicada

Verifactu nativo (sin XML)

Multi-empresa con keys aisladas

Soporte directo con ingeniería