Guía de Integración 3PL

BundlesIQ incluye protección integrada para evitar que los proveedores de logística de terceros (3PL) y los sistemas de gestión de almacenes (WMS) importen pedidos antes de que se complete el procesamiento del paquete. Esta guía explica cómo configurar y utilizar estas funciones.

Lo Que Lograrás

Configurarás la protección 3PL para que tu socio de cumplimiento nunca actúe sobre un pedido antes de que BundlesIQ haya terminado de transformarlo.

Cuándo Usar Esta Guía

Usas un 3PL o WMS que importa automáticamente pedidos de Shopify
Quieres evitar que tu almacén recoja el SKU fantasma en lugar de los componentes reales
Necesitas configurar filtrado basado en etiquetas en tu sistema 3PL

El Problema de Condición de Carrera

Sin protección, puede ocurrir este modo de falla:

El cliente realiza un pedido que contiene el SKU fantasma del paquete
Tu 3PL importa el pedido de inmediato (o en segundos)
El personal del almacén comienza a recoger basado en el SKU fantasma (artículo incorrecto)
BundlesIQ completa la transformación, pero es demasiado tarde: los artículos incorrectos ya están siendo empaquetados

BundlesIQ previene esto con un enfoque de "denegar por defecto": los pedidos no son elegibles para cumplimiento hasta que BundlesIQ los marque explícitamente como listos.

Mecanismos de Protección

BundlesIQ utiliza un enfoque de "cinturón y tirantes" con dos capas de protección:

Capa 1: Filtrado Basado en Etiquetas (Primaria)

BundlesIQ aplica etiquetas a los pedidos en cada etapa del procesamiento:

Etiqueta	Cuándo se Aplica	Significado
`BIQ_PROCESSING`	Inmediatamente cuando BundlesIQ comienza a procesar	El pedido está siendo transformado — no importar
`BIQ_READY`	Después de una transformación exitosa	El pedido es seguro para importar y cumplir
`BIQ_ERROR`	Cuando el procesamiento falla	El pedido tiene un problema — no importar hasta que se resuelva
`BIQ_REVERTED`	Después de que se revierte una transformación de pedido borrador	El pedido borrador ha sido restaurado al estado anterior a la transformación (solo pedidos borrador)

Configuración recomendada para 3PL: Configura tu 3PL para importar solo pedidos que tengan la etiqueta BIQ_READY. Este es el enfoque más confiable porque los pedidos sin la etiqueta son simplemente invisibles para el 3PL.

Capa 2: Retenciones de Cumplimiento de Shopify (Red de Seguridad)

BundlesIQ opcionalmente coloca una retención de cumplimiento nativa de Shopify en los pedidos durante el procesamiento. Esta es una retención a nivel de sistema que aparece en el Admin de Shopify como "En espera" y es respetada por muchas integraciones de cumplimiento.

La retención se coloca después de que se crea el pedido (nota: puede haber un breve retraso mientras Shopify crea los pedidos de cumplimiento)
La retención se libera después de que BundlesIQ completa exitosamente la transformación
Si el procesamiento falla, la retención permanece en su lugar

Opcional: Etiquetas Alias

Si tu 3PL espera nombres de etiquetas específicos, puedes configurar etiquetas alias:

Configuración	Predeterminado	Propósito
Etiqueta alias de retención	`ON-HOLD`	Aplicada durante el procesamiento (mismo momento que `BIQ_PROCESSING`)
Etiqueta alias de listo	`READY_TO_SHIP`	Aplicada después del procesamiento exitoso (mismo momento que `BIQ_READY`)

Las etiquetas alias se aplican además de las etiquetas estándar de BIQ, no en lugar de ellas.

Configurando la Protección 3PL

Paso 1: Habilitar Protección en BundlesIQ

Navega a BundlesIQ > Configuración
Bajo Protección 3PL, asegúrate de que el interruptor maestro esté Habilitado
Configura los nombres de las etiquetas si necesitas valores personalizados (los predeterminados funcionan para la mayoría de las configuraciones)
Habilita etiquetas alias si tu 3PL espera nombres de etiquetas específicos como ON-HOLD o READY_TO_SHIP
Habilita retenciones de cumplimiento si deseas la retención nativa de Shopify como red de seguridad
Haz clic en Guardar

Paso 2: Configura Tu 3PL

