Reglas de Inventario y Disponibilidad de Paquetes

BundlesIQ deriva la disponibilidad de paquetes de los niveles de stock de los componentes, asegurando que los paquetes se muestren como agotados cuando cualquier componente requerido se agota. Esta guía explica cómo funciona el inventario y cómo configurarlo.

Lo Que Lograrás

Después de leer esta guía, entenderás cómo BundlesIQ calcula la disponibilidad de paquetes, cómo funciona la sincronización de inventario y qué esperar en escenarios comunes.

Cuándo Usar Esta Guía

Estás configurando un nuevo paquete y quieres entender el comportamiento del inventario
Un paquete se muestra como agotado y necesitas entender por qué
Quieres decidir si habilitar o deshabilitar la sincronización de inventario

Cómo Se Calcula la Disponibilidad de Paquetes

BundlesIQ utiliza la fórmula del componente menos disponible:

bundle_availability = min(component_available / qty_per_bundle)

Para cada componente, BundlesIQ divide el inventario disponible por la cantidad necesaria por paquete, y luego toma el mínimo entre todos los componentes. Esto asegura que no puedes vender más paquetes de los que permite tu componente con menor stock.

Ejemplo:

Paquete: "Kit de Inicio" (contiene 3 artículos)
  Artículo A: 100 disponibles, 2 por paquete → 100 / 2 = 50
  Artículo B:  30 disponibles, 1 por paquete →  30 / 1 = 30
  Artículo C: 200 disponibles, 5 por paquete → 200 / 5 = 40

Disponibilidad del paquete = min(50, 30, 40) = 30 paquetes

En este ejemplo, el Artículo B es el cuello de botella: solo puedes vender 30 paquetes antes de que se agote el Artículo B.

Sincronización de Inventario

Cuando la sincronización de inventario (sync_bundle_inventory: true) está habilitada, BundlesIQ actualiza automáticamente el nivel de inventario del SKU fantasma en Shopify para que coincida con la disponibilidad de paquetes calculada.

La sincronización de inventario solo es aplicable si estás rastreando el inventario en el producto del paquete en sí. Si el SKU fantasma tiene el seguimiento de inventario deshabilitado, Shopify lo trata como siempre en stock y la sincronización de inventario no tiene efecto.

Cómo Funciona

Shopify activa un webhook inventory_levels/update cuando cambia el inventario de cualquier producto
BundlesIQ verifica si la variante actualizada es un componente de algún paquete activo (utilizando el índice de paquetes de componentes)
Para cada paquete afectado, BundlesIQ recalcula la disponibilidad utilizando la fórmula del componente menos disponible
BundlesIQ actualiza el nivel de inventario del SKU fantasma en Shopify para que coincida con la nueva disponibilidad

Habilitar o Deshabilitar la Sincronización de Inventario

Predeterminado a nivel de tienda:

Navega a BundlesIQ > Configuración
Activa Sincronizar inventario de paquetes (sync_bundle_inventory) o desactívalo
Haz clic en Guardar

Anulación por paquete:

Abre un paquete en BundlesIQ > Paquetes
Activa Sincronizar inventario o desactívalo
Haz clic en Guardar

Cuándo Habilitar la Sincronización de Inventario

Quieres que los paquetes se muestren automáticamente como agotados cuando los componentes se agoten
Dependes de la configuración de Shopify "Continuar vendiendo cuando esté agotado" para controlar la disponibilidad
Quieres que tu tienda refleje la disponibilidad precisa de paquetes sin actualizaciones manuales

Cuándo Deshabilitar la Sincronización de Inventario

Gestionas la disponibilidad de paquetes manualmente en Shopify
Tu SKU fantasma tiene el seguimiento de inventario deshabilitado (Shopify lo trata como siempre en stock)
Tienes un sistema separado que gestiona el inventario del SKU fantasma

Sincronización Minorista

La sincronización minorista (sync_bundle_retail: true) actualiza automáticamente los precios de los paquetes cuando cambian los precios de los componentes. El comportamiento varía según el modo de precios:

Modo de Precios	Sincronización Minorista Habilitada	Sincronización Minorista Deshabilitada
Dirigido por Componentes	El precio del paquete se recalcula automáticamente como la suma de (precio minorista del componente × qty × descuento)	Los pedidos se marcan con una advertencia si cambian los precios de los componentes. Se requiere revisión manual
Dirigido por Paquetes	Los paquetes se marcan para revisión cuando cambian los precios de los componentes (el precio del paquete en sí no se actualiza automáticamente, ya que es fijo)	No se toma ninguna acción cuando cambian los precios de los componentes

Habilitar o Deshabilitar la Sincronización Minorista

Predeterminado a nivel de tienda:

