> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/feature-references/feature-references-lac-es/referencias-de-funciones-y-productos/sugerencia-inteligente.md).

# Sugerencia inteligente

Smart Suggestion es una capacidad inteligente de venta adicional y venta cruzada integrada en la plataforma de punto de venta de combustibles de Verifone.

## Historial de revisiones

<table><thead><tr><th width="247.3333740234375">Fecha</th><th>Descripción</th></tr></thead><tbody><tr><td>07/13/2026</td><td>Lanzamiento inicial</td></tr><tr><td>07/23/2026</td><td>Se corrigieron los comentarios de revisión. </td></tr><tr><td></td><td></td></tr></tbody></table>

## Resumen

Smart Suggestion es una capacidad inteligente de venta adicional y venta cruzada integrada en la plataforma de punto de venta para combustibles de Verifone. La función muestra recomendaciones contextuales de productos al cajero (o al cliente en autoservicio) en el momento de totalizar una transacción, lo que permite a los operadores de tiendas de conveniencia aumentar el tamaño de la canasta y generar ingresos incrementales sin requerir capacitación manual del cajero ni memorización de promociones.

Smart Suggestion ha demostrado un aumento en las tasas de conversión de venta adicional de hasta 40% y en las ventas totales de la tienda de hasta 5% en implementaciones reales.

{% hint style="info" %}
**Contexto de la industria:** Las tiendas de conveniencia suelen operar con márgenes muy ajustados (2–5%). Aumentar el tamaño promedio de la canasta mediante indicaciones automatizadas basadas en datos es una de las palancas de mayor retorno de la inversión disponibles para los operadores sin agregar costos de mano de obra.
{% endhint %}

### Valor comercial

#### Impacto en ingresos

Smart Suggestion ofrece un aumento medible en los KPI clave del comercio minorista:

<table><thead><tr><th width="247.3333740234375">KPI</th><th>Impacto reportado</th></tr></thead><tbody><tr><td>Tasa de conversión de venta adicional</td><td>Aumento de hasta 40% sobre la línea base</td></tr><tr><td>Ventas totales de la tienda</td><td>Aumento incremental de hasta 5%</td></tr><tr><td>Tamaño promedio de la canasta</td><td>Crecce sin aumentar la cantidad de clientes ni la frecuencia de visitas</td></tr><tr><td>Dependencia del cajero</td><td>Reducida: las indicaciones del sistema sustituyen el conocimiento manual de los productos</td></tr></tbody></table>

#### Beneficios para el operador

* Las indicaciones automatizadas y específicas de la transacción eliminan la necesidad de que los cajeros memoricen artículos promocionales.
* Las ofertas se derivan de análisis reales de la cesta de compra, lo que mejora la relevancia y las tasas de aceptación.
* Configuración centralizada desde Commander: no se requieren actualizaciones del software del POS para cambiar las sugerencias activas.
* Funciona en canales atendidos por cajero (C18), de autoservicio (C18 SCO) y en terminales de pago dirigidas al cliente con PIN pad.
* Admite mosaicos de productos basados en imágenes, mensajes de aviso personalizados y precios por producto para maximizar el atractivo visual.

### Comportamiento de la función

#### Tipos de sugerencia

Se admiten cinco tipos de sugerencia:

<table><thead><tr><th width="237">Tipo de sugerencia</th><th>Comportamiento</th></tr></thead><tbody><tr><td>Sugerencia de PLU</td><td>El panel de Smart Suggestion ofrece productos PLU individuales con imágenes, nombres y precios. Los productos seleccionados se agregan directamente a la canasta.</td></tr><tr><td>Sugerencia de menú</td><td>El panel de Smart Suggestion ofrece un menú, incluidos menús de selección múltiple y menús exprés. El cajero o el cliente selecciona artículos del menú, que luego se agregan a la canasta.</td></tr><tr><td>Sugerencia solo de mensaje</td><td>El panel de Smart Suggestion muestra un mensaje promocional sin productos seleccionables. El mensaje puede ser un recordatorio, un aviso de marketing o un aviso de registro, como un registro de lealtad. La transacción continúa después de la confirmación.</td></tr><tr><td>NAXML - Ofertas combinadas</td><td>Si los artículos agregados desde el panel de Smart Suggestion están sujetos a promociones NAXML aplicables, como mezcla y combina u ofertas combinadas, el panel de Smart Suggestion comunica el precio, el monto, los descuentos porcentuales y los reembolsos de impuestos aplicables.</td></tr><tr><td>NAXML - Artículos de mezcla y combina</td><td>Si los artículos agregados desde el panel de Smart Suggestion están sujetos a promociones NAXML aplicables, como mezcla y combina u ofertas combinadas, el panel de Smart Suggestion comunica el precio, el monto, los descuentos porcentuales y los reembolsos de impuestos aplicables.</td></tr></tbody></table>

#### Plataformas compatibles y requisitos previos

<table><thead><tr><th width="236">Componente</th><th>Requisito</th></tr></thead><tbody><tr><td>Terminal POS</td><td>Verifone C18, tanto en modo atendido por cajero como en modo SCO</td></tr><tr><td>Pantalla del PIN pad</td><td><p>El tipo de sugerencia en la pantalla del PIN pad es compatible con las terminales de pago dirigidas al cliente M400 y posteriores.<br></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Solo se muestran en los PIN pad los tipos de sugerencia PLU y solo mensaje</p></div></td></tr><tr><td>Controlador del sitio</td><td>Verifone Commander (en las instalaciones), Base 57.01 o posterior</td></tr></tbody></table>

