Guide d'Intégration 3PL

BundlesIQ inclut une protection intégrée pour empêcher les fournisseurs de logistique tiers (3PL) et les systèmes de gestion d'entrepôt (WMS) d'importer des commandes avant que le traitement des bundles ne soit terminé. Ce guide explique comment configurer et utiliser ces fonctionnalités.

Ce que Vous Allez Accomplir

Vous allez configurer la protection 3PL afin que votre partenaire de fulfillment n'agisse jamais sur une commande avant que BundlesIQ ait terminé de la transformer.

Quand Utiliser Ce Guide

• Vous utilisez un 3PL ou un WMS qui importe automatiquement des commandes depuis Shopify
• Vous souhaitez empêcher votre entrepôt de sélectionner le SKU fantôme au lieu des vrais composants
• Vous devez configurer un filtrage basé sur des tags dans votre système 3PL

Le Problème de Condition de Course

Sans protection, ce mode de défaillance peut se produire :

1. Le client passe une commande contenant le SKU fantôme du bundle
2. Votre 3PL importe la commande immédiatement (ou dans les secondes qui suivent)
3. Le personnel de l'entrepôt commence à préparer en se basant sur le SKU fantôme (mauvais article)
4. BundlesIQ termine la transformation, mais il est trop tard — les mauvais articles sont déjà en cours d'emballage

BundlesIQ prévient cela avec une approche "default deny" : les commandes ne sont pas éligibles pour le fulfillment tant que BundlesIQ ne les marque pas explicitement comme prêtes.

Mécanismes de Protection

BundlesIQ utilise une approche "ceinture et bretelles" avec deux couches de protection :

Couche 1 : Filtrage Basé sur des Tags (Principal)

BundlesIQ applique des tags aux commandes à chaque étape du traitement :

Configuration 3PL recommandée : Configurez votre 3PL pour n'importer que les commandes ayant le tag BIQ_READY. C'est l'approche la plus fiable car les commandes sans le tag sont simplement invisibles au 3PL.

Couche 2 : Retenues de Fulfillment Shopify (Filet de Sécurité)

BundlesIQ place optionnellement une retenue de fulfillment native à Shopify sur les commandes pendant le traitement. Il s'agit d'une retenue au niveau système qui apparaît dans l'Admin Shopify comme "En attente" et est respectée par de nombreuses intégrations de fulfillment.

• La retenue est placée après la création de la commande (note : il peut y avoir un léger délai pendant que Shopify crée des commandes de fulfillment)
• La retenue est levée après que BundlesIQ termine avec succès la transformation
• Si le traitement échoue, la retenue reste en place

Optionnel : Tags Alias

Si votre 3PL attend des noms de tags spécifiques, vous pouvez configurer des tags alias :

Les tags alias sont appliqués en plus des tags BIQ standard, et non à la place.

Configuration de la Protection 3PL

Étape 1 : Activer la Protection dans BundlesIQ

1. Naviguez vers BundlesIQ > Paramètres
2. Sous Protection 3PL, assurez-vous que le commutateur principal est Activé
3. Configurez les noms de tags si vous avez besoin de valeurs personnalisées (les valeurs par défaut fonctionnent pour la plupart des configurations)
4. Activez les tags alias si votre 3PL attend des noms de tags spécifiques comme ON-HOLD ou READY_TO_SHIP
5. Activez les retenues de fulfillment si vous souhaitez la retenue native à Shopify comme filet de sécurité
6. Cliquez sur Enregistrer

Étape 2 : Configurer Votre 3PL

Configurez votre 3PL ou WMS pour filtrer les commandes en fonction des tags BundlesIQ. Les étapes exactes dépendent de votre système. Choisissez l'un des trois modèles d'intégration ci-dessous :

Modèle A (Recommandé) : Liste Autorisée sur BIQ_READY

Configurez votre OMS/WMS/3PL pour n'importer que les commandes contenant BIQ_READY (ou votre tag alias prêt).

• Avantages : Aucune fenêtre de course — très difficile d'expédier une commande non traitée
• Inconvénients : Les commandes non-bundle peuvent nécessiter une règle séparée pour ajouter le tag prêt (voir Commandes Sans Bundles)

