Instalación y Permisos
BundlesIQ se instala a través de la Shopify App Store utilizando la autenticación estándar de OAuth. Esta página explica qué acceso requiere la aplicación y por qué.
Instalar BundlesIQ
- Visita la lista de BundlesIQ en la Shopify App Store
- Haz clic en Agregar app y confirma la instalación en tu tienda Shopify
- Revisa los permisos solicitados y apruébalos
- Completa el asistente de incorporación para seleccionar tu modo de manejo predeterminado y configurar ajustes básicos
Permisos Requeridos
BundlesIQ solicita los siguientes alcances de acceso de Shopify durante la instalación:
Productos
| Alcance | Por qué BundlesIQ lo necesita |
|---|---|
read_products |
Buscar datos de productos/variantes de paquetes y componentes (precios, SKUs, estado, imágenes) para detección, cálculo de precios y el modal de búsqueda de productos |
write_products |
Sincronizar niveles de inventario de paquetes derivados y precios de venta de vuelta al producto SKU fantasma cuando la sincronización de inventario o la sincronización de venta están habilitadas |
Pedidos
| Alcance | Por qué BundlesIQ lo necesita |
|---|---|
read_orders |
Detectar paquetes en pedidos entrantes, leer líneas de artículos, etiquetas, asignaciones de descuentos y metafields para procesamiento y el panel de salud |
write_orders |
Escribir etiquetas de procesamiento (BIQ_PROCESSING, BIQ_READY, BIQ_ERROR), escribir metafields de auditoría de transformación y actualizar atributos de notas de pedido |
write_order_edits |
Transformar pedidos a través de la API de Edición de Pedidos — agregar líneas de artículos de componentes, aplicar descuentos y modificar o eliminar la línea de artículo del paquete |
Pedidos Borrador
| Alcance | Por qué BundlesIQ lo necesita |
|---|---|
read_draft_orders |
Detectar paquetes en pedidos borrador y leer datos de líneas de artículos para procesamiento B2B y mayorista |
write_draft_orders |
Transformar pedidos borrador reemplazando líneas de artículos a través de la mutación draftOrderUpdate. También se utiliza para revertir transformaciones de pedidos borrador |
Inventario
| Alcance | Por qué BundlesIQ lo necesita |
|---|---|
read_inventory |
Calcular la disponibilidad de paquetes a partir de los niveles de stock de componentes en diferentes ubicaciones |
write_inventory |
Sincronizar el inventario de paquetes derivados de vuelta a la variante SKU fantasma. En modo Solo Padre (BOM), también se utiliza para reservar, consumir y liberar inventario de componentes a través de la API de estado de inventario de Shopify |
Cumplimiento
| Alcance | Por qué BundlesIQ lo necesita |
|---|---|
read_fulfillments |
Leer el estado del pedido de cumplimiento para determinar la elegibilidad de retención y verificar el estado de cumplimiento durante el procesamiento |
write_assigned_fulfillment_orders |
Colocar y liberar retenciones de cumplimiento en pedidos asignados a tus ubicaciones (protección 3PL) |
write_merchant_managed_fulfillment_orders |
Colocar y liberar retenciones de cumplimiento en pedidos de cumplimiento gestionados por el comerciante (protección 3PL) |
write_third_party_fulfillment_orders |
Colocar y liberar retenciones de cumplimiento en pedidos de cumplimiento de terceros (protección 3PL) |
Descuentos, Ubicaciones y Otros Datos
| Alcance | Por qué BundlesIQ lo necesita |
|---|---|
read_discounts |
Leer información de códigos de descuento y descuentos automáticos de pedidos para tener en cuenta los descuentos promocionales en la asignación de precios de componentes |
read_locations |
Leer datos de ubicación de Shopify para la sincronización de inventario en múltiples ubicaciones y configuración de estrategia de ubicación Solo Padre (BOM) |
read_markets |
Leer la configuración de mercado y moneda para soporte de precios en múltiples monedas |
read_locales |
Leer configuraciones de localización de la tienda para contenido localizado |
read_metaobjects |
Leer definiciones de metaobjetos utilizadas por la extensión de la tienda para la visualización de "Qué está incluido" |
read_returns |
Leer datos de devoluciones para rastrear el comportamiento de reabastecimiento de componentes para pedidos de paquetes |
Webhooks Registrados
BundlesIQ se suscribe a los webhooks de Shopify para responder a eventos de la tienda en tiempo real. Los grupos clave de webhooks se describen a continuación.
Procesamiento Central
Estos webhooks impulsan la detección de paquetes y la transformación de pedidos:
| Webhook | Propósito |
|---|---|
orders/create |
Detectar nuevos pedidos que contienen productos de paquetes y comenzar el procesamiento |
orders/updated |
Detectar cambios en pedidos y apoyar flujos de trabajo de reprocesamiento |
orders/paid |
Activar el procesamiento para flujos de trabajo condicionados al pago. También se utiliza en modo Solo Padre (BOM) cuando el tiempo de reserva se establece en orders/paid |
orders/cancelled |
Liberar inventario de componentes reservado (modo Solo Padre) y actualizar el estado de procesamiento |
draft_orders/create |
Detectar nuevos pedidos borrador que contienen productos de paquetes |
draft_orders/update |
Procesar pedidos borrador cuando son creados o modificados |
draft_orders/delete |
Limpiar el estado de procesamiento cuando se elimina un pedido borrador |
Sincronización de Inventario y Catálogo
Estos webhooks mantienen la disponibilidad de paquetes, precios y configuración sincronizados con tu catálogo de Shopify:
| Webhook | Propósito |
|---|---|
inventory_levels/update |
Recalcular la disponibilidad de paquetes cuando cambian los stocks de componentes en cualquier ubicación |
inventory_levels/connect / disconnect |
Rastrear cuándo se habilita o deshabilita el inventario en una ubicación, afectando los cálculos de disponibilidad de paquetes |
inventory_items/create / update / delete |
Rastrear cambios en la configuración de artículos de inventario (por ejemplo, estado de seguimiento, costo) para componentes y SKUs fantasma |
products/create / update / delete |
Detectar cuándo se crean, modifican o eliminan productos de componentes o SKUs fantasma. Utilizado para sincronización de precios de venta, verificaciones de estado y validación de paquetes |
collections/create / update / delete |
Rastrear cambios en colecciones que pueden afectar la visibilidad de productos de paquetes |
Cumplimiento y Ciclo de Vida de Pedidos
BundlesIQ monitorea eventos de cumplimiento para gestionar retenciones de protección 3PL, rastrear el estado de pedidos para el panel de salud y manejar el consumo de inventario en modo Solo Padre (BOM):
| Webhook | Propósito |
|---|---|
orders/fulfilled / orders/partially_fulfilled |
Rastrear el progreso de cumplimiento. En modo Solo Padre, activa el consumo de inventario de componentes reservado |
orders/edited |
Detectar ediciones externas a pedidos que ya fueron procesados por BundlesIQ |
orders/delete |
Limpiar el estado de procesamiento cuando se elimina un pedido |
refunds/create |
Detectar reembolsos en pedidos de paquetes para actualizar el panel de salud y, en modo Solo Padre, reabastecer el inventario de componentes reservado o consumido |
fulfillment_orders/* |
Un conjunto de webhooks de pedidos de cumplimiento (movido, fusionado, dividido, retención liberada, enrutamiento completo, y otros) utilizados para gestionar retenciones de cumplimiento nativas de Shopify para protección 3PL |
fulfillments/create / update |
Rastrear la creación y actualizaciones de cumplimiento para el estado de procesamiento y gestión del ciclo de vida del inventario |
fulfillment_events/create |
Rastrear eventos de hitos de cumplimiento (por ejemplo, enviado, entregado) |
Descuentos, Mercados y Ubicaciones
| Webhook | Propósito |
|---|---|
discounts/create / update / delete |
Rastrear cambios en descuentos que pueden interactuar con la asignación de precios de paquetes |
markets/create / update / delete |
Rastrear cambios en la configuración de mercado para soporte de precios en múltiples monedas |
locations/create / update / delete |
Rastrear cambios en ubicaciones para sincronización de inventario en múltiples ubicaciones y estrategia de ubicación Solo Padre |
selling_plan_groups/create / update / delete |
Rastrear cambios en planes de venta de suscripción para compatibilidad con pedidos de aplicaciones de suscripción |
Ciclo de Vida de la App
BundlesIQ se suscribe a webhooks de ciclo de vida de la app y facturación para fines operativos:
| Webhook | Propósito |
|---|---|
app/uninstalled |
Limpiar datos de la app, liberar retenciones de cumplimiento y revocar acceso cuando se elimina la app |
app_subscriptions/update |
Rastrear cambios en el plan de facturación y actualizaciones de uso |
app_subscriptions/approaching_capped_amount |
Activar notificaciones cuando el uso de sobrepaso de Scale+ se acerque al límite de gasto |
app/scopes_update |
Detectar cambios en los alcances de acceso otorgados |
shop/update |
Rastrear cambios en la configuración de la tienda (moneda, zona horaria, plan) |
Almacenamiento de Datos
BundlesIQ almacena los siguientes datos:
- Definiciones de paquetes — Nombre del paquete, estado, referencia de SKU fantasma, lista de componentes, configuración de precios y restricciones
- Registros de procesamiento — Registros con marca de tiempo de cada transformación de pedido, incluyendo estado de éxito/fallo, banderas y detalles de precios
- Instancias de paquetes — Instantánea por pedido de qué paquetes fueron detectados, cómo fueron transformados y el mapeo de líneas de artículos resultante
- Configuraciones de la tienda — Tu preferencia de modo de manejo, alcance de procesamiento, configuración de protección 3PL y ajustes de sincronización
Todos los datos se almacenan de forma segura en la infraestructura en la nube de BundlesIQ. Los metadatos de los paquetes también se escriben en metafields de pedidos de Shopify para auditoría.
Requisitos de Firewall y Red
BundlesIQ opera como un servicio alojado en la nube. No se requiere configuración de firewall de tu parte. La entrega de webhooks utiliza la infraestructura estándar de webhooks de Shopify.