#### Restricciones de la función

Los siguientes elementos no se pueden configurar para venta adicional:

* Artículos con restricción de edad
* PLU abiertos
* Artículos de cantidad fraccionaria
* Artículos que solicitan número de serie

Solo se puede mostrar una Smart Suggestion por transacción. Si el usuario cancela una y agrega más artículos que califican para una oferta combinada o de mezcla y combina de NAXML, se mostrará otra Smart Suggestion relacionada con esos artículos.

### Interacción con otras funciones

<table><thead><tr><th width="258">Función</th><th>Interacción</th></tr></thead><tbody><tr><td>Verificación de edad en el POS</td><td>La verificación de edad se resuelve antes de que aparezca el panel de sugerencias; los artículos con restricción de edad ofrecidos en el panel de ventas activan la solicitud estándar de VERIFICAR ID al agregarse.</td></tr><tr><td>Restricciones de ley azul / no vender</td><td>Las restricciones por horario y por no venta se aplican a los artículos sugeridos exactamente igual que en las ventas regulares.</td></tr><tr><td>Bandera de subtotal requerido: habilitada o deshabilitada</td><td>Agregar artículos desde el panel de sugerencias requiere presionar Total una segunda vez antes de cobrar. </td></tr><tr><td>Descuentos / promociones (NAXML)</td><td>Los artículos agregados desde el panel de sugerencias están sujetos a las promociones NAXML aplicables — mezcla y combina, ofertas combinadas, descuentos por precio nuevo/monto/porcentaje y reembolsos de impuestos — después de agregarse a la canasta. El aviso del panel de sugerencias comunica esto.</td></tr><tr><td>Lealtad / caridad / propinas</td><td>Funciona junto en una sola transacción, incluido combustible con devolución de efectivo en débito.</td></tr><tr><td>EMV / tipos de pago</td><td>Independiente del método de pago. El panel de sugerencias se completa (aceptar o rechazar) antes de seleccionar el tipo de pago. Todos los tipos de cobro funcionan normalmente después de cerrar el panel.</td></tr><tr><td>Transacciones de combustible</td><td>El panel de sugerencias no se muestra durante la finalización de un faltante en prepago. El panel de Smart Suggestion tampoco se muestra para las transacciones Rest in Gas, Commercial Fleet y Fill Up. </td></tr><tr><td>Autoservicio (SCO)</td><td>El panel de sugerencias se muestra en modo SCO con la misma interfaz y comportamiento. No se requiere la intervención del cajero, excepto para las verificaciones de edad cuando se agregan artículos relacionados con la edad al panel de ventas.  <br>El panel de sugerencias aparece cuando se presiona Checkout. En modo cajero en SCO, el panel de sugerencias aparece solo después de presionar MOP. </td></tr><tr><td>Artículos del menú (expandido / superpuesto)</td><td>Los artículos desencadenantes pueden basarse en menús o escaneos PLU. Tanto los menús expandidos como los menús superpuestos son compatibles como puntos de entrada a la canasta para la coincidencia de reglas.</td></tr></tbody></table>

## Configuración de Smart Suggestion

Se puede configurar un máximo de 100 sugerencias inteligentes.

### Configuración de Smart Suggestion desde Commander Central

Inicie sesión en Commander Central. Vaya a **Promos and Discounts > Smart Suggestions** para configurar Smart Suggestions.

Ir a **Smart Suggestions > General Settings** para habilitar o deshabilitar las sugerencias inteligentes.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FYmj1MAylb8EmeLW54Bof%2Fimage.png?alt=media&amp;token=6a05406a-47e6-44df-be5b-4dd30566fcff" alt=""><figcaption></figcaption></figure>

Ir a **Smart Suggestions > Offer Configurations** para configurar las sugerencias inteligentes.

