Preguntas de Tickets

El método checkticketsquestions permite consultar preguntas asociadas a los tickets de productos específicos. Esto es útil para conocer qué información adicional puede ser requerida antes de completar una transacción.

1. Método de Acceso

Parámetro	Descripción
URL	{baseurl}/api/checkticketsquestions
Verbo HTTP	POST
Formato de Envío	application/json

2. Estructura de Datos de Envío

Para realizar una consulta sobre preguntas de tickets, se debe enviar una solicitud con la siguiente estructura:

Parámetro	Tipo	Descripción
PartnerId	string	Obligatorio. Identificador del colaborador.
ProductIds	array	Obligatorio. Lista de identificadores de productos. Se pueden consultar uno o varios.
TicketsQuestionsProfileIds	array	Opcional. Identificadores de perfiles de preguntas.
LanguageCode	string	Opcional. Código de idioma (es, en, fr, etc.).

Ejemplo de Solicitud

{

"PartnerId": "{partnerId}",

"ProductIds": [

"MyProductId"

"TicketsQuestionsProfileIds": [

"MyProfileQuestionId"

"LanguageCode": "es"

}

3. Estructura de Datos de Respuesta

La API devuelve un JSON con la información de los productos, tickets y preguntas asociadas.

Campo	Tipo	Descripción
Products	array	Lista de productos consultados.
ProductId	string	Identificador del producto.
Tickets	array	Lista de tickets asociados al producto.
TicketId	string	Identificador del ticket.
TicketQuestionsProfileId	string	Identificador del perfil de preguntas del ticket.
TicketQuestionsProfiles	array	Lista de perfiles de preguntas.
Id	string	Identificador del perfil de preguntas.
Questions	array	Lista de preguntas relacionadas.
Id	string	Identificador de la pregunta.
Question	string	Pregunta completa.
ShortQuestion	string	Versión corta de la pregunta.
Required	boolean	Indica si la pregunta es obligatoria (true / false).
DataType	integer	Tipo de dato de la pregunta (ver tabla de valores posibles).
MaxNumberOfValues	integer	Número máximo de valores seleccionables (si aplica).
Values	array	Conjunto de valores predefinidos (si aplica).
Success	boolean	true si la consulta fue correcta, false si hubo un error.

Ejemplo de Respuesta Exitosa

{

"Products": [

{

"ProductId": "MyProductId",

"Tickets": [

{

"TicketId": "MyTicketId",

"TicketQuestionsProfileId": "MyTicketsQuestionsProfileIds"

}

]

}

"TicketQuestionsProfiles": [

{

"Id": "QuestionsProfilesId",

"Questions": [

{

"Id": "QuestionsId",

"Question": "¿Cuál es tu número de pasaporte?",

"ShortQuestion": "Número de pasaporte",

"Required": true,

"DataType": 6

}

]

}

"Success": true

}

4. Posibles Valores de DataType

El campo DataType indica el tipo de dato que espera la pregunta.

Valor	Tipo de Pregunta
0	Texto
2	Booleano (true / false)
4	Fecha (formato ISO 8601 yyyy-MM-dd)
6	Número entero
8	Número decimal
10	Selección de un valor entre varios predefinidos
11	Selección de múltiples valores predefinidos
12	Archivo (por ejemplo, subir un documento o imagen)

5. Consideraciones Importantes

No todos los tickets requieren preguntas. Si un ticket no tiene preguntas asociadas, el campo TicketQuestionsProfiles estará vacío.
Las preguntas pueden ser obligatorias o opcionales. Se debe validar el campo Required antes de completar una compra.
El DataType define el formato de la respuesta. Esto es útil para asegurar que los datos sean ingresados correctamente por el usuario.
Se pueden solicitar preguntas para múltiples productos y tickets en una sola consulta.

6. Conclusión

Este método permite consultar información relevante antes de la compra.
Es útil para verificar si un ticket requiere datos adicionales como nombre, fecha de nacimiento o pasaporte.
El DataType define el formato esperado, lo que permite validar respuestas correctamente.
Se pueden hacer consultas para múltiples productos y tickets en una sola solicitud.

Home

API