> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/transit-digitization/es/comenzar/conceptos/productos-tarifarios.md).

# Productos tarifarios

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

### Resumen <a href="#overview" id="overview"></a>

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 <a href="#stored-value-fare-products" id="stored-value-fare-products"></a>

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 <a href="#count-based-fare-products" id="count-based-fare-products"></a>

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 <a href="#time-based-fare-products" id="time-based-fare-products"></a>

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 <a href="#data-model" id="data-model"></a>

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 <a href="#product--purchasable-product-common-metadata" id="product--purchasable-product-common-metadata"></a>

**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 <a href="#product-specific-metadata" id="product-specific-metadata"></a>

**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 <a href="#purchasable-product-specific-metadata" id="purchasable-product-specific-metadata"></a>

**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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/transit-digitization/es/comenzar/conceptos/productos-tarifarios.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.