![](https://content.gitbook.com/content/5nJgnNKJ9ZrZeEdr7pqh/blobs/GWLUOJq3M91CsmuvBKFI/images/image1.png)

{% stepper %}
{% step %}
Haga clic en **Agregar** para agregar una Smart Suggestion.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FK7EzzUlw8SVsC2PnHIF2%2Fimage.png?alt=media&amp;token=5f148206-b0c5-40e4-86ae-a97f53671b1b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Seleccione **Habilitar**. Ingrese el nombre, la descripción y la prioridad de la Smart Suggestion. Un número más bajo significa una prioridad más alta. Dejar el campo en blanco o ingresar `0` otorga la prioridad más alta.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FgIKj5oxVIifFKJ1R8CKB%2Fimage.png?alt=media&amp;token=889ad56e-e88a-45ad-a665-40d91755799f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure la siguiente sección: **Parámetros de la oferta**.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FYz0MSYZaZshtfAibSHNk%2Fimage.png?alt=media&amp;token=0c04c4e3-b4bd-453e-b614-7910d24ae4a0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
En el **Apariencia del aviso** sección, agregue el mensaje del aviso y la imagen. Si configura esta sección sin artículos de aviso, la Smart Suggestion será una sugerencia solo de mensaje.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2F9JidvpNYqAWJan18a6RB%2Fimage.png?alt=media&amp;token=1ed59dbf-a134-4f3a-af39-fb4866ecd208" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
En el **Artículos del aviso** sección, seleccione el artículo del aviso.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FLtPFudOAP3mgLn8RYfEx%2Fimage.png?alt=media&amp;token=6355c4d1-7e24-4a75-a37b-ea3e885b4d1f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Al seleccionar **PLU** y hacer clic en **Agregar** muestra una lista de PLU. Use filtros por UPC, descripción o precio.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FGUH0dnShKLEJaxFicpuq%2Fimage.png?alt=media&amp;token=5c2afaf3-7da8-462f-9679-8a1b0a74cef8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FMEPrcR1fDc7advswnYdo%2Fimage.png?alt=media&amp;token=1e532163-f844-4ed7-ae44-adcd0d99f920" alt=""><figcaption></figcaption></figure>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2F7XjWCuJ8WH438tpiVyjH%2Fimage.png?alt=media&amp;token=b266daca-b8ed-49e1-99e9-d17d84a5bd44" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Al seleccionar **Menú** y hacer clic en **Agregar** muestra una lista de menús. Use filtros por ID de menú, nombre de menú o tipo de menú.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FFYKsaFQlmOt0QnlF0dz3%2Fimage.png?alt=media&amp;token=658b2461-7be1-40f0-a9cf-08ea87b0d378" alt=""><figcaption></figcaption></figure>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2Fr2qPnHMjSWS1Ro5dNJ1m%2Fimage.png?alt=media&amp;token=75ca01a3-c534-4228-8104-a711f1f3894a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2F5UlnxHhCUJpYep3hhVbo%2Fimage.png?alt=media&amp;token=0e3f0271-6024-4812-9423-18db2395a4b6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Al seleccionar **Mezcla y combina** y hacer clic en **Agregar** muestra una lista de artículos de mezcla y combina.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2F1BtsScYriav8sAgzVzpc%2Fimage.png?alt=media&amp;token=e3ff1651-ebd9-481d-862f-bda0dceec3bc" alt=""><figcaption></figcaption></figure>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FQ9CJgSP8di7DjgNdPHos%2Fimage.png?alt=media&amp;token=74070b2a-9a9b-4cae-8a72-ab8c765de816" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Al seleccionar **Combo** y hacer clic en **Agregar** muestra una lista de artículos combinados.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FauSWVZdUOPFyF8Fl8F5j%2Fimage.png?alt=media&amp;token=ec8830d6-8f23-4ce1-9d0e-f5103a6bd451" alt=""><figcaption></figcaption></figure>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FIlmIo2rikYykYOYXvK0d%2Fimage.png?alt=media&amp;token=b40608b0-71fc-4616-8d29-8dfe81aa32d5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Se pueden seleccionar varios artículos para cada tipo de aviso. Haga sus selecciones y haga clic en **Agregar/Confirmar**.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FS9xRFDspfQnypgYlDXLn%2Fimage.png?alt=media&amp;token=6573ad7d-ad60-4e2e-8e94-031c3d9101ba" alt=""><figcaption></figcaption></figure>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FfnyndAP2BxS1Bak7XgZc%2Fimage.png?alt=media&amp;token=35b0c89d-32e3-4107-a44c-579006814bf9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Para el tipo de aviso PLU, use **Permitir selección de cantidad**. Esto agrega controles de más y menos junto al PLU, lo que permite a los usuarios aumentar o disminuir la cantidad.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FZbaAhiXzV9v6mVTzf60D%2Fimage.png?alt=media&amp;token=58b6b841-06c8-410b-923f-4185ee3f6190" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Para los tipos de aviso PLU y menú, puede agregar imágenes al panel de Smart Suggestion.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2F8HGPEm321UY0QuDZANiB%2Fimage.png?alt=media&amp;token=4deaefe2-b8a3-4e26-9562-59fc4c5265c7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Después de configurar todos los campos, haga clic en **Crear oferta**.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2Fz16cB4VV5LNmBrLktd25%2Fimage.png?alt=media&amp;token=217fe0fb-71dd-4156-97b7-317ea4192227" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Usar **Duplicar** para copiar una Smart Suggestion configurada y luego realizar los cambios necesarios.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FKSCq21Fyo8bFnOx60I5Z%2Fimage.png?alt=media&amp;token=c73978bb-8e7c-4d6e-9bdd-3f48f497149c" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Configuración del PIN pad

En el POS, vaya a **CSR > Maintenance > Device Configuration > PIN Pad Configuration**. Seleccione **EPS PINPAD** con el swipe-ahead deshabilitado.&#x20;

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FrIOa7uHJBE53EmMmqras%2Fimage.png?alt=media&amp;token=95ccd939-92cf-4686-9ee5-09a45cdcec24" alt=""><figcaption></figcaption></figure>

## Uso de Smart Suggestion en el POS

### Uso diario -- Aceptar una sugerencia (pasos rápidos del cajero)

{% stepper %}
{% step %}

### Registre los artículos del cliente como de costumbre

Escanee artículos, use el panel de artículos o seleccione un menú.
{% endstep %}

{% step %}

### Presione Total

Si la canasta coincide con una regla activa, aparece el panel de sugerencias.
{% endstep %}

{% step %}

### Lea el aviso al cliente

Por ejemplo, "¿Le gustaría agregar uno de estos hoy?"
{% endstep %}

{% step %}

### Si el cliente acepta

Toque los mosaicos de producto, use + / − para establecer la cantidad y luego toque Agregar al carrito.
{% endstep %}

{% step %}

### Si el cliente rechaza

Toque No, gracias (o la X). La pantalla de cobro aparece de inmediato: no presione Total nuevamente.
{% endstep %}

{% step %}

### Complete el pago como de costumbre

Efectivo, crédito/débito EMV, toque o deslice.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Es bueno saber:** Si se agregaron artículos desde el panel y el sitio usa la bandera Subtotal requerido, el POS muestra "SUBTOTAL REQUERIDO" al cobrar: solo presione Total una vez más y cobre normalmente.
{% endhint %}

Los artículos aceptados desde el panel aparecen en el recibo como líneas de venta regulares. En el ejemplo siguiente, ITEM E ×3 se agregó desde el panel de sugerencias e imprime junto con los artículos registrados normalmente:

![](https://content.gitbook.com/content/5nJgnNKJ9ZrZeEdr7pqh/blobs/B8ehmppVG0NTvSAHrtNy/images/image2.png)

Recibo de una transacción con venta adicional: "ITEM E 3 29.94" se agregó mediante el panel de sugerencias; los descuentos NAXML y los reembolsos de impuestos se aplican después de que los artículos ingresan a la canasta.

### Flujo de la transacción

<table><thead><tr><th width="200">Paso / Actor</th><th>Acción</th></tr></thead><tbody><tr><td>1 -- Cajero / Cliente</td><td>Los artículos se agregan a la canasta de la transacción (escaneados, tocados en el panel de artículos o seleccionados de un menú).</td></tr><tr><td>2 -- Cajero / Cliente</td><td>Se presiona el botón Total para iniciar el pago.</td></tr><tr><td>3 -- Commander</td><td>El motor VIP/NAXML evalúa la canasta frente a las reglas activas de Smart Suggestion. Si se encuentra una coincidencia, la carga útil de la sugerencia se devuelve al POS.</td></tr><tr><td>4 -- POS</td><td>La superposición del panel de sugerencias se muestra sobre la pantalla de pago: una imagen de título, un mensaje de aviso configurable, hasta cuatro mosaicos de productos sugeridos (imagen, nombre, precio), una línea de descargo de responsabilidad y los botones "Agregar al carrito" / "No, gracias", además de un icono de cerrar (X).</td></tr><tr><td>5a -- Ruta de aceptación</td><td>El cajero o el cliente toca uno o más mosaicos de producto, opcionalmente ajusta la cantidad con la barra de cantidad en línea (+ / −) y toca "Agregar al carrito". Los artículos seleccionados se agregan a la canasta.</td></tr><tr><td>5b -- Ruta de rechazo</td><td>El cajero o el cliente toca "No, gracias" (o el icono de cerrar X). El panel se cierra sin modificar la canasta, y la transacción pasa al pago de inmediato: no se requiere una segunda pulsación de Total.</td></tr><tr><td>6 -- POS</td><td>El flujo de pago continúa normalmente (cobro en efectivo, inserción/toque/deslizamiento de tarjeta, etc.).</td></tr></tbody></table>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FckHLm6jXeQ7EADfDLtf6%2Fimage.png?alt=media&amp;token=aa4b23e8-89cd-4618-abc8-5270b631724d" alt=""><figcaption></figcaption></figure>

<p align="center"><strong>Aviso de Smart Suggestion solo de mensaje</strong></p>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FeB2acHAx0zMr7Gj2GbON%2Fimage.png?alt=media&amp;token=d2981c77-bbf1-4f1a-ab4a-d67f7b7d4376" alt=""><figcaption></figcaption></figure>

<p align="center"><strong>Aviso de Smart Suggestion de menú</strong> — Al seleccionar cualquier artículo se abre ese menú.</p>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2F67UCJcUuPsJDzk7GZQu8%2Fimage.png?alt=media&amp;token=5d7ee3e9-5ed7-4020-b36c-18530bfea51f" alt=""><figcaption></figcaption></figure>

<p align="center"><strong>Aviso de Smart Suggestion de PLU</strong> - Al seleccionar un mosaico de producto se muestra la barra de cantidad en línea con controles de cantidad '−' y '+'</p>

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FvOHAiB3QQwylDW9d3Bye%2Fimage.png?alt=media&amp;token=e4a7d005-bea3-42f1-80fc-28a02ed93d29" alt=""><figcaption></figcaption></figure>

<p align="center">Aviso de Smart Suggestion combinado</p>

### Administración de cantidades

Cuando un cajero o cliente selecciona un mosaico de producto, aparece una barra de cantidad en línea dentro del mosaico. La cantidad predeterminada es 1. El cajero puede aumentarla usando el botón '+' hasta el máximo configurado y disminuirla con '−'. Se pueden seleccionar varios productos diferentes dentro de una sola interacción con el panel; cada uno acumula su propia cantidad antes de la confirmación final "Agregar al carrito". Los artículos configurados como no ajustables se agregan con cantidad 1 sin una barra ajustable, y los artículos de cantidad fraccionaria siguen su configuración de PLU.

### Comportamiento al rechazar

Al tocar "No, gracias" (o el icono de cerrar X) se cierra inmediatamente el panel de sugerencias. La canasta de la transacción no cambia y el POS pasa directamente a la pantalla de cobro/pago sin requerir que el cajero presione Total por segunda vez. Esta es una decisión de diseño de UX deliberada para evitar penalizar a los cajeros que ofrecen la sugerencia y esta es rechazada.

### Artículos con restricción de edad

Si la canasta de la transacción contiene un artículo con restricción de edad, el POS muestra el aviso de verificación de edad antes de que se muestre el panel de sugerencias. Una vez que el cajero confirma el cumplimiento de edad, el flujo continúa normalmente y el panel de sugerencias se muestra como de costumbre. Si se ofrece un producto con restricción de edad dentro del panel y se agrega al carrito, se activa para ese artículo la solicitud estándar de VERIFICAR ID, tal como ocurriría en una venta regular. Las restricciones por ley azul y por no venta también se aplican a los artículos sugeridos.

### Bandera de subtotal requerido

Cuando el sitio está configurado con la bandera "Subtotal requerido" habilitada, agregar artículos desde el panel de sugerencias cambia el total de la canasta. En este escenario, al tocar el botón de cobro Efectivo o Tarjeta después de agregar artículos de venta adicional se muestra un mensaje de "SUBTOTAL REQUERIDO", que indica al cajero que presione Total nuevamente para actualizar el subtotal antes de cobrar. Este es un comportamiento estándar y coherente con la forma en que funciona la bandera para cualquier agregado de artículos a mitad de transacción. Los sitios con la bandera "total requerido" deshabilitada pasan directamente al cobro.

### Ventas básicas con sugerencias PLU

| Escenario en el POS                                                                                     | Comportamiento verificado                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Escanee artículos, presione Total, agregue un producto sugerido y pague en efectivo                     | El panel muestra un mensaje de aviso, cuatro mosaicos de producto con precios, el descargo de responsabilidad y ambos botones; el artículo seleccionado se agrega con cantidad 1; el recibo y el registro de la transacción son correctos |
| Agregar un producto sugerido con la cantidad aumentada a 3 mediante '+'                                 | La barra de cantidad incrementa correctamente; las 3 unidades se agregan y se cobran en el recibo                                                                                                                                         |
| Registre un producto normalmente y luego agregue 4 más de un producto sugerido                          | Las cantidades regulares y de venta adicional se combinan correctamente en la canasta                                                                                                                                                     |
| Escanee un artículo, acepte una sugerencia, pague con crédito EMV                                       | El panel se completa antes del flujo de tarjeta; la inserción/toque EMV continúa normalmente                                                                                                                                              |
| Seleccione varios productos diferentes en una sola sesión del panel con cantidades individuales         | Cada mosaico conserva su propia cantidad; todas las selecciones se agregan con un solo "Agregar al carrito"                                                                                                                               |
| Active la sugerencia desde un artículo de menú expandido en lugar de un escaneo                         | Las entradas de canasta basadas en menú coinciden con las reglas de la misma manera que los PLU escaneados                                                                                                                                |
| Activar desde un artículo de menú superpuesto y luego rechazar                                          | El panel aparece para los activadores de menú; al rechazar, la canasta no cambia                                                                                                                                                          |
| Venta de departamento en la canasta junto con artículos que activan la sugerencia                       | Las ventas de departamento coexisten con el panel; los artículos de venta adicional se agregan normalmente                                                                                                                                |
| Repetición de los flujos principales de aceptar/rechazar con la bandera 'total requerido' deshabilitada | Con la bandera desactivada, el cobro continúa sin una segunda pulsación de Total en todos los caminos                                                                                                                                     |

### Comportamiento al rechazar y del aviso

| Escenario en el POS                                                       | Comportamiento verificado                                                                                                    |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Toque "No, gracias" en el aviso                                           | Panel cerrado, canasta sin cambios, pantalla de cobro mostrada de inmediato: no se necesita un segundo Total                 |
| Seleccione primero un mosaico y luego toque "No, gracias"                 | Selección descartada; no se agrega nada; pasa directo al cobro                                                               |
| Toque "Agregar al carrito" repetidamente sin seleccionar ningún producto  | Las pulsaciones se ignoran de forma segura; el panel permanece abierto hasta que se elige un producto o se rechaza la oferta |
| Rechazar, seguir vendiendo, presionar Total nuevamente                    | El panel vuelve a aparecer en Totales posteriores mientras los artículos desencadenantes permanezcan en la canasta           |
| Varios productos desencadenantes en la canasta y luego rechazar           | Se muestra un solo panel; la ruta de rechazo es idéntica sin importar cuántos desencadenantes coincidieron                   |
| Presione Ayuda mientras el panel está en pantalla                         | La superposición de ayuda funciona; luego el flujo de sugerencias se reanuda correctamente                                   |
| Agregar más productos a la venta después de completar una venta adicional | La entrada de artículos posterior a la venta adicional no se ve afectada; los totales son correctos                          |

### Límites de cantidad y tipos especiales de PLU

| Escenario en el POS                                                        | Comportamiento verificado                                                                             |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Aumente la barra de cantidad más allá del máximo configurado               | "+" se detiene en el máximo; las pulsaciones adicionales no tienen efecto                             |
| Aceptar un PLU sugerido configurado como cantidad no ajustable             | Artículo agregado con cantidad fija 1; no se ofrece barra ajustable                                   |
| Aumentar y luego disminuir la cantidad antes de confirmar                  | "−" funciona de manera simétrica; la cantidad final confirmada es la que se agrega                    |
| PLU sugerido con una restricción de cantidad de venta                      | El POS aplica el límite de cantidad del PLU incluso cuando se agrega mediante venta adicional         |
| PLU de precio abierto ofrecido en el panel                                 | Se muestra un aviso de ingreso de precio cuando el PLU de precio abierto se agrega desde el panel     |
| PLU de cantidad fraccionaria ofrecido en el panel                          | El manejo de cantidad fraccionaria sigue la configuración del PLU                                     |
| PLU configurado para solicitar un número de serie                          | Se muestra el aviso de número de serie para el artículo de venta adicional, como en una venta regular |
| Cambiar la cantidad de un artículo de la canasta antes y después del aviso | Las ediciones de cantidad fuera del panel no corrompen la selección de venta adicional                |

### Artículos restringidos

| Escenario en el POS                                                                              | Comportamiento verificado                                                                                                    |
| ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| Artículo con restricción de edad en la canasta, luego aceptar una sugerencia y pagar con crédito | VERIFICAR ID se ejecuta antes del panel; la venta adicional y el pago EMV continúan normalmente después de confirmar la edad |
| Producto con restricción de edad ofrecido dentro del panel                                       | Al agregarlo, se muestra la solicitud estándar de VERIFICAR ID para ese artículo                                             |
| PLU restringido por ley azul ofrecido en el panel                                                | Las restricciones de horario de ley azul se aplican a los artículos sugeridos                                                |
| PLU marcado como 'no vendido' ofrecido en el panel                                               | La restricción de no venta bloquea el artículo exactamente igual que en una venta regular                                    |
| PLU sugerido sin banderas de excepción                                                           | Línea base: los PLU sin restricciones se agregan sin avisos adicionales                                                      |

### Correcciones, anulaciones, suspensiones y reembolsos

| Escenario en el POS                                                             | Comportamiento verificado                                                                      |
| ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Anular línea en un artículo agregado desde el panel                             | Las líneas de venta adicional se anulan como cualquier otra línea; los totales se recalculan   |
| Anular todo el ticket después de una venta adicional                            | Se admite la anulación completa después de aceptar una venta adicional                         |
| Presione Anular mientras el panel está en pantalla                              | La anulación tiene prioridad; el panel se maneja limpiamente                                   |
| Presione Corrección de error mientras el panel está en pantalla                 | Se corrige la última línea; el flujo de sugerencias se mantiene estable                        |
| Suspender la venta mientras el panel está en pantalla                           | La venta se suspende; el estado del panel no bloquea la suspensión                             |
| Suspender y luego recuperar una venta que incluya venta adicional               | La recuperación restaura la canasta; el comportamiento de sugerencia es coherente al recuperar |
| Transacciones de reembolso, incluida la suspensión/recuperación de un reembolso | El panel de sugerencias no interfiere con los flujos de reembolso                              |
| Aceptar una venta adicional con la bandera de subtotal requerido habilitada     | Se muestra "SUBTOTAL REQUERIDO" al cobrar; un segundo Total actualiza y el cobro se completa   |

### Transacciones de combustible

| Escenario en el POS                                                                          | Comportamiento verificado                                                                      |
| -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Venta de combustible prepago, aceptar un producto sugerido                                   | El panel se muestra en prepago; el artículo se agrega y el combustible se autoriza normalmente |
| Prepago con un faltante (el cliente carga menos de lo pagado)                                | No hay aviso de sugerencia durante la finalización del faltante, por diseño                    |
| Combustible prepago, rechazar la sugerencia                                                  | La ruta de rechazo es idéntica con combustible en la canasta                                   |
| Venta de combustible pospago: rutas de aceptar y rechazar                                    | El panel aparece al totalizar el combustible adeudado; ambas rutas verificadas                 |
| "Rest in gas": el resto del efectivo se aplica al combustible después de una venta adicional | El monto de rest in gas se calcula después de incluir los artículos de venta adicional         |

### Sugerencias en el PIN pad

Con el tipo de sugerencia de la pantalla del PIN pad configurado, la oferta se presenta al cliente en la terminal de pago en lugar de (o junto con) la pantalla del cajero:

| Escenario en el POS                                                                                   | Comportamiento verificado                                                                       |
| ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Sugerencia visible para el cliente, venta pagada en efectivo                                          | La sugerencia se muestra en el PIN pad; el cobro en efectivo se completa                        |
| Sugerencia aceptada, pagada con débito y devolución de efectivo                                       | El flujo de débito y devolución de efectivo no se ve afectado por la venta adicional            |
| Anular línea después de una venta adicional en el PIN pad, pagada con débito y devolución de efectivo | Las correcciones funcionan después de la aceptación en el PIN pad                               |
| Diferentes PLU desencadenantes para la oferta en el PIN pad                                           | La coincidencia de reglas es idéntica a la del panel del POS                                    |
| El cliente cancela en el PIN pad / el cajero cancela en el POS                                        | Cualquiera de las dos partes puede cancelar; la transacción continúa hacia el cobro             |
| El cliente rechaza; verifique que el aviso se cierre                                                  | El rechazo cierra limpiamente la oferta del PIN pad                                             |
| Ventas de combustible prepago, pospago y resto en gasolina con sugerencias en el PIN pad              | Se verificaron los tres flujos de combustible con la oferta visible para el cliente             |
| Swipe-ahead deshabilitado y habilitado durante las sugerencias del PIN pad                            | El comportamiento de deslizamiento anticipado de la tarjeta se respeta en ambas configuraciones |

### Tipos de sugerencia de menú y solo mensaje

| Escenario en el POS                                                                    | Comportamiento verificado                                                                              |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Venta básica con una sugerencia de tipo menú                                           | El panel ofrece un menú; los artículos del menú elegidos se agregan a la canasta                       |
| Sugerencia de menú con subtotal requerido / no requerido                               | El comportamiento de la bandera de subtotal es coherente para las ofertas de tipo menú                 |
| Rechazar una oferta de menú; comportamiento al volver a abrir; selección de menú vacía | Se verificaron las reglas de reaparición del panel para el tipo de menú                                |
| Menú de selección múltiple, incluido el descuento NAXML en un subartículo              | Se agregaron varias selecciones de menú; se aplicaron descuentos en subartículos                       |
| Menú exprés ofrecido en el panel                                                       | Los menús exprés son compatibles como contenido de sugerencia                                          |
| Prepago (incluido faltante), pospago y resto en gasolina con sugerencias de menú       | Los flujos de combustible se verificaron para el tipo de sugerencia de menú; no hay aviso en faltantes |
| Sugerencia solo de mensaje, pagada en efectivo / crédito                               | El mensaje se muestra sin mosaicos de productos; la venta se completa normalmente                      |
| Seguir escaneando mientras se muestra una sugerencia de mensaje                        | El aviso del mensaje se elimina a medida que se escanean/seleccionan más artículos                     |
| Sugerencia solo de mensaje en el PIN pad                                               | Se verificó la variante de mensaje visible para el cliente                                             |

### Autoservicio (C18 SCO)

| Escenario en el POS                                                                         | Comportamiento verificado                                                                                |
| ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Cambie el POS de carril ↔ SCO mediante App Selector                                         | Las sugerencias funcionan en cualquiera de los lados del cambio de modo                                  |
| El cliente escanea artículos y realiza el pago; valida todos los avisos del panel           | El panel se muestra al cliente con el mismo diseño y texto                                               |
| El cliente rechaza mediante "No, gracias" o el icono X; se verifica la reaparición          | Se verificaron ambas rutas de rechazo; el pago continúa sin una segunda pulsación                        |
| El cliente pide un menú normalmente y agrega varios productos de venta adicional            | Se verificó en SCO la venta adicional de menú + múltiples productos                                      |
| Requisitos de pulsación de Checkout después de rechazar versus después de aceptar artículos | Rechazar: no se necesita volver a pulsar. Aceptar: presione Checkout nuevamente para actualizar el total |
| Cerrar/reaparecer el panel en pulsaciones repetidas de Checkout                             | El cliente aún puede agregar artículos sugeridos en un Checkout posterior                                |
| Ayuda presionada durante una sugerencia en SCO                                              | La ayuda está disponible a mitad de la oferta; el flujo se reanuda                                       |
| Venta adicional con restricción de edad en SCO (modo asistido por cajero)                   | La verificación de edad se redirige al asistente según se requiere                                       |
| Se eligió 'Pagar en caja' antes / después de agregar artículos de venta adicional           | Ambas rutas de pago en caja mantienen intactos los artículos de venta adicional                          |
| Artículos ajustables vs. no ajustables, cantidad máxima, límite de cantidad en SCO          | Las reglas de cantidad se aplican de la misma manera en el autocobro                                     |
| Prepago de combustible en SCO con una sugerencia de PLU                                     | Prepago de combustible desde el SCO con venta adicional verificada                                       |
| Tipos de sugerencias de menú y mensaje en SCO, incl. verificación de edad desde un menú     | Los tres tipos de sugerencias funcionan en modo de autocobro                                             |

### Ofertas NAXML (combos y mezcla / combinación)

Las sugerencias suelen ofrecer el artículo que completa una oferta. La nota '\*Los descuentos se aplican después de agregar los artículos al carrito' refleja que el motor NAXML vuelve a evaluar la cesta después de que se agregan los artículos de venta adicional:

| Escenario en el POS                                                                                                                                                                                                                                            | Comportamiento verificado                                                                                                                                                     |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sugerencias basadas en combos: combo de lavado de auto, combo de verificación de edad, múltiples activadores de PLU, varias ofertas de combo, combos con nuevo precio, múltiples combos, artículos activadores, persistencia al cerrar sesión e iniciar sesión | Las ofertas de combo se forman correctamente cuando el artículo que las completa se agrega desde el panel; las reglas sobreviven al cerrar sesión e iniciar sesión del cajero |
| Combo con precio nuevo, descuento por monto, descuento por porcentaje                                                                                                                                                                                          | Los tres métodos de precios NAXML se aplican a los artículos agregados desde el panel                                                                                         |
| Combo con rebaja de impuestos (se agregan uno y dos artículos)                                                                                                                                                                                                 | La rebaja de impuestos se calcula sobre el precio descontado del combo (ver ejemplo de recibo en 5.1)                                                                         |
| Varios combos en una transacción; agregar un combo más desde la oferta                                                                                                                                                                                         | Se verificó el apilamiento de ofertas y los combos repetidos                                                                                                                  |
| Reembolso de un combo formado mediante venta adicional; rechazo de una oferta de combo                                                                                                                                                                         | Los totales del reembolso coinciden; al rechazar, las ofertas previas permanecen intactas                                                                                     |
| Combo de lavado de auto mediante sugerencia                                                                                                                                                                                                                    | Se emitió el código de lavado de auto con el descuento del combo aplicado                                                                                                     |
| Ofertas de Mezcla y Combina: elegir un artículo de la oferta desde el panel (incluida la selección desde el panel inferior, lista 'Mostrar más', activador de artículo de departamento), descartar con X o 'No, gracias'                                       | Los combos de Mezcla y Combina se completan desde selecciones del panel; se verificaron las listas de 'Mostrar más' de N artículos y ambas rutas de descarte                  |

### Lealtad, caridad y propinas

| Escenario en el POS                                                                                                         | Comportamiento verificado                                                                                               |
| --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Venta con venta adicional, tarjeta de lealtad y una donación benéfica                                                       | Los descuentos de lealtad y los avisos de caridad coexisten con el Panel de sugerencias                                 |
| Combustible de prepago / pospago con venta adicional, lealtad, propina y caridad, pagado con débito y reembolso en efectivo | Todo el conjunto: venta adicional + lealtad + propina + caridad + reembolso en efectivo, finaliza con totales correctos |

{% hint style="info" %}
**Informes:** El caso automatizado PETROCORE-137130 verifica el informe Flash (Resumen) después de la actividad de venta adicional: los artículos agregados mediante Sugerencia inteligente aparecen como líneas de venta estándar en los totales del período. Consulte la Sección 10.
{% endhint %}

## Comportamientos conocidos y casos límite

<table><thead><tr><th width="282">Escenario</th><th>Comportamiento esperado</th></tr></thead><tbody><tr><td>Se tocó 'Agregar al carrito' sin seleccionar un producto</td><td>La pulsación del botón se acepta, pero no se agregan artículos. El panel permanece abierto. El cajero debe seleccionar un mosaico de producto o tocar 'No, gracias' para continuar.</td></tr><tr><td>Se tocó 'No, gracias' después de seleccionar un mosaico de producto</td><td>La selección se descarta. No se agregan artículos. El panel se cierra y la transacción continúa al pago sin un segundo Total.</td></tr><tr><td>Panel descartado mediante el ícono X de cierre</td><td>Equivale a 'No, gracias': no se agrega nada y la transacción continúa.</td></tr><tr><td>Cantidad máxima alcanzada en la barra de cantidad</td><td>El botón '+' deja de incrementar al máximo configurado. Los toques adicionales no tienen efecto.</td></tr><tr><td>Se presionó Anular / Corregir error / Suspender mientras el panel estaba abierto</td><td>La operación de caja surte efecto; el panel se maneja correctamente y la transacción se mantiene consistente.</td></tr><tr><td>Falta de prepago de combustible</td><td>No se muestra ningún aviso de sugerencia al completar un reembolso por falta de prepago; así está diseñado.</td></tr><tr><td>El Panel de sugerencias aparece en SCO</td><td>El panel se muestra al cliente en la pantalla táctil C18 en modo de autocobro, sin requerir intervención del cajero.</td></tr><tr><td>La cesta no coincide con ninguna regla activa</td><td>No se muestra el Panel de sugerencias. La transacción pasa directamente a la pantalla de pago después de Total.</td></tr><tr><td>Varios productos seleccionados en una sesión del panel</td><td>Cada mosaico de producto mantiene su propia cantidad. Todos los productos seleccionados se agregan a la cesta con un solo toque en 'Agregar al carrito'.</td></tr><tr><td>Propagación de reglas en curso</td><td>Las reglas enviadas mediante la API tardan aproximadamente 18 segundos en propagarse. Las transacciones iniciadas dentro de esta ventana quizá aún no vean las nuevas reglas.</td></tr></tbody></table>

## Informes

Las transacciones de Sugerencia inteligente se capturan en los informes estándar por período de Verifone disponibles en Verifone Commander. El informe principal que se usa para verificar la actividad de venta adicional es el Informe Flash (Informe de resumen).

### Informe Flash / Informe de resumen

El Informe Flash proporciona un resumen a nivel de cajero y de período de todas las transacciones procesadas durante un turno o período de informes. Cuando se agregan artículos de Sugerencia inteligente a una transacción, se registran como artículos de venta normales en el registro de la transacción y aparecen en los totales del período dentro de este informe.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verifone.com/feature-references/feature-references-lac-es/referencias-de-funciones-y-productos/sugerencia-inteligente.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.