US
ES

Comprobación de Sesiones Autoasignadas

Algunos productos en Experticket tienen sesiones que no pueden ser elegidas manualmente, sino que el sistema las asigna automáticamente según la disponibilidad. Para verificar qué sesiones serán autoasignadas antes de completar una reserva, se utiliza el endpoint de autoasignación de sesiones.

 

1. Método de Acceso

Parámetro

Descripción

URL

{baseurl}/api/autoassignsessions

Verbo HTTP

POST

Formato de Envío

application/json

 

2. Estructura de Datos de Envío

Para verificar la autoasignación de sesiones, se debe enviar una solicitud con la siguiente estructura:

Parámetro

Tipo

Descripción

PartnerId

string

Obligatorio. Identificador del colaborador.

LanguageCode

string

Opcional. Código de idioma (es, en, fr, etc.).

Products

array

Lista de productos para verificar autoasignación de sesiones.

ProductId

string

Obligatorio. Identificador del producto.

Quantity

integer

Obligatorio. Cantidad de productos a verificar.

AccessDate

string

Obligatorio. Fecha de acceso al producto en formato ISO 8601 (yyyy-MM-dd).

Tickets

array

Lista de tickets incluidos en la consulta.

TicketId

string

Obligatorio. Identificador del ticket.

AccessDate

string

Opcional. Si se indica, tiene prioridad sobre la fecha indicada en Product.

api-version

string

Opcional. Versión de la API (ejemplo: 3.47). Por defecto, se usa 3.21.

 

Ejemplo de Solicitud

{

    "PartnerId": "{partnerId}",

    "Products": [

        {

            "ProductId": "hwuk9huaqopwo",

            "Quantity": 4,

            "AccessDate": "2025-06-02",

            "Tickets": [

                {

                    "TicketId": "654e5ytetr"

                }

            ]

        },

        {

            "ProductId": "6asd55fa6s5f",

            "Quantity": 4,

            "AccessDate": "2025-06-02",

            "Tickets": [

                {

                    "TicketId": "uy456i4yu654i"

                }

            ]

        }

    ]

}

3. Estructura de Datos de Respuesta

La API devuelve un JSON con la información sobre los productos y sus sesiones autoasignadas.

Campo

Tipo

Descripción

Products

array

Lista de productos incluidos en la solicitud.

ProductId

string

Identificador del producto.

AccessDate

string

Fecha de acceso del producto.

HasTicketEnclosures

boolean

Indica si el producto tiene recintos (true / false).

Tickets

array

Lista de tickets asociados al producto.

TicketId

string

Identificador del ticket.

AccessDate

string

Fecha de acceso del ticket.

TicketEnclosureId

string

Identificador del recinto.

SessionId

string

Identificador de la sesión asignada.

SessionTime

string

Hora de la sesión asignada (HH:mm).

SessionContentId

string

Identificador del contenido de la sesión.

SessionContentName

string

Nombre del contenido de la sesión.

ResultType

integer

Código de resultado de la autoasignación.

SessionStartTimeType

integer

Tipo de inicio de sesión (0 = Acceso a la hora exacta, 1 = Acceso a partir de la hora indicada).

Success

boolean

true si la consulta fue correcta, false si hubo un error.

Timestamp

string

Fecha y hora de la consulta.

ErrorMessage

string

Mensaje de error si la consulta falla.

ErrorCodes

array

Códigos de error.

 

Ejemplo de Respuesta Exitosa

{

    "Products": [

        {

            "ProductId": "hwuk9huaqopwo",

            "AccessDate": "2025-06-02",

            "HasTicketEnclosures": true,

            "Tickets": [

                {

                    "TicketId": "654e5ytetr",

                    "AccessDate": "2025-06-02",

                    "TicketEnclosureId": "09aslkdfj354",

                    "SessionId": "lksdgjj4235",

                    "SessionTime": "18:00",

                    "SessionContentId": "nljkasdfjlk87",

                    "SessionContentName": "Viaje al centro de la Tierra",

                    "ResultType": 0,

                    "SessionStartTimeType": 1

                }

            ]

        },

        {

            "ProductId": "6asd55fa6s5f",

            "AccessDate": "2025-06-02",

            "HasTicketEnclosures": true,

            "Tickets": [

                {

                    "TicketId": "uy456i4yu654i",

                    "AccessDate": "2025-06-02",

                    "TicketEnclosureId": "09aslkdfj354",

                    "SessionId": "999tre44143",

                    "SessionContentId": "xcmnbvhasd00",

                    "SessionContentName": "Robinson Crusoe",

                    "ResultType": 4,

                    "SessionStartTimeType": 1

                }

            ]

        }

    ],

    "Success": true,

    "Timestamp": "2025-06-10T12:00:00"

}

4. Posibles Valores de ResultType

El campo ResultType indica el estado de la autoasignación de la sesión.

Valor

Descripción

0

Autoasignación correcta.

1

El producto no tiene recintos, por lo que no tiene sesiones.

2

El producto no tiene sesiones en ninguno de sus recintos.

3

El producto tiene recintos, pero no admite sesiones autoasignadas.

4

No hay sesiones disponibles para el producto y la fecha seleccionada.

 

 

5. Consideraciones Importantes

  1. No todos los productos tienen sesiones autoasignadas. Verifica la propiedad TicketEnclosureAutoAssignSessionType en el catálogo para confirmar si aplica.
  2. El sistema devolverá las sesiones que serán autoasignadas una vez que se confirme la reserva.
  3. Si ResultType es diferente de 0, significa que el sistema no pudo autoasignar una sesión válida.
  4. Si un producto no tiene sesiones, la respuesta indicará "HasTicketEnclosures": false.

6. Conclusión

  • Esta consulta es útil para verificar disponibilidad de sesiones antes de confirmar una reserva.
  • Los productos con autoasignación dependen de la configuración del recinto.
  • Se pueden consultar múltiples productos y tickets en una sola solicitud.
  • Los valores de ResultType ayudan a identificar si una sesión ha sido asignada o si existen problemas.

¿Te ha parecido útil este artículo?

ARTICULOS RELACIONADOS

LEARNING PATHS

1. Método de Acceso 2. Estructura de Datos de Envío Ejemplo de Solicitud 3. Estructura de Datos de Respuesta Ejemplo de Respuesta Exitosa 4. Posibles Valores de ResultType 5. Consideraciones Importantes 6. Conclusión
¡Copiado!