Entender los estados de cupones y ofertas

Customer App puede mostrar un campo para ingresar un cupón, el estado de cupón devuelto o filas de descuento asociadas a ofertas para el carrito o pago actuales. Son etapas distintas locales, del servidor, del carrito, los totales y la analítica. Que aparezca un campo, se ingrese texto, se devuelva una fila o cambie el total no demuestra elegibilidad, consumo, descuento final ni que sea seguro realizar el pedido.

Las acciones de cupón cambian el carrito y el estado financiero

Esta referencia no indica cómo aplicar, reemplazar, quitar ni probar un cupón. Nunca uses un código real ni repitas una acción para averiguar si se completó una solicitud anterior.

Los flujos heredado/manual y avanzado son distintos

Flujo	Límite de la fuente actual	Distinción importante
Cupón heredado/manual	El campo puede solicitar un cambio de cupón en el carrito y después mostrar el cupón devuelto o su eliminación.	Aplicar y quitar usan una ruta heredada del carrito; la presentación de éxito/error/telemetría es limitada.
Cupón avanzado asociado a una oferta	Un valor de cupón puede solicitar un cambio asociado a una oferta en el carrito, y las filas devueltas pueden mostrar el estado aceptado.	Aplicación, rechazo, eliminación, resúmenes y analítica usan eventos y estados distintos.
Estado de oferta automática	El carrito devuelto puede incluir ofertas aunque el campo manual no haya sido el origen.	Que aparezca no demuestra que el cliente haya ingresado o consumido un cupón.
Cupón para varios negocios	Los controles por grupo o carrito pueden iniciar varias operaciones de carrito.	No hay una transacción de cupón de grupo atómica aceptada ni una reversión unificada.

La eliminación heredada y la eliminación de una fila de oferta avanzada no son pruebas intercambiables. La fuente actual no establece un flujo universal de cupones.

Ingresado, visible, aplicado y quitado son estados distintos

Estado	Interpretación segura	Qué no demuestra
Campo vacío	No hay un valor local listo para enviar.	Disponibilidad o ausencia de cupones.
Texto ingresado	Hay un valor privado visible en el campo.	Elegibilidad, actualización de solicitud ni consentimiento para analítica.
Evento analítico de valor ingresado	La interfaz registró un intento antes del resultado.	Que la solicitud haya tenido éxito/fallado o tuviera una identidad válida de carrito.
Solicitud pendiente	Puede haber una o más operaciones de carrito/oferta en curso.	Comportamiento de solicitud única, intención actual ni totales finales.
Fila de cupón u oferta devuelta	El carrito devuelto contiene estado de cupón/oferta para una revisión.	Consumo duradero, incompatibilidad con ofertas combinadas, realización del pedido ni éxito para todo el grupo.
Control Quitar o fila desaparecida	Cambió la presentación o respuesta de eliminación.	Que se hayan actualizado el descuento, uso, carrito, total y analítica.
Error mientras sigue visible el texto	El campo visible y el estado del controlador pueden diferir.	Que sea seguro reintentar, que no haya cambiado el carrito o que se haya conservado la intención.

Solo la última revisión autorizada del carrito devuelto puede establecer el estado visible de cupón, oferta, descuento y total.

La elegibilidad y el consumo son distintos

Buscar o ingresar un cupón no equivale a ser elegible. La elegibilidad puede depender de la cuenta, proyecto, negocio, contenido del carrito, entrega, dirección, horario, tipo de pedido, estado de cliente/invitado, límites, negocios participantes y ofertas existentes actuales.

El consumo se produce más adelante como operación del pedido/financiera. Un carrito puede parecer elegible antes de realizar el pedido mientras otra operación concurrente consume el límite disponible. El contrato aceptado debe reservar y consumir el uso atómicamente o devolver un conflicto exacto sin corromper el carrito.

No infieras usos restantes, elegibilidad de cuenta, negocios participantes ni aceptación de pedidos futuros a partir de un cupón u oferta visible.

Reemplazo, acumulación y concurrencia

Situación	Límite requerido
Ya hay un cupón u oferta	El reemplazo debe ser explícito, idempotente y transaccional; no se acepta el reemplazo forzado y silencioso.
Ofertas que no se pueden acumular	El servidor debe autorizar el conjunto exacto resultante y rechazar combinaciones incompatibles antes de modificar el carrito.
Se envía dos veces el mismo valor	Debe prevalecer una sola operación actual; el trabajo duplicado/repetido no debe consumir límites ni sobrescribir una intención más reciente.
Compiten distintos valores	Las respuestas anteriores tardías no deben reemplazar la revisión autorizada más reciente del carrito.
Varios negocios	Se deben identificar cada objetivo y resultado, con actualización total o parcial exacta y recuperación.
Se quita pronto el estado compartido de carga	Es posible que otra solicitud siga pendiente; el carrito no está actualizado.

No hay una regla de reintento segura sin un recibo de operación que identifique la solicitud original y el resultado autorizado del carrito.

Requisitos independientes para un negocio o grupo

El pago individual puede usar las validaciones actuales del tipo de pedido e invitado para exigir un estado de oferta/cupón devuelto antes de Realizar pedido. Puede que una cadena de cupón visible por sí sola no cumpla el requisito.

