Arquitectura de Cálculo de Precios, Aislamiento de Descuentos y Cupones Temporales (7 Escenarios)

Uno de los problemas financieros más delicados en plugins de ventas cruzadas para WooCommerce ocurre cuando un descuento porcentual por volumen o un cupón de salida termina rebajando por error los productos adicionales de Upsell, erosionando el margen de ganancia de la tienda.

En esta guía de arquitectura explicamos cómo las clases PRCOD_Order_Creator y PRCOD_Cart_Handler de Modal COD Form PRO calculan y aíslan matemáticamente los precios en los 7 escenarios reales de combinación (Ofertas por Cantidad, Downsells de Salida, 1-Tick Upsell Multi-Producto, 1-Click Post-Compra y Botón Secundario de Checkout).

1. Regla de Oro del Motor de Precios: Aislamiento de $main_products_subtotal

Tanto en el formulario modal como en el servidor, el plugin separa estrictamente los ítems de la orden en dos cubetas contables:

  1. Productos Principales ($main_products_subtotal): Productos base que el cliente agregó antes de marcar ofertas cruzadas. Sobre este subtotal se calculan los descuentos de Ofertas por Cantidad (Quantity Offers) y los descuentos de rescate de Downsells.
  2. Productos de Upsell (upsell_one_tick_items[] y upsell_one_click): Se verifican en el servidor mediante prcod_resolve_verified_upsell_item() contra los metadatos del CPT upsells y aplican exclusivamente su propio descuento configurado (percentage, fixed o none), sin ser afectados jamás por los porcentajes del producto principal.

2. Matriz de los 7 Escenarios de Cálculo de Precios

Escenario Componentes Activos Fórmula de Cálculo en Servidor (PRCOD_Order_Creator) Representación en la Orden WooCommerce
1. Compra Directa Estándar Producto simple o variable sin ofertas Total = Subtotal_Base + Costo_Envío Líneas de producto (WC_Order_Item_Product) + WC_Shipping_Rate.
2. Oferta por Cantidad (Quantity Offer) Tramo de volumen con descuento percentage o fixed (código dsc firmado con HMAC) Descuento_QO = (Tipo == '%') ? Subtotal_Base * (% / 100) : Valor_Fijo Se inyecta un WC_Order_Item_Fee negativo («Discount») por el valor de -Descuento_QO.
3. Oferta por Cantidad + Downsell de Salida Código dsc + Código downsell_dsc (ambos validados con HMAC) El Downsell se calcula sobre el subtotal efectivo restante: Subtotal_Efectivo = Subtotal_Base - Descuento_QO; Descuento_DS = Subtotal_Efectivo * (%_DS / 100). Dos WC_Order_Item_Fee negativos independientes (uno por la oferta de cantidad y otro por el cupón de rescate).
4. Producto Base + 1-Tick Upsell (Carrusel Multi-Producto) 1 o varios checkboxes marcados en el micro-carrusel (upsell_one_tick_items JSON) Cada ítem del carrusel se valida con prcod_calculate_upsell_discount_price(). Si hay un descuento principal dsc porcentual, este solo multiplica a $main_products_subtotal. Cada upsell se añade como línea física real con _cod_is_upsell = 'yes' y _cod_upsell_type = 'one_tick' + nota [1-Tick Upsell] Added: ....
5. Producto Base + 1-Click Upsell Post-Compra Popup interceptado al enviar el formulario (con selector de variación y cantidad [-] [N] [+]) Precio_Unitario_OC * Cantidad_OC verificado en servidor contra el CPT upsells activo. Línea física real con _cod_is_upsell = 'yes', _cod_upsell_type = 'one_click' + nota [1-Click Upsell] Added: ....
6. Modo Dropify / Dropi Activo cod_form_activate_dropify_sync = yes En lugar de crear objetos WC_Order_Item_Fee o WC_Shipping_Rate, create_dropi_order() prorratea descuentos y envío directamente en el subtotal y total de las líneas de producto. Solo líneas de producto físicas con precios netos prorrateados (ver Sincronización Avanzada con Dropi).
7. Ruta Botón Secundario (Checkout Nativo) Clic en .modal_button_checkout (immediate_purchase) Convierte descuentos porcentuales en cupones temporales fixed_cart calculados solo sobre ítems no-upsell y preserva precios de upsell con woocommerce_before_calculate_totals. Orden estándar de WooCommerce con cupones temporales purgados al finalizar (cleanup_temporary_coupons).

3. ¿Cómo Funciona la Conversión a Cupones Temporales en el Botón Secundario?

Cuando el cliente elige pagar anticipadamente con tarjeta o transferencia mediante el Botón Secundario, se ejecuta PRCOD_Cart_Handler::immediate_purchase():

  1. Vacía el carrito e inyecta los productos principales (o las variaciones específicas elegidas en cada línea de Quantity Offers) junto con los ítems marcados en el carrusel 1-Tick Upsell.
  2. Guarda el precio con descuento de cada upsell dentro de la sesión del ítem de carrito ($cart_item_data['prcod_upsell_price']) y el hook apply_custom_cart_item_prices($cart) (en woocommerce_before_calculate_totals) vuelve a aplicar ese precio en cada recálculo de WooCommerce.
  3. Si el cliente tenía un descuento porcentual activo en el modal (dsc, downsell_dsc o descuento adicional por pago anticipado), apply_discounts_to_cart() suma únicamente el subtotal de los ítems que NO son upsells, calcula el monto exacto en moneda y genera al vuelo un WC_Coupon temporal de tipo fixed_cart. Así, el cupón nativo de WooCommerce jamás descuenta un porcentaje extra sobre los upsells.
  4. Una vez que el pedido se procesa en el checkout nativo (woocommerce_checkout_order_processed), transfer_session_discounts_to_order() guarda el historial en _cod_applied_discounts y cleanup_temporary_coupons() elimina inmediatamente los cupones temporales de la base de datos (con respaldo adicional del CRON diario cod_cleanup_old_temporary_coupons).

4. Enlaces Relacionados

Compartir esta información

Aumenta tus ventas

Mejora tu conversión en tiendas WordPress y WooCommerce con pago contra-entrega.