Perfiles de preguntas
Experticket permite asociar preguntas configurables a distintas entidades del proceso de venta. Las preguntas se agrupan en perfiles de preguntas (un perfil contiene una o más preguntas) y cada perfil se asocia a un nivel concreto: ticket, proveedor, venta o cliente.
Esta página explica los tipos de preguntas y el flujo de la API para consultarlas y responderlas. La documentación de cada endpoint implicado está enlazada a lo largo del texto.
Preguntas de ticket
Las preguntas de ticket ya disponían de documentación previa y siguen un flujo ligeramente distinto al resto (se responden al añadir el producto al carrito). El resto de niveles —proveedor, venta y cliente— se documentan en esta página y se responden al reservar o confirmar la venta.
Niveles de preguntas
Cada perfil de preguntas pertenece a uno de los siguientes niveles. La tabla indica de dónde se obtiene el identificador del perfil en el catálogo y dónde se envían las respuestas:
| Nivel | Descripción | Identificador de perfil en el catálogo | Dónde se responde |
|---|---|---|---|
| Ticket | Preguntas asociadas a un ticket concreto del producto (p. ej. nombre del asistente). | Tickets[].TicketsQuestionsProfileId |
Añadir al carrito (por ticket) |
| Proveedor | Preguntas a nivel de proveedor, aplicables a la reserva de sus productos. Si son dinámicas, algunas solo se devuelven al indicar la sesión en los tickets. | Providers[].ProviderQuestionsProfileIds |
Reservar / Confirmar venta |
| Venta | Preguntas a nivel de venta, comunes a toda la transacción. | SaleQuestionProfiles.SaleQuestionProfileIds |
Reservar / Confirmar venta |
| Cliente | Preguntas asociadas al cliente comprador. | SaleQuestionProfiles.ClientQuestionProfileIds |
Reservar / Confirmar venta |
Tipos de preguntas
Cada pregunta tiene un tipo de dato (DataType) que determina cómo se presenta y en qué propiedad debe enviarse su respuesta:
El DataType determina en qué propiedad debe enviarse la respuesta de la pregunta.
DataType |
Tipo | Propiedad de respuesta |
|---|---|---|
| 0 | Texto | StringValue |
| 1 | Lista de textos | StringCollectionValue |
| 2 | Booleano | BooleanValue |
| 3 | Lista de booleanos | BooleanCollectionValue |
| 4 | Fecha | DateTimeValue |
| 5 | Lista de fechas | DateTimeCollectionValue |
| 6 | Número entero | IntegerValue |
| 7 | Lista de enteros | IntegerCollectionValue |
| 8 | Número decimal | DecimalValue |
| 9 | Lista de decimales | DecimalCollectionValue |
| 10 | Selección de un valor entre un conjunto predefinido (Values) |
StringValue |
| 11 | Selección de varios valores entre un conjunto predefinido (Values) |
StringCollectionValue |
| 12 | Archivo | BinaryValue (+ BinaryMimeType, BinaryExtension) |
| 13 | Lista de archivos | BinaryCollectionValue (+ BinaryMimeType, BinaryExtension) |
Además, los perfiles y las preguntas se clasifican según dos criterios transversales:
Estáticas o dinámicas
El perfil indica con la propiedad AreDynamicQuestions si sus preguntas son estáticas o dinámicas:
- Estáticas (
AreDynamicQuestions = false): las preguntas están definidas en la configuración del perfil y son fijas. Se obtienen siempre al consultar perfiles de preguntas. - Dinámicas (
AreDynamicQuestions = true): las preguntas se generan en tiempo real a partir de la integración del proveedor y pueden depender del producto y de la fecha de acceso. Para obtenerlas es imprescindible incluir en la consulta los productos con su fecha de acceso (campoProductsde consultar perfiles de preguntas). Un mismo perfil puede combinar preguntas estáticas y dinámicas.
Públicas o privadas
Las preguntas pueden definirse como públicas o privadas. Esta clasificación determina en qué taquillas se presentan al comprador:
- En las taquillas públicas (taquilla pública y su variante B2B pública) solo se muestran al comprador final las preguntas públicas.
- En los canales profesionales y al integrar a través de esta API se obtienen todas las preguntas aplicables al canal.
Flujo en la API
El recorrido para trabajar con preguntas a través de la API es el siguiente:
- Catálogo. Al obtener el catálogo, cada entidad expone los identificadores de los perfiles de preguntas que tiene asociados (ver la tabla de niveles). Si una entidad no tiene perfil asociado, el campo correspondiente vendrá vacío y no será necesario tratar preguntas para ese nivel.
- Consultar perfiles de preguntas. Con esos identificadores (y, para perfiles dinámicos, los productos con su fecha de acceso) se llama a consultar perfiles de preguntas, que devuelve, por nivel, los perfiles con sus preguntas, tipos de dato, obligatoriedad, validaciones y valores predefinidos.
- Responder.
- Las preguntas de ticket se responden al añadir el producto al carrito, dentro de cada ticket.
- Las preguntas de proveedor, venta y cliente se responden en el campo
QuestionsProfilesal reservar o al confirmar la venta.
Flujo en las diferentes taquillas
Las preguntas se configuran una sola vez y se reutilizan en todos los canales de venta (taquillas), pero su presentación varía:
- Taquilla pública / pública B2B: el comprador final solo ve las preguntas públicas del canal. Las preguntas privadas no se le presentan.
- Taquilla profesional / física: el agente de venta ve todas las preguntas aplicables (públicas y privadas) configuradas para el canal.
- Integración vía API (este flujo): el sistema integrador recibe todas las preguntas aplicables al consultar los perfiles y es responsable de presentarlas y de enviar sus respuestas en los pasos de reserva/confirmación.