En un primer paso, el colaborador podrá obtener el catálogo completo de proveedores, categorías de productos (ProductBase), productos y tickets para su tratamiento interno.

Este catálogo incluye:

• Identificadores únicos de Proveedor, Producto y Ticket, que serán utilizados posteriormente en la creación de una transacción.
• Información sobre precios de los productos en función de las fechas.
• Condiciones comerciales de cada producto.

El endpoint Catalog es una herramienta poderosa cuando se usa sin filtros, ya que devuelve la información de todos los productos a los que tiene acceso el colaborador en todas las fechas disponibles, incluyendo los precios de cada producto.
Si se comprenden correctamente los nodos clave en la respuesta de esta consulta, es posible evitar múltiples llamadas, lo que reduce el uso de recursos.

Por ejemplo, si el producto "Entrada 2x1 Niño" del proveedor PAC cambia su precio o amplía su período de validez, esta información será reflejada en la consulta al catálogo.

Método de Acceso

• Versión por defecto (3.21):
  https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e
• Versión actual (3.60):
  https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e&api-version=3.60
• Verbo HTTP: GET
• Longitud máxima de la URL: 2048 caracteres

Estructura de Datos de Envío

La obtención del catálogo se realiza mediante la URL indicada anteriormente, pero es posible aplicar diferentes filtros mediante Query Strings en la URL.

Cada filtro añadido se considerará un AND.
Por ejemplo, se pueden filtrar varios ProductIds de distintos Providers, pero no sería lógico filtrar por un ProviderId y al mismo tiempo por un ProductId que no pertenezca a dicho proveedor.

A continuación, se describen los filtros disponibles:

• ProviderIds: Filtra por proveedor.
• ProductBaseIds: Filtra por categorías de productos.
• ProductIds: Filtra por productos específicos.
• FromDate: Filtra por fecha de inicio (no permite valores anteriores a la fecha actual). Formato: YYYY-MM-DD.
• ToDate: Filtra por fecha de fin (por defecto, un año desde la fecha actual). Formato: YYYY-MM-DD.
• ReferenceDate: Define un día de referencia distinto a hoy para el cálculo de precios y disponibilidad. Útil si los precios cambian en función de la anticipación de la compra. Formato: YYYY-MM-DD.
• LanguageCode: Define el idioma de los textos en el catálogo (es, en, fr, pt, ca-ES, it, zh-CN).
• ShowProductsOutOfActiveDateRange (3.22): Si se establece en true, se mostrarán productos cuya fecha de venta aún no ha comenzado.
• api-version: Permite especificar la versión del API (por defecto: 3.21).

Ejemplos de Filtros

Filtrar por ProviderId

https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e&ProviderIds=MyProviderId

Filtrar por múltiples ProviderIds

https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e&ProviderIds=MyProviderId_1&ProviderIds=MyProviderId_2

Filtrar por ProductBaseId

https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e&ProductBaseIds=MyProductBaseId

Filtrar por múltiples ProductBaseIds

https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e&ProductBaseIds=BaseId_1&ProductBaseIds=BaseId_2&ProductBaseIds=BaseId_3

Filtrar por ProductId

https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e&ProductIds=MyProductId

Filtrar por múltiples ProductIds

https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e&ProductIds=ProductId_1&ProductIds=ProductId_2

Filtrar por fechas de inicio y fin

https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e&FromDate=2025-01-01&ToDate=2025-12-31

Definir un ReferenceDate diferente a hoy

https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e&ReferenceDate=2025-06-15

Combinar múltiples filtros

https://demo.api.experticket.com/api/catalog?PartnerId=ptfhni79b311e&ProviderIds=Provider_1&ProviderIds=Provider_2&ProductBaseIds=BaseId_1&ProductBaseIds=BaseId_2&ProductIds=Product_1&ProductIds=Product_2&FromDate=2025-01-01&ToDate=2025-12-31&ReferenceDate=2025-06-15

Estructura de Datos de Respuesta

La respuesta incluye múltiples elementos, entre los cuales se destacan:

Información de Proveedores

• ProviderId: Identificador del proveedor.
• ProviderName: Nombre del proveedor.
• ProviderDescription: Descripción.
• TimeZone: Zona horaria del proveedor.
• ProviderCommercialConditions: Condiciones comerciales del proveedor.
• ProviderAccessConditions: Condiciones de acceso.
• Logo: URL del logotipo del proveedor.
• PromotionalImages: Imágenes promocionales.

Información de Productos

• ProductId: Identificador del producto.
• ProductName: Nombre del producto.
• ProductDescription: Descripción del producto.
• ProductInternalConsiderations: Consideraciones internas (no visibles para el cliente final).
• ProductCancellationConditions: Políticas de cancelación.
• IsRefundable: Indica si es reembolsable.
• Rules: Reglas de cancelación.
• StartIsActiveDate: Fecha de inicio de venta del producto.
• EndIsActiveDate: Fecha de fin de venta del producto.
• HoursInAdvanceOfPurchase: Horas mínimas de anticipación para la compra.
• MaxHoursInAdvanceOfPurchase: Horas máximas de anticipación para la compra.
• MinimumNumberByTransaction: Cantidad mínima requerida por transacción.
• RequiresRealTimePrice: Indica si el producto requiere cálculo de precio en tiempo real.

Información de Tickets

• TicketId: Identificador del ticket.
• TicketName: Nombre del ticket.
• TicketConditions: Condiciones del ticket.
• TicketEnclosureId: Identificador del recinto asociado al ticket.

Información de Precios y Disponibilidad

• PricesAndDates: Array con información de precios y fechas.
  • Price: Precio del producto.
  • Currency: Moneda.
  • OriginalPrice: Precio original antes de descuentos.
  • TaxBreakdown: Desglose de impuestos.
  • AdministrationFee: Gastos de gestión.

Información de Sesiones

• Sessions: Información de sesiones disponibles para cada producto.
• SessionContentProfileId: Identificador del contenido de sesión.
• SessionGroupProfileId: Grupo de sesión.