Entender los estados y las transferencias de ofertas

La superficie Offers definida por el código fuente puede mostrar promociones devueltas para una sesión y un contexto de pedido. La visibilidad de las ofertas es informativa. No demuestra que se puedan usar en el carrito, que se hayan aplicado, ni que su precio, compatibilidad de pago o pedido se hayan confirmado.

:::warning Límites importantes La lista, la búsqueda local, los detalles, el paso al comercio, la validación del carrito y la aplicación final de la oferta son estados distintos. Que cambie la pantalla o que haya aparecido antes una tarjeta no constituye un comprobante autorizado de la oferta. :::

Estados de la lista de ofertas

Estado	Interpretación segura
Entrada no disponible	No se ha establecido un destino Offers actual para el estado visible de la sesión.
Cargando	La lectura de ofertas sigue pendiente; los marcadores de posición son solo una presentación.
Lista recibida	Se muestran tarjetas de una generación del código fuente; la elegibilidad actual es independiente.
Vacía	El estado recibido no muestra tarjetas.
Error	La lectura actual no produjo un estado de lista aceptado.
Se conservan tarjetas anteriores	Se desconoce si están actualizadas y autorizadas.
Cambió el contexto	Las ofertas anteriores pueden estar obsoletas tras un cambio de ubicación, contexto del pedido, cuenta o proyecto.

Estados de las tarjetas y de la búsqueda local

Una tarjeta de oferta puede mostrar un nombre, el vencimiento indicado, una imagen opcional y un control View. La búsqueda local puede filtrar los nombres de las ofertas ya cargadas. No busca en todo el servicio ni valida descripciones, nombres de comercios, datos de cupones o aplicabilidad al carrito.

El texto de búsqueda, las filas filtradas y la lista cargada pueden diferir después de errores o cambios de contexto. Mantén la lista como obsoleta o desconocida en vez de repetir lecturas.

Estados de los detalles

Offer Details puede mostrar condiciones opcionales recibidas, como el valor indicado, la descripción, el destino, los mínimos y máximos, un aviso de oferta automática, información sobre el tipo de cupón o los comercios asociados. Que falten campos opcionales no permite concluir nada por separado sobre la elegibilidad.

Abrir View solo transfiere a los detalles locales. No aplica, reserva, valida ni consume una oferta.

Paso al comercio

Si aparece una fila de comercio recibida, Go to business puede iniciar el paso a la página de ese comercio. Esto no demuestra que se haya cargado el destino, que la oferta siga vigente para ese comercio ni que el carrito pueda usarla.

La confirmación del cupón del carrito y de las ofertas automáticas corresponde al responsable del carrito. La superficie Offers no controla un procedimiento de compra, cupón o aplicación.

Lecturas fallidas, obsoletas y desconocidas

Un error inicial puede reemplazar las tarjetas. También puede fallar una lectura posterior mientras aún haya estado local previo. Sin evidencia actual del tiempo de ejecución, no afirmes que existe un diseño específico que combine ambos estados ni que se haya actualizado la información anterior.

Si falla una lectura, conserva el resultado como obsoleto o desconocido. No repitas acciones de actualización o solicitud para diagnosticarlo. Usa solo un control de retorno de la aplicación que ya esté presente y verificado.

Privacidad y accesibilidad

Los nombres de las ofertas, la información sobre el tipo de cupón, las condiciones mostradas, los comercios, las imágenes, el contexto de ubicación o pedido, la cuenta, la sesión y el texto de búsqueda pueden revelar información privada o comercial. Los informes de soporte deben usar estados sin valores, como «lista de ofertas obsoleta», «detalles no disponibles» o «paso al comercio sin resolver».

Las tarjetas, las imágenes opcionales, la búsqueda, el modal de detalles, el control para cerrar, las filas de comercios, los estados de carga, vacío, error y obsoleto, la contención y devolución del foco, el texto grande, la semántica para lectores de pantalla, el teclado y Back requieren verificación independiente en la plataforma actual.

Solución segura de problemas

• Si no aparece la entrada Offers, no deduzcas la causa a partir de la sesión o la configuración.
• Si la búsqueda no encuentra coincidencias, distingue el filtro local de la lista completa recibida.
• Si faltan campos opcionales de los detalles, no infieras una regla general de elegibilidad.
• Si no se confirma el paso al comercio, déjalo sin resolver y no infieras que se aplicó la oferta.
• Si falla una lectura, conserva el estado obsoleto o desconocido sin actualizar repetidamente ni informar ubicación, proyecto, hora, tipo de pedido, comercio, cuenta o valores de la oferta.

Guías relacionadas: Elegir una ubicación · Elegir tipo y horario del pedido · Entender los estados de descubrimiento de comercios · Abrir la página de un comercio · Entender los estados de los cupones