InicioSolucionesAcerca deDocumentación

Inicio Rápido: Crea Tu Primer Paquete

Sigue esta guía para crear tu primer paquete en BundlesIQ, ejecutar la prueba incorporada y verificar que la transformación de pedidos funcione correctamente.

Terminología

BundlesIQ mapea variantes de Shopify a variantes.

  • Un producto puede tener una o más variantes
  • Un SKU fantasma en BundlesIQ es la variante comprable del paquete (la variante que los clientes añaden al carrito)
  • Componentes son las variante(s) incluidas dentro del paquete (con cantidades)

En otras palabras: BundlesIQ opera a nivel de SKU (variantes), incluso si la interfaz de administración de Shopify a menudo habla en “productos”.

Antes de Comenzar

  • BundlesIQ está instalado en tu tienda Shopify
  • Has completado la incorporación y seleccionado un modo de manejo por defecto
  • Tus variantes de componentes ya existen en Shopify (BundlesIQ puede crear el artículo del paquete, pero los componentes deben existir ya)
  • O bien:
    • ya tienes un producto/variante de Shopify que deseas usar como el SKU fantasma, o
    • crearás la variante del SKU fantasma directamente dentro de BundlesIQ durante la creación del paquete (recomendado por rapidez)

Paso 1 (Opcional): Prepara Tu Variante de SKU Fantasma en Shopify

Puedes omitir este paso si planeas hacer clic en Crear Nuevo Artículo dentro de BundlesIQ.

Si ya tienes un producto/variante de Shopify que deseas usar como el SKU fantasma:

  1. Abre el producto del paquete en la administración de Shopify
  2. SKU es opcional: BundlesIQ identifica artículos por ID de variante, no por SKU
    • Aún puedes establecer un SKU para tus propios informes/flujos de trabajo
  3. Seguimiento de inventario (importante):
    • Si deseas que Shopify evite la sobreventa:
      • Activa Rastrear cantidad para la variante del SKU fantasma
      • Desactiva Continuar vendiendo cuando esté agotado
    • Si habilitas Sincronizar Inventario del Paquete en BundlesIQ, la variante del SKU fantasma debe tener seguimiento de inventario ACTIVADO (BundlesIQ actualiza la cantidad disponible en función de los componentes).
  4. Envío (opcional):
    • Muchas tiendas configuran el SKU fantasma para no requerir envío ya que los artículos físicos son los componentes.
    • Algunas tiendas mantienen el envío ACTIVADO si dependen de la variante del SKU fantasma para los cálculos de envío en el checkout. Elige lo que coincida con tu flujo de trabajo.

Paso 2: Crea el Paquete en BundlesIQ

  1. Navega a BundlesIQ > Paquetes en la barra lateral de administración de Shopify
  2. Haz clic en Crear Paquete (parte superior derecha)

2A) Tarjeta de Información y Configuración

  1. Dale un nombre al paquete
    • Referencia interna solamente (recomendado: que coincida o se asemeje estrechamente al nombre del artículo del SKU fantasma)
  2. (Opcional) Modo de Precios
    • Por defecto a el predeterminado de tu tienda (sección colapsada; puede ser anulado por paquete)
  3. (Opcional) Modo de Manejo
    • Por defecto a el predeterminado de tu tienda (sección colapsada; puede ser anulado por paquete)

2B) Tarjeta de Componentes del Paquete

1) Selecciona o crea el artículo SKU Fantasma

  • Haz clic en Seleccionar Producto de Shopify para elegir un artículo existente de Shopify, o
  • Haz clic en Crear Nuevo Artículo para crear el artículo del paquete desde dentro de BundlesIQ (ruta más rápida)

Nota: Crear el artículo SKU fantasma en BundlesIQ es más limitado que en la administración de Shopify. No se pueden crear componentes aquí; los componentes deben existir ya en Shopify.

2) Agregar componentes

  • Haz clic en Agregar Componentes para buscar y añadir variantes de componentes, o
  • Haz clic en Importar CSV para agregar en bloque componentes + cantidades

Si importas CSV:

  1. Descarga la plantilla
  2. En la columna identifier, pega uno de:
    • SKU, código de barras, ID de variante, o GID de Shopify
  3. En la columna quantity, ingresa la cantidad de componente por paquete
    • La cantidad por defecto es 1 si se omite

3) Configura los detalles de precios (depende del Modo de Precios / Modo de Manejo)

Si el Modo de Precios = Liderado por Paquete:

  • Establece el precio de venta al público de la variante SKU fantasma (este es el precio del paquete que los clientes pagan)
  • Asegúrate de que la suma de los precios de venta al público de los componentes × cantidades sea >= el precio del paquete
    • Por qué: Shopify no permite aumentar el precio del artículo de línea de un componente por encima del precio de la variante, por lo que la asignación debe encajar dentro de los precios de venta al público de los componentes.

