Para ciertos productos, el proveedor puede exigir que los precios se consulten en tiempo real, en lugar de utilizar los precios predeterminados del catálogo.

El proveedor notificará al colaborador qué productos requieren precios en tiempo real mediante correo electrónico u otro medio.

Este endpoint permite consultar los precios en tiempo real para uno o varios productos en una o varias fechas de acceso.

1. Método de Acceso

2. ¿Por qué se Llaman Precios en Tiempo Real?

El precio de un producto puede variar según múltiples factores, como:

• Días restantes hasta la fecha de acceso.
• Temporada o demanda en la fecha seleccionada.

Ejemplo:

• Un boleto de entrada para un parque temático con acceso en un mes puede no costar lo mismo si se compra hoy o mañana.

Por ello, se recomienda hacer esta consulta cada vez que se desee verificar el precio actualizado de un producto para una fecha específica.

3. Estructura de la Solicitud (Request)

El cuerpo de la solicitud debe enviarse en JSON, con la siguiente estructura:

4. Ejemplo de Solicitud (Request JSON)

{

    "PartnerId": "tsanmqda1obue",   

    "CombinedProducts": [

        {

            "CombinedProductId": "hb5s7oga895gg",

            "Products": [

                {

                    "ProductId": "9gufs7moar6j6",

                    "AccessDate": "2022-01-03"

                },

                {

                    "ProductId": "uryf86hmwkk8c",

                    "AccessDate": "2022-01-06"

                },

                {

                    "ProductId": "qk5hzzuwnw844",

                    "AccessDate": "2021-12-20"

                }

            ]

        }

    ]

}

5. Estructura de la Respuesta (Response JSON)

La API devolverá un array de precios en tiempo real con los productos consultados.

6. Ejemplo de Respuesta Exitosa

{

    "ProductsRealTimePrices": [

        {

            "ProductId": "9gufs7moar6j6",

            "AccessDate": "2022-01-03",

            "Price": 49.99,

            "PriceMode": 1

        },

        {

            "ProductId": "uryf86hmwkk8c",

            "AccessDate": "2022-01-06",

            "Price": 39.99,

            "PriceMode": 1

        }

    ],

    "Success": true,

    "TimeStamp": "2025-01-15T12:34:56Z"

}

7. Ejemplo de Respuesta con Error

{

    "Success": false,

    "TimeStamp": "2025-01-15T12:34:56Z",

    "ErrorMessage": "Invalid ProductId or AccessDate format."

}

8. Consideraciones Finales

• Consultar siempre los precios en tiempo real para productos que lo requieran, ya que los precios pueden cambiar diariamente.
• Los productos combinados también deben ser consultados si el proveedor los indica en la lista de productos con precios dinámicos.
• El formato de fecha debe ser ISO 8601 (yyyy-MM-dd), de lo contrario, la API podría rechazar la solicitud.
• Si hay errores en la consulta, la API proporcionará un mensaje de error con detalles.

Este endpoint es crítico para evitar discrepancias en los precios de los productos que se venden en la plataforma.