El Pago múltiple agrupado puede mostrar campos generales del grupo o por carrito, pero los requisitos actuales, identidad del estado aplicado y comportamiento de actualización no coinciden con los del Pago individual. Después de una o varias solicitudes de cupón, el grupo puede quedar obsoleto o parcial. No infieras que todos los miembros satisfacen un cupón obligatorio a partir de un control, un carrito devuelto o una acción Realizar pedido habilitada.

Totales negativos y eliminación automática

Una protección del cliente puede iniciar automáticamente la eliminación de un cupón cuando el precio actual que recibe es negativo. Es una modificación con efectos, no una validación ni prueba de que el carrito se haya recuperado correctamente.

Las reglas financieras autorizadas deben rechazar totales negativos antes de cualquier cambio automático del carrito. La eliminación, presentación del error, totales, restauración de uso, analítica e intención actual del cliente requieren un resultado recuperable. Que vuelva a abrirse o esté mal formado un error no demuestra que se haya revertido la operación.

Carrito devuelto y totales autorizados

El cliente no calcula con autoridad los descuentos de cupones. Una respuesta correcta debe devolver un carrito actual y coherente que contenga el estado aceptado de cupón/oferta y todos los campos obligatorios de subtotal, descuento, impuesto, tarifa, propina, entrega, total, saldo, moneda y revisión afectados.

Cambio mostrado	Qué sigue sin demostrarse
Aparece una fila de descuento u oferta	Reserva/consumo de uso, reglas de acumulación o aceptación del pedido.
Cambia el subtotal o total	Importe canónico en unidades menores, moneda, base de tarifas/impuestos/propina o última revisión del carrito.
Desaparece el cupón/la oferta	Actualización de la eliminación, restauración del uso u otras ofertas activas.
Se habilita Realizar pedido	Elegibilidad actual del servidor, idempotencia de la operación, pago o realización del pedido.

Los cambios de dirección, tipo de pedido, horario, productos, cantidades, tarifas, propinas, estado de billetera y otros elementos del carrito pueden invalidar los totales devueltos anteriormente.

Analítica y privacidad

Los valores de cupón son contexto confidencial de marketing y carrito. La analítica de ingreso, aplicación, rechazo y eliminación puede diferir entre los flujos heredado y avanzado; algunos puntos de entrada pueden no tener la identidad exacta de carrito/grupo necesaria para atribuirla correctamente.

La analítica debe usar el contexto actual del carrito o grupo y respetar el consentimiento configurado para el proyecto. No incluyas valores de cupones, importes ni referencias de negocios, carritos o pedidos en notas de soporte o capturas.

Resultados de error, vacío y desconocidos

Resultado observable	Interpretación segura
No aparece el área de cupones	El contexto/configuración actual no la muestra; no infieras disponibilidad global.
Campo vacío	Solo es un estado local previo a la acción.
Aplicar está deshabilitado	El campo local actual no está listo; no implica nada sobre el servidor.
Aparece un error	La solicitud, elegibilidad, límite, reemplazo, carrito o asignación del error pueden diferir; no revela la existencia de la cuenta.
El error no tiene texto o el valor sigue en el campo	El estado local, controlador y carrito pueden no coincidir.
Cambia un carrito del grupo	Los demás carritos y totales del grupo siguen sin resolverse.
Los totales devueltos son incoherentes u obsoletos	No infieras un descuento aceptado ni autoridad para Realizar pedido.
Se pierde la respuesta	Mantén desconocidos el cupón, uso, carrito, analítica y pedido; no repitas automáticamente.

Solucionar problemas de forma segura

• Considera separados el texto visible, estado del controlador, cupón devuelto, filas de oferta y totales hasta que los concilie una revisión actual del carrito.
• No pruebes otro valor, quites/vuelvas a aplicar el cupón, cambies la dirección/tipo/hora ni alteres el carrito para comprobar la elegibilidad.
• No uses Realizar pedido, pago, billetera u otro negocio como prueba del cupón.
• Conserva la incertidumbre del grupo cuando los carritos de sus miembros difieran.
• Usa solo estados sin valores, como “actualización del cupón sin resolver”, “carrito devuelto obsoleto” o “cupón de grupo parcial”.

Accesibilidad y recertificación

El campo de cupón, Aplicar, estados deshabilitado/ocupado, cupón/oferta devuelto, eliminación, confirmación, error, requisito, cambio de totales, parcial y desconocido requieren nombres, roles, valores, consecuencias, orden del foco y anuncios semánticos claros. El texto grande, teclado, lector de pantalla, cuadro modal, Atrás y retorno del foco no deben ocultar el estado actual del carrito ni consecuencias destructivas.

La disponibilidad de cupones y ofertas, sus límites de uso y su efecto en el total dependen del negocio, el carrito y la configuración del proyecto. Confirma el total actualizado antes de realizar el pedido.

Guías relacionadas: Revisar el carrito antes del pago · Encontrar ofertas y promociones · Revisar tarifas, impuestos y propinas · Entender el pago para varios negocios · Resolver errores y reintentos del pago · Entender las opciones de consentimiento y privacidad