Configura tu 3PL o WMS para filtrar pedidos basados en etiquetas de BundlesIQ. Los pasos exactos dependen de tu sistema. Elige uno de los tres patrones de integración a continuación:

Patrón A (Recomendado): Lista Permitida en `BIQ_READY`

Configura tu OMS/WMS/3PL para importar solo pedidos que contengan BIQ_READY (o tu etiqueta alias de listo).

Pros: Ventana de carrera cero — muy difícil enviar un pedido no procesado
Contras: Los pedidos que no son de paquete pueden necesitar una regla separada para agregar la etiqueta de listo (ver Pedidos Sin Paquetes)

Patrón B: Lista Denegada en Etiquetas de Procesamiento / Error

Configura tu OMS/WMS/3PL para omitir pedidos que contengan BIQ_PROCESSING o BIQ_ERROR.

Pros: Los pedidos que no son de paquete fluyen normalmente sin trabajo extra
Contras: Existe una pequeña ventana de carrera en sistemas que importan instantáneamente antes de que aparezcan las etiquetas. Habilitar retenciones de cumplimiento reduce el impacto

Patrón C (Solo Red de Seguridad): Confiar en Retenciones de Cumplimiento

Usa esto solo cuando el sistema externo no pueda filtrar por etiquetas.

Pros: Configuración mínima en el sistema de abajo
Contras: No siempre detiene la creación de etiquetas en cada herramienta — mejor como una red de seguridad, no el control principal

Ejemplos Comunes de Configuración 3PL

ShipStation:

Mapea las etiquetas de pedidos de Shopify a un campo personalizado de ShipStation
Crea una vista guardada "BundlesIQ Ready" que solo muestra pedidos donde el campo personalizado contiene BIQ_READY
Capacita al personal para trabajar exclusivamente desde la vista "BundlesIQ Ready"
Consulta la guía dedicada de Configuración de ShipStation para instrucciones detalladas paso a paso

Easyship:

Usa "Excluir pedidos por etiqueta" para excluir BIQ_PROCESSING y BIQ_ERROR
Los pedidos se vuelven visibles para Easyship después de que BundlesIQ los cambia a BIQ_READY

ShipHero:

Usa la configuración de ShipHero para controlar cómo se importan las retenciones de cumplimiento de Shopify
Opcionalmente, usa etiquetas de pedidos de Shopify dentro de ShipHero para agrupación y enrutamiento

Extensiv (anteriormente 3PL Central / Skubana):

Usa "Reglas de Filtrado de Pedidos" de Shopify para cargar solo pedidos que coincidan con tus etiquetas de estado de listo
O usa el patrón "Retener Pedido por Etiquetas" (no cargar pedidos hasta que se elimine la etiqueta de procesamiento)

Shippo:

Si se requiere filtrado basado en etiquetas, confirma si Shippo puede filtrar basándose en etiquetas de pedidos de Shopify en tu configuración
De lo contrario, confía en la disciplina de flujo de trabajo de BIQ_READY combinada con la retención de cumplimiento de Shopify como red de seguridad

Otros 3PLs:

Consulta la documentación de tu 3PL para capacidades de filtrado de etiquetas de Shopify
Si tu 3PL admite filtrado de estado de cumplimiento de Shopify, la retención de cumplimiento proporciona una red de seguridad adicional

Paso 3: Prueba la Protección

Realiza esta rápida prueba de verificación antes de poner en marcha:

Realiza un pedido de prueba que contenga un producto de paquete
Verifica tu sistema 3PL de inmediato — dependiendo de tu patrón de integración:
- Lista Permitida (Patrón A): El pedido no debería aparecer en absoluto (sin etiqueta BIQ_READY aún)
- Lista Denegada (Patrón B): El pedido debería estar claramente marcado como no listo
- Red de Seguridad (Patrón C): El pedido debería estar bloqueado por una retención de cumplimiento
Espera unos segundos para que BundlesIQ procese
Verifica nuevamente — el pedido ahora debería tener la etiqueta BIQ_READY y ser importable
Verifica que el pedido importado muestre los artículos de línea de componente correctos (estado posterior a la transformación)
Prueba un escenario de error — configura intencionalmente un paquete de manera incorrecta para provocar una falla de procesamiento y confirma:
- BIQ_ERROR aparece en el pedido
- La retención de cumplimiento permanece en su lugar (si está habilitada)
- El pedido no se vuelve listo para enviar en tu sistema de abajo

