AccueilSolutionsÀ proposDocumentation

Démarrage rapide : Créez votre premier bundle

Suivez ce guide pour créer votre premier bundle dans BundlesIQ, exécuter le test intégré et vérifier que la transformation des commandes fonctionne correctement.

Terminologie

BundlesIQ associe les variantes Shopify aux variantes.

  • Un produit peut avoir une ou plusieurs variantes
  • Un ghost SKU dans BundlesIQ est la variante achetable du bundle (la variante que les clients ajoutent au panier)
  • Composants sont les variantes incluses dans le bundle (avec des quantités)

En d'autres termes : BundlesIQ fonctionne au niveau du SKU (variantes), même si l'interface administrateur Shopify parle souvent de "produits".

Avant de commencer

  • BundlesIQ est installé sur votre boutique Shopify
  • Vous avez terminé l'intégration et sélectionné un mode de gestion par défaut
  • Vos variantes de composants existent déjà dans Shopify (BundlesIQ peut créer l'élément de bundle, mais les composants doivent déjà exister)
  • Vous avez soit :
    • déjà un produit/une variante Shopify que vous souhaitez utiliser comme ghost SKU, ou
    • vous créerez la variante ghost SKU directement dans BundlesIQ lors de la création du bundle (recommandé pour la rapidité)

Étape 1 (Optionnelle) : Préparez votre variante Ghost SKU dans Shopify

Vous pouvez sauter cette étape si vous prévoyez de cliquer sur Créer un nouvel élément dans BundlesIQ.

Si vous avez déjà un produit/une variante Shopify que vous souhaitez utiliser comme ghost SKU :

  1. Ouvrez le produit bundle dans l'interface administrateur Shopify
  2. SKU est optionnel : BundlesIQ identifie les éléments par ID de variante, pas par SKU
    • Vous pouvez toujours définir un SKU pour vos propres rapports/workflows
  3. Suivi des stocks (important) :
    • Si vous souhaitez que Shopify empêche la vente excessive :
      • Activez Suivre la quantité pour la variante ghost SKU
      • Désactivez Continuer à vendre lorsque en rupture de stock
    • Si vous activez Synchroniser l'inventaire du bundle dans BundlesIQ, la variante ghost SKU doit avoir le suivi des stocks activé (BundlesIQ met à jour la quantité disponible en fonction des composants).
  4. Expédition (optionnelle) :
    • De nombreuses boutiques définissent le ghost SKU pour ne pas nécessiter d'expédition puisque les articles physiques sont les composants.
    • Certaines boutiques maintiennent l'expédition activée si elles s'appuient sur la variante ghost SKU pour les calculs d'expédition au moment du paiement. Choisissez ce qui correspond à votre workflow.

Étape 2 : Créez le bundle dans BundlesIQ

  1. Naviguez vers BundlesIQ > Bundles dans la barre latérale de votre interface administrateur Shopify
  2. Cliquez sur Créer un bundle (en haut à droite)

2A) Carte d'informations et de configuration

  1. Donnez un nom au bundle
    • Référence interne uniquement (recommandé : correspondre ou ressembler étroitement au nom de l'élément ghost SKU)
  2. (Optionnel) Mode de tarification
    • Par défaut, il correspond à celui de votre boutique (section réduite ; peut être remplacé par bundle)
  3. (Optionnel) Mode de gestion
    • Par défaut, il correspond à celui de votre boutique (section réduite ; peut être remplacé par bundle)

2B) Carte des composants du bundle

1) Sélectionnez ou créez l'élément Ghost SKU

  • Cliquez sur Sélectionner un produit depuis Shopify pour choisir un élément Shopify existant, ou
  • Cliquez sur Créer un nouvel élément pour créer l'élément de bundle depuis BundlesIQ (chemin le plus rapide)

Remarque : Créer l'élément ghost SKU dans BundlesIQ est plus limité que dans l'interface administrateur Shopify. Les composants ne peuvent pas être créés ici—les composants doivent déjà exister dans Shopify.

2) Ajouter des composants

  • Cliquez sur Ajouter des composants pour rechercher et ajouter des variantes de composants, ou
  • Cliquez sur Importer CSV pour ajouter en masse des composants + quantités

Si vous importez un CSV :

  1. Téléchargez le modèle
  2. Dans la colonne identifier, collez l'un des éléments suivants :
    • SKU, code-barres, ID de variante ou GID Shopify
  3. Dans la colonne quantity, entrez la quantité de composant par bundle
    • La quantité par défaut est 1 si omise

3) Configurez les détails de tarification (dépend du Mode de Tarification / Mode de Gestion)

