Documento de arquitectura funcional y fiscal

Sistema de facturación, pagos y comisiones

Modelo objetivo para separar correctamente los cobros de las reservas, las comisiones de los Agentes y los servicios facturados por Trivity.

Actualizado: 14 de julio de 2026Estado: preproducciónUso: informativo y no contractual

00

Los tres circuitos económicos

Cada concepto conserva su propia causa, factura, acreedor y trazabilidad.

Reserva

Cliente → Provider

Pago de la actividad y, cuando corresponda, gastos de gestión trasladados al cliente.

Distribución

Provider → Agente

Comisión comercial generada por las reservas canalizadas por ese Agente.

Servicios Trivity

Provider o Agente → Trivity

Comisión de distribución, gastos de gestión y servicio de cobro de facturas del Agente.

Estos circuitos no se confunden ni se compensan entre sí. El pago técnico puede coordinarse, pero la documentación fiscal de cada operación permanece separada.

01

Creación de la reserva

La reserva fija una fotografía económica que no depende de configuraciones futuras.

En el momento de crear o validar la reserva se guardan como snapshots:

  • PVP total de la actividad, impuestos incluidos.
  • Porcentaje del Agente y comisión resultante: PVP × porcentaje del Agente.
  • Porcentaje de distribución de Trivity aplicable, normalmente 2,5 % o 5 %.
  • Importe de la comisión de distribución de Trivity.
  • Gastos de gestión de pagos: 2 % del PVP + 0,50 EUR, cuando procedan.
  • Quién soporta esos gastos y si la liquidación del Agente es manual o automática.
Regla de cálculo. Los porcentajes se calculan sobre importes con IVA incluido. Al facturar, el motor fiscal extrae la base y el IVA del total; no vuelve a añadir IVA.

La comisión se genera cuando la reserva alcanza el estado económico definido, actualmente su validación. Por ello puede existir también en reservas con pago presencial o externo.

02

Pago del Cliente al Provider

El Provider es el titular económico del cobro de la actividad.

  • En pagos online, el cobro se realiza mediante la cuenta Stripe Connect Express del Provider.
  • El cargo pertenece al Provider y el importe de la actividad llega a su saldo conectado.
  • Si el cliente soporta los gastos de gestión, estos se añaden al total pagado.
  • Si los soporta el Provider, se retienen del importe que recibiría.
  • En ambos casos ya quedan cobrados durante la reserva y no se cargan de nuevo al cierre mensual.

En pagos presenciales no existe gasto de pasarela de Stripe asociado a la reserva, aunque pueden seguir generándose la comisión del Agente y la comisión de distribución de Trivity.

03

Ledger económico interno

Los eventos contables se registran antes de agruparse en facturas.

Comisiones del Agente

agent_commission_events registra cada devengo, ajuste o anulación. Cada evento se asigna una sola vez a la ruta manual o automática, que permanece inmutable.

Importes de Trivity

trivity_fee_ledger registra la comisión de distribución, los gastos de gestión ya cobrados y sus ajustes. No se sobrescriben importes: se añaden movimientos compensatorios.

04

Agentes en modalidad manual

El circuito existente se conserva aislado de la automatización.

  • Los Agentes ya existentes permanecen en modalidad manual hasta que activen expresamente la automática.
  • Al validar una reserva se crea el APC correspondiente.
  • Agente y Provider siguen utilizando sus pantallas actuales de gestión y conciliación.
  • Trivity no emite automáticamente la factura fiscal del Agente ni crea un nuevo cargo por esa comisión.
  • Un bloqueo de la ruta automática nunca convierte silenciosamente un evento en APC manual.

05

Activación de la modalidad automática

La automatización solo se activa cuando el Agente completa todos los requisitos.

  1. Acepta la versión vigente de los términos para Agentes.
  2. Completa y valida sus datos fiscales.
  3. Define la serie de numeración de sus facturas.
  4. Otorga a Trivity el mandato para confeccionar y expedir materialmente facturas en su nombre.
  5. Completa el alta de Stripe Connect Express con cobros y transferencias habilitados.

El Agente sigue siendo el expedidor y responsable fiscal de sus facturas. Trivity actúa como tercero que las confecciona bajo mandato. Si cada camping factura por separado, cada uno necesita su propia entidad fiscal, serie, mandato y cuenta conectada.

06

Cierre mensual de comisiones del Agente

El día 1 se cierra el mes natural anterior.

Los eventos automáticos se agrupan por Agente, Provider y moneda. Para cada pareja se genera una factura fiscal del Agente al Provider con las reservas y ajustes incluidos en el período.

Ejemplo

PVP de la reserva
100,00 EUR
Comisión del Agente
10 %
Factura Agente → Provider
10,00 EUR, IVA incluido

07

Cobro de la factura del Agente

El cargo se realiza directamente en la cuenta conectada del Agente.

  1. El Provider dispone de un método de pago guardado y una autorización válida para cobros off-session.
  2. Ese método se comparte de forma segura con la cuenta conectada del Agente.
  3. Se crea un PaymentIntent directo en la cuenta Stripe Express del Agente.
  4. El Provider paga el total de la factura Agente → Provider.
  5. El Agente recibe el neto y Trivity retiene un 2,5 % mediante application_fee_amount.

Continuación del ejemplo

Cargo al Provider
10,00 EUR
Servicio de Trivity al Agente
0,25 EUR
Neto del Agente
10,00 EUR menos 0,25 EUR y costes Stripe

