Descripción General de Configuraciones Globales

BundlesIQ proporciona configuraciones a nivel de tienda que controlan cómo se procesan los paquetes en toda su tienda. Los paquetes individuales pueden anular algunas de estas configuraciones.

Accediendo a Configuraciones

Navegue a BundlesIQ > Configuraciones en la barra lateral de su administración de Shopify
Revise y configure cada sección a continuación
Haga clic en Guardar para aplicar sus cambios

Referencia de Configuraciones

Modo de Manejo Predeterminado

Configuración	Descripción	Predeterminado
`default_handling_mode`	Controla cómo se transforman visualmente los pedidos cuando se detecta un paquete	`"hybrid"`

Opciones:

Valor	Etiqueta	Comportamiento
`"hybrid"`	Híbrido	La línea del paquete permanece en $0; los componentes se agregan con precios
`"reporting"`	Informe	La línea del paquete permanece al precio completo; los componentes se agregan a $0
`"operational"`	Operacional	Línea del paquete eliminada; solo permanecen los componentes con precio
`"parent_only"`	Solo Padre (BOM) — Beta	La línea del paquete permanece al precio completo; no se agregan líneas de componentes; el inventario de componentes se reserva en segundo plano

Los paquetes individuales pueden anular esta configuración. Consulte Modos de Manejo Explicados para una comparación detallada.

Alcance de Procesamiento

Configuración	Descripción	Predeterminado
`processing_scope.mode`	Si procesar todos los pedidos o solo los pedidos que coinciden con etiquetas específicas	`"all"`
`processing_scope.include_tags`	Etiquetas que califican un pedido para procesamiento (cuando el modo es `"tagged_only"`)	Vacío
`processing_scope.exclude_tags`	Etiquetas que siempre deben omitir el procesamiento, independientemente del modo	Vacío

Opciones de modo de alcance de procesamiento:

Valor	Etiqueta	Comportamiento
`"all"`	Todos	Procesar cada pedido
`"tagged_only"`	Solo etiquetados	Procesar solo pedidos que coinciden con las etiquetas incluidas

Utilice el procesamiento solo etiquetado si desea que BundlesIQ procese solo pedidos mayoristas o B2B. Agregue una etiqueta como wholesale a la lista de inclusión, y solo los pedidos con esa etiqueta serán transformados.

Tipos de Pedido

Configuración	Descripción	Predeterminado
`process_orders`	Procesar pedidos estándar de Shopify	`true`
`process_draft_orders`	Procesar pedidos en borrador de Shopify	`true`

Habilite ambos si maneja flujos de trabajo B2B a través de pedidos en borrador y pedidos DTC estándar a través de la tienda en línea.

Configuraciones de Sincronización

Configuración	Descripción	Predeterminado
`sync_bundle_inventory`	Actualizar automáticamente el inventario del SKU fantasma según los niveles de stock de los componentes	`false`
`sync_bundle_retail`	Actualizar automáticamente el precio de venta del SKU fantasma cuando cambian los precios de los componentes (solo precios liderados por componentes)	`true`

Estos son valores predeterminados a nivel de tienda. Cada paquete puede anular estas configuraciones individualmente.

Protección 3PL

Configuración	Descripción	Predeterminado
`tpl_protection.enabled`	Interruptor maestro para las características de protección 3PL	`true`
`tpl_protection.processing_tag`	Etiqueta aplicada mientras BundlesIQ está procesando un pedido	`"BIQ_PROCESSING"`
`tpl_protection.ready_tag`	Etiqueta aplicada después del procesamiento exitoso	`"BIQ_READY"`
`tpl_protection.error_tag`	Etiqueta aplicada cuando el procesamiento falla	`"BIQ_ERROR"`
`tpl_protection.use_hold_alias`	También aplicar una etiqueta de alias de retención configurable por el comerciante	`false`
`tpl_protection.hold_alias_tag`	Nombre de etiqueta de retención personalizada para compatibilidad 3PL	`"ON-HOLD"`
`tpl_protection.use_ready_alias`	También aplicar una etiqueta de alias de listo configurable por el comerciante	`false`
`tpl_protection.ready_alias_tag`	Nombre de etiqueta de listo personalizada para compatibilidad 3PL	`"READY_TO_SHIP"`
`tpl_protection.use_fulfillment_holds`	Colocar retenciones nativas de Shopify durante el procesamiento	`true`

Consulte Guía de Integración 3PL para obtener instrucciones detalladas de configuración.

Opciones de Escritor