Si le Mode de Tarification = Dirigé par le Bundle :

  • Définissez le prix de détail de la variante ghost SKU (c'est le prix du bundle que les clients paient)
  • Assurez-vous que la somme des prix de détail des composants × quantités est >= le prix du bundle
    • Pourquoi : Shopify n'autorise pas à augmenter le prix d'un élément de ligne de composant au-dessus du prix de la variante, donc l'allocation doit s'inscrire dans les prix de détail des composants.

Si le Mode de Tarification = Dirigé par le Composant :

  • Pour chaque composant, vous pouvez configurer des prix tels que :
    • Pas de réduction
    • Pourcentage de réduction
    • Montant de réduction
    • Prix fixe
  • Contrainte de prix fixe : le prix fixe doit être <= le prix de détail du composant.

Si le Mode de Gestion = Parent-Uni (BOM) :

  • Ce workflow est axé sur les coûts et se comporte différemment des modes Opérationnel/Hybride/Rapport.
  • Dans ce mode, vous verrez généralement :
    1. Le prix du bundle (ghost SKU) doit être >= le coût total des composants
    2. Un bouton Ajouter un coût pour la main-d'œuvre/frais généraux/non-consommables
    3. Résumés des coûts / bénéfices / marges % en bas

2C) Carte des paramètres avancés

Selon le mode de gestion et la configuration de l'inventaire du ghost SKU, vous pouvez voir des options telles que :

  • Synchroniser l'inventaire du bundle
  • Synchroniser le prix de détail du bundle

Rappel : La synchronisation de l'inventaire du bundle nécessite que la variante ghost SKU suive l'inventaire dans Shopify.

2D) Enregistrer et activer

  1. Définissez le statut sur Actif (si ce n'est pas déjà fait)
  2. Cliquez sur Enregistrer

BundlesIQ surveille maintenant les commandes/commandes brouillon contenant la variante ghost SKU de ce bundle (en fonction de vos paramètres de traitement).

Étape 3 : Exécutez le test intégré

Au lieu de passer manuellement une commande test, utilisez le bouton Tester le bundle en haut de la page du bundle (après avoir enregistré et activé).

Cela exécute une série de contrôles pour détecter les problèmes tôt.

Ce que fait "Tester le bundle" (niveau élevé)

  1. Crée une commande brouillon (valide les webhooks + le pipeline de traitement)
  2. Vérifie que la commande brouillon a été transformée correctement pour la configuration du bundle
  3. Vérifie que les métadonnées/métachamps du bundle ont été écrits comme prévu
  4. Supprime la commande brouillon (garde votre boutique propre)

Vous pouvez brièvement voir la commande brouillon apparaître dans l'interface administrateur Shopify avant qu'elle ne soit supprimée.

Étape 4 : Vérifiez la transformation dans l'interface administrateur Shopify (Recommandé)

Le test couvre la plupart des validations, mais il est toujours judicieux de vérifier un ou deux scénarios réels dans l'interface administrateur Shopify.

  1. Ouvrez une commande/commande brouillon dans l'interface administrateur Shopify
  2. Confirmez que les éléments de ligne correspondent à votre mode de gestion :

Hybride

  • Le ghost SKU reste à 0,00 $
  • Les éléments de ligne de composant apparaissent avec des prix alloués
  • Le total de la commande correspond au prix du bundle original

Opérationnel

  • Le ghost SKU est supprimé (quantité définie à 0 / supprimée)
  • Seuls les éléments de ligne de composant restent avec des prix alloués
  • Le total de la commande correspond au prix du bundle original

Rapport

  • Le ghost SKU reste à son prix d'origine
  • Les éléments de ligne de composant apparaissent à 0,00 $
  • Le total de la commande correspond au prix du bundle original

Parent-Uni (BOM)

  • Le ghost SKU reste à son prix d'origine
  • Aucun élément de ligne de composant n'apparaît
  • Le total de la commande correspond au prix du bundle
  1. Vérifiez le tableau de bord Santé de BundlesIQ pour confirmer que le traitement s'est terminé sans erreurs

Étape 5 : Vérifiez l'inventaire (Optionnel)

Le comportement de l'inventaire a deux couches différentes :

  1. Inventaire des composants (comportement natif Shopify) :
    Lorsque les composants sont sur la commande (Opérationnel/Hybride/Rapport), Shopify met à jour l'inventaire via son flux de réservation/exécution normal. Lors des premiers tests, cela peut être difficile à valider sans implications réelles sur l'inventaire.

  2. Inventaire du ghost SKU (option de synchronisation BundlesIQ) :
    Si Synchroniser l'inventaire du bundle est activé, BundlesIQ maintient la quantité disponible du ghost SKU alignée sur la disponibilité des composants (nécessite que le suivi des stocks soit activé sur la variante ghost SKU).

Problèmes courants

  • La commande n'a pas été transformée
    • Confirmez que le statut du bundle est Actif
    • Confirmez que votre portée de traitement inclut le type de commande (commandes, commandes brouillon ou les deux)
    • Confirmez que les webhooks BundlesIQ sont enregistrés et activés (Paramètres)
    • Confirmez que les variantes ghost SKU et de composants sont actives (pas archivées / pas brouillon)
  • Les prix ne semblent pas corrects
    • Vérifiez à nouveau la configuration du Mode de Tarification et des contraintes (en particulier les règles de prix fixe et les limites d'allocation dirigées par le bundle). Voir Stratégie de Tarification
  • Le ghost SKU apparaît toujours sur la commande
    • Attendu dans Hybride (à 0 $), Rapport (au prix plein), et Parent-Uni (au prix plein, sans composants)
    • Seul le mode Opérationnel le supprime entièrement

Prochaines étapes