Modèle B : Liste Interdite sur les Tags de Traitement / Erreur

Configurez votre OMS/WMS/3PL pour ignorer les commandes contenant BIQ_PROCESSING ou BIQ_ERROR.

• Avantages : Les commandes non-bundle s'écoulent normalement sans travail supplémentaire
• Inconvénients : Une petite fenêtre de course existe dans les systèmes qui importent instantanément avant que les tags n'apparaissent. L'activation des retenues de fulfillment réduit l'impact

Modèle C (Filet de Sécurité Seulement) : Compter sur les Retenues de Fulfillment

Utilisez ceci uniquement lorsque le système externe ne peut pas filtrer par tags.

• Avantages : Configuration minimale dans le système en aval
• Inconvénients : Ne stoppe pas toujours la création d'étiquettes dans chaque outil — mieux comme filet de sécurité, pas comme contrôle principal

Exemples Courants de Configuration 3PL

ShipStation :

• Mapper les tags de commande Shopify à un champ personnalisé ShipStation
• Créer une vue enregistrée "BundlesIQ Ready" qui ne montre que les commandes où le champ personnalisé contient BIQ_READY
• Former le personnel à travailler exclusivement à partir de la vue "BundlesIQ Ready"
• Voir le guide dédié Configuration de ShipStation pour des instructions détaillées étape par étape

Easyship :

• Utiliser "Exclure les commandes par tag" pour exclure BIQ_PROCESSING et BIQ_ERROR
• Les commandes deviennent visibles pour Easyship après que BundlesIQ les passe à BIQ_READY

ShipHero :

• Utiliser le paramètre ShipHero pour contrôler comment les retenues de fulfillment Shopify sont importées
• Utiliser éventuellement les tags de commande Shopify à l'intérieur de ShipHero pour le regroupement et le routage

Extensiv (anciennement 3PL Central / Skubana) :

