Cómo Funciona BundlesIQ
BundlesIQ expande variantes de paquetes en sus variantes de componentes (dependiendo de su modo de manejo configurado) para que su tienda pueda vender un solo “artículo de paquete” mientras que sus operaciones e informes reflejan los artículos subyacentes.
Terminología (importante)
BundlesIQ funciona de variante a variante:
- Producto: Un contenedor de producto de Shopify (lo que los comerciantes a menudo navegan en Admin)
- Variante: El artículo a nivel de SKU que se puede comprar (esto es lo que BundlesIQ mapea y detecta)
- Variante de SKU fantasma: La variante de paquete que los clientes compran (el artículo de línea “padre”)
- Variantes de componentes: La(s) variante(s) contenida(s) en el paquete, cada una con una cantidad
Cuando este documento dice “producto”, se refiere a cómo está organizado Shopify Admin. La detección y mapeo real siempre se realiza utilizando IDs de variante.
El Modelo de SKU Fantasma
BundlesIQ utiliza un enfoque de variante de SKU fantasma para el empaquetado:
- Elige la variante que los clientes comprarán como el paquete:
- Selecciona una variante existente de Shopify, o
- Crea el artículo de paquete dentro de BundlesIQ (más rápido, pero más limitado que Shopify Admin)
- En BundlesIQ, defines el paquete vinculando esa variante de SKU fantasma a una o más variantes de componentes (más cantidades)
- Cuando un cliente compra la variante de SKU fantasma, BundlesIQ la detecta y procesa el pedido según su modo de manejo (Operativo, Híbrido, Informes, o Solo Padre/BOM)
Ejemplo concreto (de variante a variante)
Producto A: “Manzana”
- Variante A (estándar): “Individual”
- Variante B (paquete): “Paquete de Dos” → componentes: Variante A × 2
- Variante C (paquete): “Paquete de Tres” → componentes: Variante A × 3
- Variante D (paquete): “Paquete de Cuatro” → componentes: Variante A × 4
- Variante E (paquete): “Paquete de Cinco” → componentes: Variante A × 5
El paquete parece un “producto” en Shopify Admin, pero BundlesIQ está mapeando y procesando estos como variantes.
Por Qué Variantes de SKU Fantasma
Las variantes de SKU fantasma mantienen la tienda simple mientras permiten que la oficina trasera se mantenga precisa:
- Clientes ven un artículo con un precio
- Operaciones/Almacén pueden trabajar con los artículos reales de recogida/empaquetado (cuando su modo agrega componentes al pedido)
- Contabilidad/Informes pueden rastrear ingresos al nivel que elija (nivel de paquete, nivel de componente, o ambos)
- Control de inventario depende del modo de manejo:
- En modos donde los componentes están en el pedido, el flujo normal de inventario de Shopify se aplica a variantes de componentes
- En modo Solo Padre (BOM), BundlesIQ puede gestionar opcionalmente el inventario de componentes a través de estados de inventario (más abajo)
Modos de Manejo (Qué Cambia en el Pedido)
BundlesIQ admite múltiples modos de manejo. El modo determina lo que aparece en el pedido final:
| Modo de Manejo | ¿Variante de SKU fantasma en el pedido? | ¿Variantes de componentes en el pedido? | Caso de uso típico |
|---|---|---|---|
| Operativo | ❌ Eliminado | ✅ Sí (con precio) | Almacenamiento + realidad operativa (recogida/empaquetado) |
| Híbrido | ✅ Sí (establecido en $0.00) | ✅ Sí (con precio) | Operaciones + visibilidad del paquete retenida |
| Informes | ✅ Sí (con precio) | ✅ Sí (establecido en $0.00) | Los ingresos permanecen en el paquete, las operaciones todavía ven componentes |
| Solo Padre (BOM) | ✅ Sí (con precio) | ❌ No | Modelo de costo de fabricación/kit; sin expansión de línea de pedido |
La Canalización de Transformación
Cuando se crea un pedido (o pedido en borrador), BundlesIQ ejecuta esta canalización:
1) Detección
Shopify envía un webhook (por ejemplo, orders/create o draft_orders/create). BundlesIQ verifica el ID de variante de cada artículo de línea contra su índice de paquetes.
- Los SKU son opcionales — BundlesIQ no requiere SKU para detectar paquetes
- La detección se basa en la identidad de la variante, no en el título/manejo del producto
2) Control de 3PL (Opcional)
Si la protección de 3PL está habilitada, BundlesIQ puede:
- Etiquetar el pedido como en procesamiento (ejemplo:
BIQ_PROCESSING) - Colocar opcionalmente un retención de cumplimiento para que su 3PL/almacén no importe el pedido prematuramente
3) Carga de Configuración
BundlesIQ carga:
- Definición del paquete (variante de SKU fantasma + variantes de componentes + cantidades)
- Configuración de precios (anulación a nivel de paquete o predeterminados de la tienda)
- Modo de manejo (anulación de paquete o predeterminado de la tienda)
- Cualquier limitación (límites, reglas de validación, configuraciones de 3PL, etc.)
4) Cálculo y Validación de Precios
BundlesIQ determina cómo se deben representar los precios en el pedido. Aquí es donde viven la mayoría de los casos límite.
Realidad clave:
- BundlesIQ utiliza principalmente descuentos/asignaciones para lograr precios objetivo de componentes.
- Aumentar el precio efectivo de un componente por encima del precio base de la variante no se admite de manera confiable en todos los escenarios.
Validaciones comunes:
- El precio dirigido por el paquete típicamente requiere que la suma minorista de los componentes (qty × precio) sea >= el precio del paquete para evitar asignaciones imposibles
- El precio fijo en un componente debe ser <= el precio minorista del componente
5) Transformación del Pedido (Dependiente del Modo)
Para modos Operativo / Híbrido / Informes, BundlesIQ edita el pedido:
- Agrega artículos de línea de componentes (cantidades correctas)
- Aplica descuentos/asignaciones para lograr el resultado de precios configurado
- Modifica la línea de SKU fantasma dependiendo del modo de manejo (eliminarla, establecerla en $0, o mantenerla con precio)
Notas:
- BundlesIQ evita introducir cargos adicionales durante la transformación (por ejemplo, los clientes no deberían pagar más debido a la expansión).
- La presentación final de envío/impuestos depende de la configuración de la tienda y las reglas de cálculo de Shopify, pero la intención es “sin aumento sorpresivo debido a la transformación en sí”.
Para el modo Solo Padre (BOM), BundlesIQ no agrega artículos de línea de componentes al pedido:
- La línea de artículo de SKU fantasma permanece como está
- No aparecen líneas de componentes en el pedido
- BundlesIQ puede gestionar opcionalmente el inventario de componentes al transitar cantidades a un estado de inventario no vendible (por ejemplo, reservado/comprometido dependiendo del flujo de trabajo), luego:
- consumir en cumplimiento, o
- liberar en cancelación
6) Post-Procesamiento
Después del procesamiento exitoso:
- La etiqueta de procesamiento se actualiza (ejemplo:
BIQ_PROCESSING→BIQ_READY) - Se liberan las retenciones (si están habilitadas)
- Se escribe un metafield de auditoría en el pedido (resumen de alto nivel de lo que sucedió)
- Se guarda un registro de instancia de paquete (instantánea completa antes/después + registros internos)
7) Manejo de Errores
Si el procesamiento falla:
- BundlesIQ no “compromete a medias” los cambios. Primero valida y solo compromete la edición del pedido una vez que las verificaciones pasan.
- El pedido se marca como fallido (ejemplo:
BIQ_ERROR) - Los detalles se registran en el tablero de salud de BundlesIQ
- Un comportamiento de reintento opcional puede volver a intentar el procesamiento después de un tiempo de espera
- Puede Reprocesar manualmente un pedido desde Shopify Admin a través de la acción/menu de BundlesIQ (vuelve a ejecutar la canalización)
Dónde Se Almacena la Información
BundlesIQ almacena datos tanto en Shopify como en la base de datos en la nube de BundlesIQ.
En su tienda Shopify
| Ubicación | Datos |
|---|---|
| Etiquetas de pedido | Etiquetas de estado de procesamiento (por ejemplo, BIQ_PROCESSING, BIQ_READY, BIQ_ERROR) |
| Metafields de pedido | Registro de auditoría / resumen de transformación (por ejemplo, bundles_iq.transformation_audit) |
| Notas de pedido (opcional) | Advertencias/banderas legibles por humanos (si están habilitadas) |
En la base de datos en la nube de BundlesIQ
| Colección | Datos |
|---|---|
| Paquetes | Definiciones de paquetes, componentes, grupos de sustitución, configuración de precios |
| Instancias de paquetes | Registros de procesamiento por pedido con instantáneas antes/después |
| Registros de procesamiento | Registro de eventos con marca de tiempo para webhooks, detección, ediciones, reintentos |
| Configuraciones | Preferencias de tienda, valores predeterminados de modo de manejo, alcance, configuración de 3PL |
| Índice de variantes de paquete | IDs de variantes de SKU fantasma → mapeo de definición de paquete |
| Índice de paquete de componentes | IDs de variantes de componentes → paquetes que los incluyen |
Tiempos de Procesamiento (Qué Esperar)
BundlesIQ procesa de manera asíncrona después de que Shopify envía el webhook. El tiempo de procesamiento depende de:
- número de paquetes en el pedido
- número de componentes por paquete
- rendimiento de la API de Shopify + límites de tasa
- si la asignación de precios requiere llamadas de validación adicionales
Rangos típicos:
- Pedido pequeño (paquete único, pocos componentes): unos pocos segundos
- Múltiples paquetes / muchos componentes: varios segundos a ~decenas de segundos
- Cola de alto volumen: más largo
Si la protección de 3PL está habilitada, el pedido permanece retenido hasta que BundlesIQ lo marca como listo, por lo que la variación de tiempo no debería afectar la precisión del cumplimiento.