Configuración	Descripción	Predeterminado
`line_merge_mode`	Cómo manejar variantes de componentes duplicados en múltiples paquetes en el mismo pedido	`"merge"`
`group_bundle_lines`	Agrupar visualmente las líneas de componentes bajo su paquete	`false`
`add_bundle_headers`	Agregar líneas de encabezado para identificar grupos de paquetes en el pedido	`false`
`bundle_header_template`	Cadena de plantilla para la línea de encabezado (soporta el marcador de posición `{bundle_title}`)	`"Bundle: {bundle_title}"`
`max_added_lines`	Límite de seguridad en el número máximo de artículos que BundlesIQ puede agregar a un solo pedido	`499`
`enable_variance_absorber`	Corregir automáticamente pequeñas diferencias de redondeo (unos pocos centavos) durante la asignación de precios	`true`
`variance_absorber_max_cents`	Variación total máxima (en centavos) que el absorbente corregirá por pedido	`30`
`variance_absorber_max_cents_per_line`	Variación máxima (en centavos) que el absorbente aplicará a cualquier artículo de línea individual	`10`

Opciones de modo de fusión de líneas:

Valor	Etiqueta	Comportamiento
`"merge"`	Fusionar (predeterminado)	Cuando múltiples paquetes en el mismo pedido comparten la misma variante de componente, las cantidades y descuentos se fusionan en un solo artículo de línea. Utiliza un cálculo de descuento promedio ponderado
`"isolate"`	Aislar	Los componentes de cada paquete permanecen como artículos de línea separados, incluso si comparten variantes. Esto mantiene visualmente distintos los componentes de cada paquete en el pedido
`"duplicates"`	Duplicados	Permite líneas de variantes duplicadas en el pedido (utiliza `allowDuplicates: true` en la API de Edición de Pedidos). Use esto cuando necesite que cada instancia de paquete tenga sus propios artículos de línea independientes

Configuraciones de Reintento

Configuración	Descripción	Predeterminado
`retry_settings.enabled`	Reintentar automáticamente el procesamiento de paquetes fallidos	`true`
`retry_settings.max_attempts`	Número máximo de intentos de reintento después de un fallo inicial	`1`
`retry_settings.cooldown_minutes`	Tiempo mínimo entre intentos de reintento	`5`

Manejo de Errores

Configuración	Descripción	Predeterminado
`error_handling.append_to_notes`	Escribir resúmenes de errores en los atributos de notas del pedido de Shopify	`false`
`error_handling.include_warnings`	Incluir advertencias (no solo errores) en las notas del pedido	`false`

Configuración de Precios Predeterminada

Configuración	Descripción	Predeterminado
`default_pricing_config.mode`	Estrategia de precios predeterminada para nuevos paquetes	`"bundle_led"`
`default_pricing_config.bundle_led_strategy`	Estrategia de descuento predeterminada para precios liderados por paquetes	`"uniform_percent"`

Opciones de modo de precios:

Valor	Etiqueta	Comportamiento
`"bundle_led"`	Liderado por paquete	El precio de venta del paquete impulsa la asignación de descuentos entre los componentes
`"component_led"`	Liderado por componente	Los precios de los componentes se suman para determinar el precio del paquete

Opciones de estrategia liderada por paquete:

Valor	Etiqueta	Comportamiento
`"uniform_percent"`	Porcentaje uniforme	El mismo porcentaje de descuento se aplica a cada componente
`"proportional"`	Proporcional	El descuento se distribuye proporcionalmente según el precio de venta de cada componente

Esto establece la configuración de precios inicial al crear un nuevo paquete. Puede cambiarlo por paquete.

Configuraciones Solo Padre (BOM)

Estas configuraciones se aplican solo cuando el modo de manejo es "parent_only":

Configuración	Descripción	Predeterminado
`parent_only_settings.reserve_timing`	Cuándo reservar el inventario de componentes: al crear el pedido o al pagar el pedido	`"orders/paid"`
`parent_only_settings.location_strategy`	Qué ubicación utilizar para las reservas de inventario	`"fulfillment_order_location"`
`parent_only_settings.single_location_id`	El ID de ubicación específico a utilizar (solo cuando la estrategia de ubicación es `"single_location"`)	Ninguno

Opciones de tiempo de reserva:

Valor	Etiqueta	Comportamiento
`"orders/paid"`	orders/paid (recomendado)	El inventario de componentes se reserva cuando se paga el pedido. Reduce el riesgo de reservar stock para pedidos que nunca se completan
`"orders/create"`	orders/create	El inventario de componentes se reserva inmediatamente cuando se crea el pedido. Use esto si necesita bloquear stock lo antes posible (por ejemplo, productos de edición limitada)

Opciones de estrategia de ubicación:

Valor	Etiqueta	Comportamiento
`"fulfillment_order_location"`	Ubicación del pedido de cumplimiento (recomendado)	Utiliza la ubicación asignada al pedido de cumplimiento. Funciona bien para configuraciones de múltiples ubicaciones
`"single_location"`	Ubicación única	Siempre reserva de una ubicación específica. Útil si todo el ensamblaje ocurre en un solo almacén

Anulaciones a Nivel de Paquete

Las siguientes configuraciones pueden ser anuladas en paquetes individuales:

Modo de manejo — Establecer en un modo específico o dejar como "Usar predeterminado de la tienda"
Sincronización de inventario — Habilitar o deshabilitar por paquete
Sincronización de venta — Habilitar o deshabilitar por paquete
Configuración de precios — Totalmente personalizable por paquete