Productos tarifarios

Los productos tarifarios son los contratos de viaje que los usuarios pueden adquirir.

Resumen

Hay 3 categorías principales de productos tarifarios definidas dentro de D1 Transit:

1. Productos tarifarios de valor almacenado
2. Productos tarifarios basados en recuento
3. Productos tarifarios basados en tiempo

Productos Tarifarios de Valor Almacenado

Los productos tarifarios de valor almacenado permiten a los usuarios precargar una cantidad de dinero en su tarjeta de transporte, que luego puede usarse para viajar en la red de transporte.

Los operadores de transporte pueden ofrecer límites de tarifa (fare capping) que garantizan que los usuarios nunca paguen más de cierta cantidad dentro de un periodo especificado, proporcionándoles ahorro de costes.

Productos Tarifarios Basados en Recuento

Los productos tarifarios basados en recuento permiten a los usuarios comprar un número fijo de viajes por adelantado, en lugar de pagar por viajes ilimitados dentro de un periodo específico (como productos semanales o mensuales).

Estos productos ofrecen un número finito de usos que los usuarios pueden utilizar. Normalmente, los productos tarifarios basados en recuento se pueden usar hasta que se agote el recuento; sin embargo, pueden tener una fecha de caducidad.

Productos Tarifarios Basados en Tiempo

Los productos tarifarios basados en tiempo generalmente están disponibles de forma mensual o semanal y permiten un número ilimitado de viajes dentro de un periodo predefinido.

A diferencia de los billetes tradicionales de pago por viaje, los productos basados en tiempo se activan por una duración establecida:

• desde el momento de la compra
• en una fecha futura programada
• u opcionalmente al primer uso

y permanecen válidos durante la totalidad de ese periodo.

Modelo de Datos

La siguiente sección describe cómo se define un producto tarifario dentro de la solución D1 Transit.

Hay 2 nociones a considerar:

• Metadatos del producto: metadatos vinculados a un producto que ha sido comprado y está asociado a la cuenta de tarjeta del usuario.
• Metadatos de producto comprable: metadatos vinculados a un producto comprable, es decir, un producto que los usuarios pueden adquirir.

Metadatos comunes de Producto / Producto Comprable

ProductId

El identificador único del producto tarifario

ProductType

Define la naturaleza del producto tarifario; como se indicó arriba, puede ser de valor almacenado, basado en recuento o basado en tiempo.

ProductName

Nombre localizado del producto, mostrado dentro de la cartera digital.

Tarifa

El objeto tarifa se compone de:

• fareId: un identificador del feed GTFS expuesto por el operador de transporte
• fareClass: cuando el producto está asociado con cierto precio/categoría, los usuarios pueden comprarlo (p. ej., business, first, standard...)
• concession: estudiante, jubilado, tarifa completa...

ValidityParameters

El objeto ValidityParameters se compone de:

• numberOfTrips: número de viajes para los que se puede utilizar un producto. Normalmente se usa para productos basados en recuento.
• timeLimits (start time / end time): ventana de tiempo dentro de la cual un producto es válido. Normalmente se usa para productos basados en tiempo, pero también puede aplicarse a productos basados en recuento.
• validityAfterTapIn: periodo de tiempo durante el cual un producto es válido después del primer check-in (tap-in).
• validityAfterTapOut: periodo de tiempo durante el cual un producto es válido después del check-out (tap-out). Normalmente se usa para fines de transbordo.
• zoneLimits: zonas de origen/destino para las que el producto es válido.
• stationLimits: estaciones de origen/destino para las que el producto es válido.
• topupLimits: límites que se aplican al recargado de un producto de valor almacenado.

Metadatos Específicos del Producto

PurchaseDetails

El objeto PurchaseDetails se compone de:

• purchaseId: número/identificador de recibo para el seguimiento de la compra del producto.
• purchaseTime: hora de compra del producto original.
• price: precio del producto.
• currencyCode: código de moneda.
• repurchaseUrl: enlace para volver a comprar el mismo producto.
• refundUrl: enlace al sitio web de reembolso para ese producto.

Metadatos Específicos del Producto Comprable

SalePeriod

El objeto SalePeriod se compone de:

• startDate: La fecha y hora más temprana (inclusive) en la que este producto puede ser comprado.
• endDate: La fecha y hora más tardía (exclusiva) en la que este producto puede ser comprado.

EligibleForTopup

Indicador que señala si el producto puede ser recargado o no.