Crea tu cuenta y copia tu API key
Sandbox y producción comparten dominio. La API key define el entorno: beel_sk_test_… o beel_sk_live_…
API REST
La API de facturación Verifactu para España.
Emite facturas legales en España desde tu producto: Verifactu y envío a la AEAT incluidos. Sin certificados ni XMLs. SDKs en Node, Python y Java.
BeeL. es una API REST de facturación Verifactu para España: emite facturas, las registra con hash encadenado y código QR según el RD 1007/2023 y las envía a la AEAT en tiempo real, sin que necesites certificado digital propio ni construir la integración con Hacienda. Incluye OpenAPI 3.0, SDK tipado de Node.js, webhooks firmados y sandbox gratuito e ilimitado para integrar antes de pagar; en producción cuesta desde 15,90€/mes. Verifactu es obligatorio para sociedades desde el 1 de enero de 2027 y para autónomos desde el 1 de julio de 2027.
Quickstart
Tu primera factura, en 3 pasos.
Tres pasos para pasar de cero a una factura emitida en producción. Sin certificados, sin XMLs, sin esperar.
Instala el SDK o usa cURL
npm i @beel_es/sdk · pip install beel · o un cURL directo. SDKs auto-generados desde nuestro OpenAPI 3.0.
Emite la primera factura y suscribe webhooks
POST /v1/invoices y suscríbete a invoice.emitted + verifactu.status.updated.
Endpoints
REST limpio. JSON predecible.
Todo lo que tu facturación necesita ya es un endpoint: facturas, clientes, productos, series, suscripciones, webhooks. No construyes nada alrededor.
Facturas
Facturas y ciclo de vida.
POST/api/v1/invoices
GET/api/v1/invoices
GET/api/v1/invoices/:id
POST/api/v1/invoices/:id/issue
POST/api/v1/invoices/:id/corrective
GET/api/v1/invoices/:id/pdf
Clientes · Series · Webhooks
El resto del ciclo.
POST/api/v1/customers
GET/api/v1/customers/:id
POST/api/v1/configuration/series
POST/api/v1/recurring-invoices
POST/api/v1/webhooks
POST/api/v1/companies
Y mucho más: +90 endpoints REST, OpenAPI 3.0 y SDKs en Node, Python y Java. Ver la referencia completa →
Autenticación
Prueba gratis sin límites. Paga solo cuando emites de verdad.
Dos entornos, cada uno con su propia API key — el prefijo te dice cuál tienes delante. beel_sk_test_… es el sandbox, gratis e ilimitado; beel_sk_live_… es producción, y solo entonces pagas.
Bearer token
Header Authorization: Bearer …. Sin OAuth, sin firma de request. Una variable de entorno con la key del entorno que toque, y listo.
Sandbox 1:1 con producción
Mismo dominio, mismos endpoints, mismas respuestas. Nada se envía a AEAT en sandbox. Trastea sin miedo.
Nunca una factura duplicada
Manda un Idempotency-Key en tu petición: si tu sistema reintenta por un timeout, devolvemos la factura original en vez de crear otra. Cero duplicados ante Hacienda, aunque tu red falle.
Límites holgados, ampliables
100 peticiones/min por clave, con margen de sobra para picos. Si te pasas, el 429 te dice cuánto queda y cuándo reintentar (RateLimit-Remaining, Retry-After). Si necesitas más, lo subimos.
SDKs
SDKs oficiales, siempre al día con la API.
Generados desde OpenAPI 3.0: tipos completos, errores claros, reintentos incluidos. Tu IDE autocompleta y cometes menos errores.
Node / TypeScript
Tipos completos, async/await idiomático. ESM + CJS.
npmi @beel_es/sdk
Python
Type hints en cada modelo. Compatible con 3.9+.
pipinstall beel
Java
Builders fluentes, dependencias mínimas. Compatible con JDK 17+.
mavenes.beel:sdk:latest
Capacidades
Más allá de POST /invoices.
Suscripciones, facturas programadas, cargas masivas, multi-NIF. Tu facturación real, no solo el caso fácil.
Suscripciones recurrentes
Plantillas que emiten cada mes, trimestre o año. Pausa, reanuda o salta un período sin tocar código.
POST/recurring-invoicesProgramadas
Emite en el futuro como borrador o ya enviada. Cambia la fecha o cancela hasta el momento de la emisión.
POST/invoices/:id/scheduleMigra tu histórico sin riesgo
Importa clientes y facturas desde CSV o Excel con vista previa y detección de duplicados. Cada carga es todo-o-nada: migras sin perder ni duplicar.
POST/customers/bulkMulti-NIF
Cada NIF con su propio acceso, series y facturas — de 1 a miles bajo la misma integración. Pensado para gestorías, agencias y marketplaces.
POST/companiesWebhooks
Tu sistema, siempre al día con Hacienda. Sin que preguntes.
En cuanto una factura cambia de estado en la AEAT, avisamos a tu sistema al instante. Si tu servidor cae, reintentamos; si un aviso se repite, cuenta como uno.
- Eventos firmados — verificas que cada aviso viene de BeeL. y no de un impostor.
- Sin duplicados (BeeL-Event-Id) — si el mismo aviso llega dos veces, lo procesas una sola.
- 5 reintentos con backoff exponencial — si tu endpoint cae, volvemos a llamar hasta que entre.
invoice.emittedinvoice.email.sentinvoice.cancelledverifactu.status.updated
Compliance
Verifactu, integrado de serie.
Con BeeL. cumples Verifactu sin tocar nada: cada factura en producción llega a la AEAT firmada y encadenada. Sin XMLs, sin certificados, sin abogados.
Registro automático en la AEAT
Cada factura y su anulación se registran ante la AEAT automáticamente, encadenadas e inalterables. Sabes al momento si Hacienda la aceptó.
Cobertura fiscal completa
IVA, IGIC (Canarias), IPSI (Ceuta/Melilla), IRPF, recargo de equivalencia, exenciones, intracomunitario.
NIF verificado antes de emitir
Comprobamos el NIF contra el censo de Hacienda —DNI, NIE, CIF, VAT-ID— antes de emitir. Adiós a facturas rechazadas por un identificador erróneo.
Rectificativas y simplificadas
Encadenadas a la original automáticamente. Simplificadas cuando no hay NIF y el importe lo permite.
¿Validas clientes antes de facturar? Conéctalo con la API de validación de NIF
Preguntas frecuentes
¿Cómo funciona la API de facturación Verifactu?
¿La API es Verifactu-compliant de verdad?
Sí. Cada factura emitida en producción se envía a la AEAT con encadenamiento SHA-256 y recibes el acuse vía webhook firmado. Tu equipo no escribe XMLs ni mantiene certificados.
¿Cómo funciona el sandbox?
Mismo dominio que producción, mismos endpoints, mismas respuestas. Lo único que cambia es la API key: beel_sk_test_… apunta a sandbox y nada se envía a AEAT. Trastea sin límite.
¿Cuánto cuesta?
Sandbox gratis. En producción pagas por NIF gestionado, desde 19€/mes (1 NIF) hasta 4,50€/NIF (201–400 NIFs; +400 a medida). Incluye 250 facturas/NIF/mes y 0,01€ por factura extra.
Si mi sistema reintenta, ¿puedo emitir una factura duplicada?
No. Manda un Idempotency-Key (lo cacheamos 24h) y un reintento devuelve la factura original, no una nueva. Los SDKs reintentan solos con backoff exponencial en 429 y 5xx, respetando Retry-After.
¿Tenéis SDKs para X lenguaje?
Node/TypeScript, Python y Java oficiales (auto-generados desde OpenAPI 3.0). Para otros lenguajes, el spec está publicado y puedes generar tu propio cliente.
¿Y si tengo varias empresas o NIFs?
El recurso /companies te permite gestionar varios NIFs bajo una sola cuenta con accesos y series independientes. Pensado para gestorías, agencias y marketplaces.
¿Qué pasa con los webhooks si mi servidor cae?
Reintentamos hasta 5 veces con backoff exponencial. Cada evento lleva firma HMAC-SHA256 y un BeeL-Event-Id único para que dedupes idempotentemente en tu lado.
¿Puedo migrar histórico desde otra herramienta?
Sí. POST /customers/import-csv-preview acepta CSV/Excel con preview y detección de duplicados, y el alta masiva va por los endpoints bulk. Operaciones atómicas: o entra todo, o no entra nada.