Sincronización Avanzada con Dropi / Dropify: Prorrateo Contable, Regla de 1 Producto y Upsells Físicos

Los sistemas externos de dropshipping y logística como Dropi (Dropify) leen los pedidos de WooCommerce inspeccionando únicamente el arreglo de líneas de productos (line_items) y suelen ignorar las líneas de tarifas adicionales (fee_lines) o las líneas de envío (shipping_lines) cuando calculan el recaudo contraentrega.

Para resolver esta limitación estructural de la API de Dropi sin alterar tu inventario, Modal COD Form PRO incorpora un motor de creación de órdenes especializado (PRCOD_Order_Creator::create_dropi_order()) activado mediante la opción cod_form_activate_dropify_sync = yes.

1. Diferencia Contable: Orden Estándar vs Orden Sincronizada con Dropi

Elemento de la Orden Modo Estándar (create_standard_order) Modo Dropi / Dropify (create_dropi_order)
Endpoint AJAX invocado cod_create_order cod_create_dropi_order (enrutado automáticamente por cod-create-order.js)
Descuentos (Quantity Offers / Downsells) Se agregan como objetos separados WC_Order_Item_Fee negativos. Se restan directamente del precio de las líneas de producto principales antes de persistir la orden.
Costo de Envío (Flete) Se agrega como un objeto WC_Shipping_Rate separado. Se suma y prorratea directamente dentro del subtotal y total de las líneas de producto para que el total de line_items coincida al 100% con el recaudo en efectivo.
Cantidades de Inventario (Stock) Respeta las unidades físicas exactas seleccionadas. Respeta las unidades físicas exactas seleccionadas (ej. 2 unidades o 3 variaciones distintas en una oferta 3×2).

2. La Regla de 1 Único Producto Distinto en el Carrito (prcod_is_single_product_in_cart)

Cuando un comprador navega por tu tienda y acumula 2 o más productos base diferentes en el carrito antes de abrir el modal (cuando cod_form_delete_products_cart_before_order = no), prorratear un descuento de oferta por cantidad diseñada para un solo producto distorsionaría los precios unitarios reportados a Dropi.

Por ello, el plugin aplica la validación prcod_is_single_product_in_cart() (definida en includes/utils/cart-utils.php):

  • Si count(array_unique(prcod_get_cart_product_ids())) === 1 (hay un solo producto padre en el carrito), se habilitan normalmente las tarjetas de Ofertas por Cantidad y los Downsells.
  • Si hay múltiples productos distintos en el carrito, el plugin oculta automáticamente las tarjetas de Quantity Offers y Downsells para proteger la integridad del prorrateo por línea en Dropi.

3. ¿Cómo se Procesan los Upsells 1-Tick y 1-Click en Modo Dropi?

A diferencia de los descuentos generales, los productos de 1-Tick Upsell (Carrusel) y 1-Click Upsell Post-Compra son productos físicos reales con su propio SKU en Dropi. El método privado add_upsell_products_to_order($order, $order_data, $is_dropi = true) ejecuta tres garantías:

  1. Inyección como Línea Física Independiente: Cada upsell aceptado se agrega mediante $order->add_product() con su precio neto ya rebajado según su regla del CPT upsells, de modo que Dropi despache tanto el producto principal como el producto adicional en el mismo paquete.
  2. Resolución Automática de Variaciones en Stock (Fallback): Si configuraste un producto variable como Upsell y el cliente no seleccionó una variación específica, el servidor itera sobre $product_obj->get_children() y selecciona automáticamente la primera variación hija que tenga stock disponible ($child_obj->is_in_stock()), evitando que la sincronización con Dropi falle por falta de ID de variación.
  3. Trazabilidad en Notas y Metadatos: Cada línea queda marcada con _cod_is_upsell = 'yes' y _cod_upsell_type = 'one_tick' | 'one_click', y se añade una nota privada al pedido ([1-Tick Upsell] Added: ...).

4. Enlaces Relacionados

Compartir esta información

Aumenta tus ventas

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