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:
- 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. - Productos de Upsell (
upsell_one_tick_items[]yupsell_one_click): Se verifican en el servidor medianteprcod_resolve_verified_upsell_item()contra los metadatos del CPTupsellsy aplican exclusivamente su propio descuento configurado (percentage,fixedonone), 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():
- 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.
- 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 hookapply_custom_cart_item_prices($cart)(enwoocommerce_before_calculate_totals) vuelve a aplicar ese precio en cada recálculo de WooCommerce. - Si el cliente tenía un descuento porcentual activo en el modal (
dsc,downsell_dsco 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 unWC_Coupontemporal de tipofixed_cart. Así, el cupón nativo de WooCommerce jamás descuenta un porcentaje extra sobre los upsells. - 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_discountsycleanup_temporary_coupons()elimina inmediatamente los cupones temporales de la base de datos (con respaldo adicional del CRON diariocod_cleanup_old_temporary_coupons).