API de Facturación para Apps Personalizadas
Tu lógica de negocio, nuestra infraestructura fiscal
Cualquier flujo de negocio que necesite facturar puede integrarse con BeeL. La API se adapta a tu arquitectura y lógica, no al revés. Desde aplicaciones verticales hasta plataformas complejas multi-tenant.
¿Por qué construir tu app sobre la API de BeeL?
Cada negocio tiene flujos únicos. BeeL te da los cimientos fiscales para que te centres en lo que hace especial tu aplicación.
Abstracción fiscal completa
No necesitas conocimiento profundo de IVA, IRPF, VeriFactu o numeración secuencial. BeeL encapsula toda la complejidad. Tú envías datos de negocio (cliente, importe, concepto) y recibes una factura legalmente válida.
Flexibilidad de integración
REST API estándar que funciona con cualquier stack: frontend SPA, backend Node/Python/Go/PHP, serverless functions, webhooks. No estás atado a un framework o plataforma específica.
Composición con otros servicios
BeeL es una pieza más de tu arquitectura. Combínalo con Stripe para pagos, SendGrid para emails, tu base de datos para clientes. Cada servicio hace lo que mejor sabe hacer, tú orquestas el flujo completo.
Control total de la experiencia de usuario
Tú decides cuándo y cómo se emite la factura en tu app. Puede ser automático al confirmar un pedido, manual desde un botón, programado con cron, o disparado por eventos externos. La API es tu backend, tú controlas el frontend.
Lógica de negocio arbitrariamente compleja
Descuentos por volumen, promociones, precios dinámicos, comisiones escalonadas, múltiples monedas convertidas a EUR... calcula lo que necesites en tu app y envía el resultado a BeeL. No estás limitado por plantillas o reglas prefijadas.
Innovación sin fricción fiscal
Estás construyendo algo nuevo, un modelo de negocio no convencional. No dejes que la facturación te frene. BeeL te permite innovar en tu propuesta de valor mientras mantienes cumplimiento normativo automático.
Patrones comunes de integración en apps custom
Arquitecturas y flujos típicos que developers implementan con BeeL.
Event-driven: facturación desde eventos de dominio
Tu app emite eventos de negocio (OrderCompleted, SubscriptionRenewed, ProjectDelivered). Un consumer escucha estos eventos y llama a BeeL para facturar.
- Pub/Sub con RabbitMQ, Redis, Kafka, o event bus nativo de tu framework
- Consumer recibe evento, valida datos, llama a POST /facturas
- Idempotencia vía evento ID garantiza factura única por evento
Serverless: funciones cloud que facturan on-demand
AWS Lambda, Vercel Functions, Cloudflare Workers. Tu función se dispara vía HTTP request o evento cloud y ejecuta lógica de facturación.
- Función recibe payload (cliente, importe, concepto)
- fetch() a BeeL API desde entorno serverless
- Responde a tu frontend con invoice_id y status
Background jobs: cola de facturación asíncrona
Enqueas trabajos de facturación (Sidekiq, Celery, Bull) para procesarlos en background. Útil si la facturación no debe bloquear la respuesta al usuario.
- User confirma acción en frontend → backend enquea job
- Worker procesa job cuando tiene capacidad
- Job llama a BeeL, actualiza estado en DB, notifica usuario
Multi-tenant: cada tenant con su cuenta BeeL
Si tu app es SaaS con múltiples empresas como clientes, cada empresa tiene su API key de BeeL. Tu app almacena la key por tenant y factura a nombre del tenant correspondiente.
- Tabla tenants con columna beel_api_key
- Al facturar, lees API key del tenant activo
- Llamadas a BeeL usan key del tenant, no la tuya
Batch processing: emisión masiva con control de errores
Procesas lotes de facturas (fin de mes, cierre de proyecto con múltiples clientes). Iteras, llamas a BeeL para cada una, logueas resultados.
- Script itera clientes a facturar
- try/catch por cliente para aislar errores
- Log de exitosas vs fallidas para retry manual si necesario
Capacidades avanzadas para apps complejas
Features de la API que soportan casos de uso sofisticados.
Borradores vs. facturas emitidas
Crea facturas en estado 'borrador' (no cuentan para el límite mensual) para revisión. Cuando confirmas, emítelas con una segunda llamada. Útil si necesitas aprobación humana antes de emitir.
Facturas rectificativas programáticas
POST /facturas con tipo 'rectificativa' y referencia a la factura original. BeeL gestiona la cadena de facturas automáticamente. Perfecto para devoluciones, cancelaciones o ajustes.
Multi-idioma en PDFs (ES, EN, CA)
Especifica idioma al crear factura. BeeL genera PDF en el idioma solicitado. Útil si tienes clientes internacionales o comunidades autónomas con idioma cooficial.
Paginación y filtrado avanzado
GET /facturas con parámetros de paginación (page, limit), filtros (fecha_inicio, fecha_fin, cliente_id, estado). Construye dashboards y reportes sin límites de rendimiento.
Preguntas frecuentes para apps personalizadas
¿Puedo facturar en nombre de múltiples empresas desde una app?
Sí, si tu app es multi-tenant. Cada empresa que factura necesita su propia cuenta de BeeL y API key. Tu app almacena la API key por tenant y la usa al facturar. No puedes facturar a nombre de terceros con tu propia key.
¿La API soporta facturación en otras monedas además de EUR?
No. BeeL emite facturas en EUR porque está diseñado para cumplimiento fiscal español. Si cobras en USD, GBP, etc., debes convertir a EUR antes de llamar a la API. Puedes registrar la moneda original en campos de descripción o notas para referencia.
¿Cómo gestiono permisos de acceso a facturas en mi app?
BeeL no gestiona roles ni permisos de usuarios de tu app. Tu backend es responsable de autenticar usuarios y verificar que solo accedan a facturas permitidas. BeeL solo valida la API key del tenant/empresa. Implementa tu lógica de autorización antes de llamar a BeeL.
¿Puedo integrar BeeL con un frontend sin backend (Jamstack)?
No es recomendable. Nunca expongas tu API key en el frontend (navegador del cliente). Necesitas un backend (serverless o tradicional) que maneje la API key y llame a BeeL. El frontend llama a tu backend, y tu backend llama a BeeL de forma segura.
¿Qué pasa si mi app requiere campos custom en las facturas?
Puedes usar el campo 'notas' para añadir información adicional que aparecerá en el PDF. Sin embargo, campos fiscales obligatorios no son modificables. Si necesitas tracking interno (IDs de pedidos, referencias), almacénalos en tu DB enlazados al invoice_id de BeeL.
¿Listo para automatizar tu facturación?
Integra la API de BeeL. y empieza a facturar en minutos.
Sin permanencia • 15€/mes hasta 250 facturas • Cancela cuando quieras