Reserva de Productos
La reserva de productos es el primer paso antes de crear una transacción. Permite garantizar disponibilidad y fijar el precio de los productos seleccionados por un tiempo determinado.
1. Método de Acceso
2. Datos de Envío
Para realizar una reserva, se deben enviar los siguientes parámetros:
3. Ejemplo de Petición
Ejemplo 1: Reserva de productos sin sesiones
{
"ApiKey": "{partnerId}",
"IsTest": false,
"AccessDateTime": "2025-04-04",
"Products": [
{
"ProductId": "4hfspe75or5ie",
"Quantity": 2
}
]
}
Ejemplo 2: Reserva con tickets y preguntas
{
"ApiKey": "{partnerId}",
"IsTest": false,
"AccessDateTime": "2025-04-04",
"Products": [
{
"ProductId": "4hfspe75or5ie",
"Quantity": 2,
"Tickets": [
{
"TicketId": "odjvu374udF8D",
"Questions": [
{
"TicketQuestionId": "doejfu729du4R",
"StringValue": "respuesta de la pregunta"
}
]
}
]
}
]
}
Ejemplo 3: Reserva con productos combinados
{
"ApiKey": "{partnerId}",
"IsTest": false,
"AccessDateTime": "2025-04-04",
"Products": [
{
"ProductId": "abc123",
"CombinedProductId": "xyz987",
"Quantity": 1
}
]
}
4. Estructura de la Respuesta
Si la reserva es exitosa, se devuelve una estructura similar a la enviada, agregando información relevante.
5. Ejemplo de Respuesta Exitosa
{
"ReservationId": "zp83haxd5ucwn",
"MinutesToExpiry": 20,
"AccessDateTime": "2025-04-04T00:00:00",
"TotalPrice": 42,
"Products": [
{
"ProductId": "4hfspe75or5ie",
"CombinedProductId": "94osaxf9pep5a",
"Quantity": 2,
"Price": 21,
"Success": true
}
],
"Success": true,
"ErrorMessage": ""
}
6. Ejemplo de Respuesta con Error
{
"Success": false,
"ErrorMessage": "El producto solicitado no tiene disponibilidad.",
"ErrorEntityBreakDown": [
{
"Id": "4hfspe75or5ie",
"Name": "Producto sin disponibilidad"
}
]
}
7. Consideraciones Finales
- Cada reserva tiene un tiempo límite de expiración, después del cual los productos pueden quedar nuevamente disponibles para otros usuarios.
- Los precios quedan fijados en el momento de la reserva, sin importar cambios posteriores.
- Si un producto no se puede reservar, la solicitud completa fallará. Se debe validar disponibilidad antes de la reserva.
- La reserva debe completarse con una transacción para garantizar la compra final del producto.
- Se pueden incluir tickets, sesiones y preguntas si la estructura del producto lo requiere.