Lista de Verificación de Compatibilidad para Cualquier OMS/WMS/3PL

Al evaluar si un sistema funciona con BundlesIQ, responde a estas cuatro preguntas:

Filtrado de etiquetas: ¿Puede incluir o excluir pedidos de Shopify basándose en etiquetas de pedidos al importar?
Visibilidad de etiquetas: ¿Importa etiquetas de pedidos de Shopify en absoluto?
Manejo de retenciones: ¿Retrasa la importación de pedidos que tienen una retención de cumplimiento de Shopify?
Sincronización de cumplimiento: ¿Crea cumplimientos en Shopify o envía el seguimiento de vuelta a Shopify?

Si tienes (1) o (3), puedes implementar un flujo de trabajo robusto de "denegar por defecto". Si solo tienes (2), aún puedes usar un flujo de trabajo manual donde el personal verifica las etiquetas antes de enviar.

Mejores Prácticas para Nombres de Etiquetas

Usa formato ASCII, mayúsculas, guion bajo o guion: BIQ_READY, ON-HOLD
Evita caracteres especiales que algunos sistemas manejan de manera inconsistente: : / @ emoji
Mantén las etiquetas cortas y estables: los constructores de reglas 3PL a menudo requieren coincidencias exactas
Documenta tus convenciones de etiquetas y compártelas con tu equipo de cumplimiento

Qué Ocurre Cuando el Procesamiento Falla

Si BundlesIQ no puede procesar un pedido:

La etiqueta BIQ_PROCESSING permanece (o se reemplaza por BIQ_ERROR)
La etiqueta BIQ_READY no se aplica
Las retenciones de cumplimiento permanecen en su lugar
El pedido no es importable por el 3PL
El error aparece en el panel de Salud de BundlesIQ
Si se habilitan reintentos automáticos, BundlesIQ intentará reprocesar después del período de enfriamiento
Una vez resuelto (automáticamente o manualmente), se aplica la etiqueta BIQ_READY y el pedido se vuelve importable

Modo Solo Padre (BOM) y 3PL

Si usas el modo Solo Padre (BOM), tu 3PL solo verá el SKU fantasma del paquete en el pedido — no se añaden artículos de línea de componente. Esto significa:

Tu 3PL o almacén debe conocer la lista de materiales (BOM) para cada SKU de paquete
Las etiquetas de protección 3PL (BIQ_PROCESSING, BIQ_READY) aún se aplican — controlan el procesamiento de reserva de inventario, no la edición de pedidos
Las retenciones de cumplimiento aún se colocan y liberan durante el procesamiento

El modo Solo Padre se utiliza típicamente con almacenes internos o operaciones de ensamblaje donde el personal tiene acceso a la BOM, no con 3PL externos que esperan SKUs individuales en cada pedido. Si tu 3PL necesita ver artículos de línea de componente, utiliza el modo Híbrido, de Reporte o Operativo en su lugar.

Pedidos Sin Paquetes

Si un pedido no contiene productos de paquete:

BundlesIQ no aplica ninguna etiqueta al pedido
El pedido está inmediatamente disponible para tu 3PL a través de su proceso de importación normal
No se colocan retenciones de cumplimiento

Si tu 3PL está configurado para solo importar pedidos con la etiqueta BIQ_READY, los pedidos que no son de paquete tampoco se importarán. En este caso, es posible que desees usar un flujo de trabajo de Shopify o un script para agregar automáticamente la etiqueta BIQ_READY a los pedidos que no son de paquete. Alternativamente, configura tu 3PL para importar pedidos que tengan BIQ_READY o no tengan BIQ_PROCESSING.

Errores Comunes

No configurar el lado del 3PL — Habilitar la protección 3PL en BundlesIQ solo agrega etiquetas. También debes configurar tu 3PL para filtrar en esas etiquetas
Usar lista denegada en lugar de lista permitida — El enfoque de lista denegada tiene una pequeña ventana de carrera (pedido creado antes de que se aplique la etiqueta). El enfoque de lista permitida (se requiere BIQ_READY) es más confiable
Olvidar sobre pedidos que no son de paquete — Si tu 3PL requiere la etiqueta BIQ_READY, asegúrate de que los pedidos que no son de paquete también sean etiquetados o usa una regla de filtro combinada