El cargo pertenece a la cuenta del Agente. La atribución exacta de las tarifas de Stripe depende de la configuración efectiva de su cuenta Express y debe verificarse antes de cada ejecución.

08

Factura de Trivity al Agente

Documenta fiscalmente la tarifa retenida mediante la application fee.

Por cada factura Agente → Provider cobrada, Trivity emite al Agente su propia factura por el servicio de gestión y cobro. El total es el 2,5 % retenido y se desglosa extrayendo base e IVA.

En el ejemplo anterior, Trivity factura 0,25 EUR, impuestos incluidos. Esta factura es independiente tanto de la factura del Agente como de las comisiones que Trivity facture al Provider.

09

Factura mensual de Trivity al Provider

Una sola factura mensual reúne los conceptos propios de Trivity.

La factura contiene líneas diferenciadas para:

  • Comisión de distribución: 2,5 % o 5 % del PVP, según el snapshot de cada reserva.
  • Gastos de gestión de pagos ya cobrados durante las reservas.
  • Ajustes derivados de modificaciones, cancelaciones o devoluciones.

El documento muestra el total fiscal, el importe ya retenido y el saldo pendiente. El cobro off-session mensual se limita al saldo pendiente; nunca vuelve a cobrar los gastos ya retenidos.

Ejemplo completo para una reserva de 100 EUR

Distribución Trivity al Provider
2,50 EUR
Gastos de gestión ya cobrados
2,50 EUR
Total factura Trivity → Provider
5,00 EUR
Ya cobrado
2,50 EUR
Nuevo cargo mensual
2,50 EUR

En paralelo, el Provider paga los 10 EUR de la factura del Agente y Trivity retiene 0,25 EUR al Agente por gestionar su cobro. Son operaciones y facturas distintas.

10

Cancelaciones y modificaciones

Las correcciones se registran con deltas y documentos rectificativos.

Antes del cierre

Los eventos positivos y negativos se compensan en el período. Si el neto es cero, no se emite factura por esa pareja.

Después del cierre

La factura original no se modifica. Se generan facturas rectificativas, devoluciones sobre el cargo original y, cuando proceda, devolución proporcional de la application fee.

Importe inmutable. Los gastos de gestión de pagos originales no desaparecen automáticamente por una cancelación o modificación. El resto de conceptos se ajusta según las reglas económicas y contractuales aplicables.

11

Autenticación SCA y 3DS

Un cobro que exige autenticación queda pendiente, no fallido definitivamente.

  • Stripe devuelve requires_action y se conserva el mismo PaymentIntent.
  • La aplicación muestra al administrador del Provider una acción de “Autorizar pago”.
  • La autenticación se completa con Stripe.js en el contexto de la cuenta conectada correspondiente.
  • El webhook confirma el resultado final y actualiza factura, cobro y ledger.
  • El client_secret se entrega temporalmente al cliente autorizado y no se persiste.

12

Motor de facturación fiscal

La factura es un registro fiscal estructurado; el PDF es solo su representación.

  • Numeración atómica por emisor, serie y ejercicio.
  • Datos fiscales inmutables del emisor y destinatario.
  • Conceptos, referencias de reserva, base imponible, tipo de IVA, cuota y total.
  • Relación trazable entre rectificativa y factura original.
  • PDF, huella del documento, evidencia de entrega y conservación.
  • Estados separados para emisión fiscal, cobro, revisión y rectificación.

El régimen general español del 21 % puede automatizarse. Exenciones, operaciones intracomunitarias, inversión del sujeto pasivo u otros regímenes exigen configuración fiscal explícita; si falta, el cierre se bloquea para revisión.

13

Consentimientos y evidencias

Cada obligación se acepta por quien puede vincular jurídicamente a la empresa.

Provider

  • Versión vigente de los términos.
  • Autorización de cobros off-session.
  • Uso del método de pago para facturas mensuales y de Agentes.

Agente automático

  • Versión vigente de los términos.
  • Elección expresa de modalidad automática.
  • Mandato de facturación y serie.
  • Alta y operatividad de Stripe Connect.

Las facturas del Agente disponen del procedimiento de revisión u objeción definido contractualmente, incluida la aceptación por silencio cuando sea jurídicamente aplicable.

14

Controles antes de cada ejecución

La elegibilidad se revalida justo antes de emitir o cobrar.

  • Interruptor global de automatización habilitado.
  • Flujo automático activo para el Agente y consentimientos vigentes.
  • Importe dentro del límite operativo configurado.
  • Cuenta Express correcta, sin restricciones y con charges_enabled y payouts_enabled.
  • Configuración de controller, costes, pérdidas y responsabilidades compatible.
  • Ausencia de bloqueos por disputas, saldo negativo o incidencias pendientes.
  • Bloqueo transaccional que impide ejecutar simultáneamente scheduler, reintento y acción manual.

15

Estado actual de activación

Arquitectura implementada progresivamente, todavía fuera de producción.

Preparado

Modelo económico, separación manual/automática, consentimientos, ledger, cierres, facturas, cobros directos, application fees, recuperación SCA y controles de seguridad.

Antes de activar

Configuración live, webhooks, índices y migraciones, validación fiscal final, límites, simulación integral, piloto controlado y despliegue coordinado de backend, apps y textos legales.

Estado seguro por defecto. Sin configuración expresa, el sistema permanece apagado: no inicia ciclos mensuales ni crea cargos automáticos.