Si el Modo de Precios = Liderado por Componente:

  • Para cada componente puedes configurar precios como:
    • Sin Descuento
    • Porcentaje de Descuento
    • Monto de Descuento
    • Precio Fijo
  • Restricción de Precio Fijo: el precio fijo debe ser <= el precio de venta al público del componente.

Si el Modo de Manejo = Solo Padre (BOM):

  • Este flujo de trabajo está impulsado por costos y se comporta de manera diferente a Operacional/Híbrido/Informe.
  • En este modo normalmente verás:
    1. Se espera que el precio del paquete (SKU fantasma) sea >= el costo total de los componentes
    2. Un botón de Agregar Costo para mano de obra/gastos generales/no consumibles
    3. Resúmenes de costo / ganancia / margen % en la parte inferior

2C) Tarjeta de Configuración Avanzada

Dependiendo del modo de manejo y la configuración de inventario del SKU fantasma, puedes ver opciones como:

  • Sincronizar Inventario del Paquete
  • Sincronizar Precio de Venta del Paquete

Recordatorio: Sincronizar Inventario del Paquete requiere que la variante SKU fantasma rastree inventario en Shopify.

2D) Guardar y Activar

  1. Establece el estado en Activo (si no está ya)
  2. Haz clic en Guardar

BundlesIQ ahora está observando pedidos/pedidos en borrador que contengan la variante SKU fantasma de este paquete (basado en tus configuraciones de procesamiento).

Paso 3: Ejecutar la Prueba Incorporada

En lugar de realizar un pedido de prueba manualmente, utiliza el botón Probar Paquete en la parte superior de la página del paquete (después de guardar y activar).

Esto ejecuta un conjunto de verificaciones para detectar problemas temprano.

Lo que hace “Probar Paquete” (a alto nivel)

  1. Crea un pedido en borrador (valida webhooks + pipeline de procesamiento)
  2. Verifica que el pedido en borrador se haya transformado correctamente para la configuración del paquete
  3. Verifica que los metadatos/metacampos del paquete se hayan escrito como se esperaba
  4. Elimina el pedido en borrador (mantiene tu tienda limpia)

Puede que veas brevemente el pedido en borrador aparecer en la administración de Shopify antes de que sea eliminado.

Paso 4: Verifica la Transformación en la Administración de Shopify (Recomendado)

La prueba cubre la mayoría de las validaciones, pero aún es inteligente verificar uno o dos escenarios reales en la administración de Shopify.

  1. Abre un pedido/pedido en borrador en la administración de Shopify
  2. Confirma que los artículos de línea coincidan con tu modo de manejo:

Híbrido

  • El SKU fantasma permanece en $0.00
  • Los artículos de línea de componentes aparecen con precios asignados
  • El total del pedido coincide con el precio original del paquete

Operacional

  • El SKU fantasma es eliminado (cantidad establecida en 0 / eliminado)
  • Solo permanecen los artículos de línea de componentes con precios asignados
  • El total del pedido coincide con el precio original del paquete

Informe

  • El SKU fantasma permanece a su precio original
  • Los artículos de línea de componentes aparecen a $0.00
  • El total del pedido coincide con el precio original del paquete

Solo Padre (BOM)

  • El SKU fantasma permanece a su precio original
  • No aparecen artículos de línea de componentes
  • El total del pedido coincide con el precio del paquete
  1. Verifica el panel de Salud de BundlesIQ para confirmar que el procesamiento se completó sin errores

Paso 5: Verifica el Inventario (Opcional)

El comportamiento del inventario tiene dos capas diferentes:

  1. Inventario de componentes (comportamiento nativo de Shopify):
    Cuando los componentes están en el pedido (Operacional/Híbrido/Informe), Shopify actualiza el inventario a través de su flujo normal de reserva/cumplimiento. En pruebas tempranas, esto puede ser difícil de validar sin implicaciones reales de inventario.

  2. Inventario de SKU fantasma (opción de sincronización de BundlesIQ):
    Si Sincronizar Inventario del Paquete está habilitado, BundlesIQ mantiene la cantidad disponible del SKU fantasma alineada con la disponibilidad de los componentes (requiere que el seguimiento de inventario esté habilitado en la variante del SKU fantasma).

Problemas Comunes

  • El pedido no fue transformado
    • Confirma que el estado del paquete es Activo
    • Confirma que tu alcance de procesamiento incluye el tipo de pedido (pedidos, pedidos en borrador, o ambos)
    • Confirma que los webhooks de BundlesIQ están registrados y habilitados (Configuraciones)
    • Confirma que las variantes SKU fantasma y de componentes están activas (no archivadas / no en borrador)
  • Los precios no se ven correctos
    • Revisa nuevamente la configuración del Modo de Precios y las restricciones (especialmente las reglas de precio fijo y los límites de asignación liderados por paquete). Consulta Estrategia de Precios
  • El SKU fantasma aún aparece en el pedido
    • Esperado en Híbrido (a $0), Informe (a precio completo), y Solo Padre (a precio completo, sin componentes)
    • Solo el modo Operacional lo elimina completamente

Próximos Pasos