API de Facturación para Marketplaces
Doble facturación automatizada en una sola llamada
Gestiona las facturas de tu marketplace de forma profesional. Emite dos facturas simultáneas: profesional a cliente final y marketplace a profesional. Todo con una única llamada a la API.
¿Por qué tu marketplace necesita facturación automatizada?
En un marketplace, cada transacción genera dos relaciones comerciales distintas que necesitan documentación fiscal independiente.
Doble facturación obligatoria
El profesional debe facturar al cliente final por el servicio prestado, y el marketplace debe facturar al profesional por la comisión. Son dos operaciones fiscales distintas que ocurren simultáneamente.
Sincronización crítica
Ambas facturas deben emitirse al mismo tiempo para mantener la coherencia contable. Un error en el timing puede generar desajustes fiscales para tus profesionales y para tu plataforma.
Cumplimiento normativo
Cada factura debe cumplir con VeriFactu, IRPF, IVA y toda la normativa española. No basta con un recibo o confirmación de pago, necesitas facturas fiscalmente válidas.
Escalabilidad del modelo
Con cientos o miles de transacciones diarias, generar manualmente dos facturas por cada operación es inviable. La automatización no es opcional, es esencial para el crecimiento.
Segregación de datos
Cada profesional solo debe ver sus propias facturas. El marketplace gestiona comisiones separadamente. La API permite mantener esta separación de forma natural y segura.
Experiencia del usuario
Tus profesionales esperan que todo funcione automáticamente. Confirmar un trabajo, cobrar y recibir la factura sin intervención manual mejora la retención y satisfacción.
Cómo funciona la integración en tu marketplace
Un flujo simple que se integra con tu sistema de pagos y gestión de pedidos.
Cliente contrata servicio en tu plataforma
El cliente elige un servicio o producto ofrecido por un profesional en tu marketplace. Acepta el precio y confirma la contratación.
- Tu sistema registra la transacción con todos los detalles
- Calculas tu comisión según tu modelo de negocio
- Almacenas IDs de cliente, profesional y pedido
Procesador de pagos confirma el cobro
Stripe, PayPal o tu pasarela de pago ejecuta el cargo al cliente. El dinero entra en tu cuenta del marketplace.
- Recibes el webhook de confirmación de pago
- Tienes el ID de transacción del procesador
- El servicio está listo para ejecutarse
Tu sistema llama a la API de BeeL (2 facturas)
En tu webhook de pago confirmado, haces dos llamadas a la API: una para la factura del profesional al cliente, y otra para la factura del marketplace al profesional.
- Primera llamada: profesional factura al cliente el servicio completo
- Segunda llamada: marketplace factura al profesional la comisión
- Usas X-Idempotency-Key para evitar duplicados si el webhook se reintenta
Facturas emitidas, PDFs enviados automáticamente
BeeL genera ambas facturas con numeración secuencial, cumplimiento VeriFactu, y envía los PDFs por email al cliente final y al profesional.
- Factura 1: Cliente recibe PDF del profesional con el desglose del servicio
- Factura 2: Profesional recibe PDF del marketplace con la comisión deducida
- Ambas facturas registradas y disponibles vía API para reporting
Reporting y reconciliación
Todas las facturas quedan accesibles vía API. Puedes listar, filtrar y descargar para tus dashboards, contabilidad o auditorías.
- Endpoint GET /facturas con filtros por fecha, cliente, estado
- Exporta datos para tu panel de comisiones
- Datos listos para entregar a tu gestor o contable
Ventajas de automatizar con la API de BeeL
No solo ahorras tiempo. Reduces riesgos legales, mejoras la experiencia de tus profesionales y escalas sin fricciones.
Idempotencia integrada
Si tu webhook se ejecuta dos veces por un reinicio, no se duplican facturas. La API reconoce la clave de idempotencia y devuelve la factura original.
Cumplimiento garantizado
VeriFactu, IRPF, IVA, numeración secuencial... toda la complejidad fiscal española gestionada automáticamente. Tú te centras en crecer el marketplace.
Sin mantenimiento
La normativa cambia constantemente. Nosotros actualizamos la API para mantener el cumplimiento. Tu código sigue funcionando sin cambios.
Escalabilidad real
Da igual si emites 10 o 10.000 facturas al mes. La API está diseñada para crecer contigo sin degradación de rendimiento ni cambios en el código.
Preguntas frecuentes sobre facturación en marketplaces
¿Cada profesional necesita su propia cuenta de BeeL?
Sí. Cada profesional que factura a través de tu marketplace necesita su propia cuenta de BeeL y su API key. Esto garantiza que cada uno gestiona sus propias facturas, impuestos y cumplimiento fiscal de forma independiente. El marketplace tiene su propia cuenta para facturar comisiones.
¿Puedo emitir las dos facturas en una sola llamada?
No directamente. Son dos entidades fiscales distintas (el profesional y el marketplace), por lo que requieren dos llamadas a la API con distintas API keys. Sin embargo, puedes ejecutarlas en paralelo desde tu backend en el mismo proceso, haciendo que la operación sea prácticamente instantánea.
¿Qué pasa si un profesional no tiene cuenta de BeeL?
Debes onboardear a tus profesionales para que se den de alta en BeeL y activen el plan API. Puedes ofrecer soporte técnico o incluso subsidiar el coste como parte de tu propuesta de valor. Sin su cuenta activa, no podrán emitir facturas legales a través de tu plataforma.
¿Cómo gestiono las devoluciones o cancelaciones?
Usa facturas rectificativas. La API permite crear facturas rectificativas que anulan o modifican facturas previamente emitidas. Simplemente referencias la factura original y especificas el motivo de la rectificación. El sistema maneja automáticamente la cadena de facturas.
¿La API soporta comisiones variables o escalonadas?
Sí. Tú calculas la comisión en tu sistema según tus reglas de negocio (porcentaje fijo, escalas por volumen, etc.) y envías el importe final a la API. BeeL no necesita conocer tu lógica de comisiones, solo recibe el importe a facturar.
¿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