Navega a BundlesIQ > Configuración
Activa Sincronizar precios de paquetes (sync_bundle_retail) o desactívalo
Haz clic en Guardar

Anulación por paquete:

Abre un paquete en BundlesIQ > Paquetes
Activa Sincronizar precios o desactívalo
Haz clic en Guardar

Se recomienda la sincronización minorista para la mayoría de las tiendas. En modo dirigido por componentes, mantiene tu precio de paquete preciso. En modo dirigido por paquetes, te alerta cuando la matemática del descuento puede haber cambiado.

Seguimiento de Inventario del SKU Fantasma

Para que la sincronización de inventario funcione correctamente, la variante del producto SKU fantasma debe tener una de estas configuraciones:

Configuración	Comportamiento
Inventario rastreado, gestionado por BundlesIQ (recomendado)	BundlesIQ establece la cantidad disponible en función de los componentes. Shopify aplica las reglas de agotado
Inventario no rastreado	El paquete siempre se muestra como en stock en la tienda. BundlesIQ aún procesa pedidos pero no controla la disponibilidad

Recomendamos habilitar el seguimiento de inventario en el SKU fantasma y dejar que BundlesIQ gestione la cantidad. Esto asegura que los clientes no puedan comprar paquetes cuando los componentes están agotados.

Qué Ocurre Cuando un Componente Llega a Cero

Cuando el inventario disponible de cualquier componente cae a cero:

BundlesIQ recalcula la disponibilidad del paquete como 0
Si la sincronización de inventario está habilitada, BundlesIQ establece el inventario del SKU fantasma en 0
Si el SKU fantasma tiene "Continuar vendiendo cuando esté agotado" deshabilitado (recomendado), el producto del paquete se muestra como Agotado en tu tienda
Si "Continuar vendiendo cuando esté agotado" está habilitado, los clientes aún pueden comprar el paquete, pero el pedido puede no ser cumplible

Configuración de Shopify "Continuar Vendiendo Cuando Está Agotado"

Esta configuración de Shopify en la variante del SKU fantasma controla lo que sucede cuando el inventario llega a cero:

Configuración	Efecto
Deshabilitado (recomendado)	El paquete no puede ser comprado cuando el inventario es 0. Previene la sobreventa
Habilitado	El paquete aún puede ser comprado con 0 inventario. Útil para pre-pedidos o escenarios hechos a pedido, pero arriesga la sobreventa de componentes

Establece esto en la variante del SKU fantasma en Shopify Admin bajo Productos > [Producto del Paquete] > Inventario.

Inventario Después de un Pedido

Modos Híbrido, de Reporte y Operativo

Cuando un cliente compra un paquete:

El inventario de componentes se decrementa por Shopify como parte de su flujo normal de cumplimiento de pedidos (porque BundlesIQ agrega artículos de línea de componentes al pedido)
El inventario del paquete se recalcula por BundlesIQ cuando se activa el webhook de inventario de componentes, reflejando el stock reducido de componentes

Esto significa que el inventario se mantiene consistente: vender un paquete reduce tanto el stock de componentes como la disponibilidad derivada del paquete.

Modo Solo Padre (BOM)

En el modo Solo Padre, BundlesIQ no agrega artículos de línea de componentes al pedido, por lo que el flujo normal de cumplimiento de Shopify no decrementa el stock de componentes. En su lugar, BundlesIQ gestiona el inventario de componentes a través de la API de estado de inventario de Shopify:

Evento	Acción de Inventario
Pedido creado o pagado (dependiendo de `reserve_timing`)	El stock de componentes pasa de `available` a `reserved`
Pedido cumplido	El stock `reserved` se consume (decrementado)
Pedido cancelado	El stock `reserved` se libera de nuevo a `available`
Devolución/reabastecimiento	El stock se reabastece a `available`

El ciclo de vida del inventario:

Pedido realizado → Componente: 100 disponibles, 2 reservados
Pedido cumplido → Componente: 100 disponibles, 0 reservados (2 consumidos)
-- O --
Pedido cancelado → Componente: 102 disponibles, 0 reservados (2 liberados)

Este enfoque asegura que el stock de componentes se rastree con precisión sin modificar el pedido en sí. La sincronización de inventario del SKU fantasma sigue funcionando de la misma manera: la disponibilidad del paquete se recalcula en función de las cantidades available de los componentes.

En el modo Solo Padre, las cantidades reserved reducen el stock disponible efectivo. Un componente con 100 disponibles y 10 reservados tiene 90 unidades efectivamente disponibles para nuevos pedidos. BundlesIQ tiene en cuenta esto en los cálculos de disponibilidad de paquetes.

Componentes Compartidos Entre Paquetes

Si la misma variante de componente aparece en múltiples paquetes, todos los paquetes que comparten ese componente se ven afectados cuando cambia su inventario.