• Utiliser "Règles de Filtre de Commande" Shopify pour ne charger que les commandes qui correspondent à vos tags d'état prêt
• Ou utiliser le modèle "Retenir Commande Par Tags" (ne pas charger les commandes tant que le tag de traitement n'est pas supprimé)

Shippo :

• Si un filtrage basé sur des tags est requis, confirmez si Shippo peut filtrer en fonction des tags de commande Shopify dans votre configuration
• Sinon, comptez sur la discipline de flux de travail BIQ_READY combinée avec le filet de sécurité de retenue de fulfillment Shopify

Autres 3PL :

• Vérifiez la documentation de votre 3PL pour les capacités de filtrage par tags Shopify
• Si votre 3PL prend en charge le filtrage par statut de fulfillment Shopify, la retenue de fulfillment fournit un filet de sécurité supplémentaire

Étape 3 : Tester la Protection

Effectuez ce test de vérification rapide avant de passer en production :

1. Passez une commande test contenant un produit bundle
2. Vérifiez immédiatement votre système 3PL — selon votre modèle d'intégration :
   • Liste Autorisée (Modèle A) : La commande ne devrait pas apparaître du tout (pas encore de tag BIQ_READY)
   • Liste Interdite (Modèle B) : La commande devrait être clairement marquée comme non prête
   • Filet de Sécurité (Modèle C) : La commande devrait être bloquée par une retenue de fulfillment
3. Attendez quelques secondes pour que BundlesIQ traite
4. Vérifiez à nouveau — la commande devrait maintenant avoir le tag BIQ_READY et être importable
5. Vérifiez que la commande importée montre les bons articles de ligne de composants (état post-transformation)
6. Testez un scénario d'erreur — configurez intentionnellement un bundle de manière incorrecte pour déclencher un échec de traitement et confirmez :
   • BIQ_ERROR apparaît sur la commande
   • La retenue de fulfillment reste en place (si activée)
   • La commande ne devient pas prête à expédier dans votre système en aval

Liste de Vérification de Compatibilité pour Tout OMS/WMS/3PL

Lors de l'évaluation de la compatibilité d'un système avec BundlesIQ, répondez à ces quatre questions :

1. Filtrage par tags : Peut-il inclure ou exclure des commandes Shopify en fonction des tags de commande à l'importation ?
2. Visibilité des tags : Importe-t-il les tags de commande Shopify ?
3. Gestion des retenues : Retarde-t-il l'importation des commandes qui ont une retenue de fulfillment Shopify ?
4. Synchronisation de fulfillment : Crée-t-il des fulfillments dans Shopify ou renvoie-t-il le suivi vers Shopify ?

Si vous avez (1) ou (3), vous pouvez mettre en œuvre un flux de travail robuste "default deny". Si vous n'avez que (2), vous pouvez toujours utiliser un flux de travail manuel où le personnel vérifie les tags avant l'expédition.

Meilleures Pratiques de Nommage des Tags

• Utilisez le format ASCII, majuscules, underscore ou tiret : BIQ_READY, ON-HOLD
• Évitez les caractères spéciaux que certains systèmes gèrent de manière incohérente : : / @ emoji
• Gardez les tags courts et stables — les constructeurs de règles 3PL exigent souvent des correspondances exactes
• Documentez vos conventions de tags et partagez-les avec votre équipe de fulfillment

Que Se Passe-t-il Lorsque le Traitement Échoue

Si BundlesIQ ne peut pas traiter une commande :

1. Le tag BIQ_PROCESSING reste (ou est remplacé par BIQ_ERROR)
2. Le tag BIQ_READY n'est pas appliqué
3. Les retenues de fulfillment restent en place
4. La commande n'est pas importable par le 3PL
5. L'erreur apparaît dans le tableau de bord Santé de BundlesIQ
6. Si les tentatives automatiques sont activées, BundlesIQ tentera de reprocesser après la période de refroidissement
7. Une fois résolu (automatiquement ou manuellement), le tag BIQ_READY est appliqué et la commande devient importable

Mode Parent-Seul (BOM) et 3PL

Si vous utilisez le mode Parent-Seul (BOM), votre 3PL ne verra que le SKU fantôme du bundle sur la commande — aucun article de ligne de composant n'est ajouté. Cela signifie :

• Votre 3PL ou entrepôt doit connaître la nomenclature (BOM) pour chaque SKU de bundle
• Les tags de protection 3PL (BIQ_PROCESSING, BIQ_READY) s'appliquent toujours — ils régulent le traitement de réservation d'inventaire, pas l'édition de commande
• Les retenues de fulfillment sont toujours placées et levées pendant le traitement

Le mode Parent-Seul est généralement utilisé avec des entrepôts internes ou des opérations d'assemblage où le personnel a accès à la BOM, pas avec des 3PL externes qui s'attendent à voir des SKUs individuels sur chaque commande. Si votre 3PL doit voir des articles de ligne de composants, utilisez le mode Hybride, Reporting ou Opérationnel à la place.

Commandes Sans Bundles

Si une commande ne contient aucun produit bundle :

• BundlesIQ n'applique aucun tag à la commande
• La commande est immédiatement disponible pour votre 3PL via son processus d'importation normal
• Aucune retenue de fulfillment n'est placée

Si votre 3PL est configuré pour n'importer que les commandes avec le tag BIQ_READY, les commandes non-bundle ne seront pas non plus importées. Dans ce cas, vous voudrez peut-être utiliser un Flux Shopify ou un script pour ajouter automatiquement le tag BIQ_READY aux commandes non-bundle. Alternativement, configurez votre 3PL pour importer les commandes qui ont soit BIQ_READY soit n'ont pas BIQ_PROCESSING.

Erreurs Courantes

• Ne pas configurer le côté 3PL — Activer la protection 3PL dans BundlesIQ n'ajoute que des tags. Vous devez également configurer votre 3PL pour filtrer sur ces tags
• Utiliser une liste interdite au lieu d'une liste autorisée — L'approche de liste interdite a une petite fenêtre de course (commande créée avant que le tag soit appliqué). L'approche de liste autorisée (tag BIQ_READY requis) est plus fiable
• Oublier les commandes non-bundle — Si votre 3PL exige le tag BIQ_READY, assurez-vous que les commandes non-bundle soient également taguées ou utilisez une règle de filtrage combinée

Pages Associées

• Comment Fonctionne BundlesIQ
• Aperçu des Paramètres Globaux
• Configuration de ShipStation
• Liste de Vérification de Mise en Production