Configurer Biscuits Bundles

Permettez à vos clients de composer un pack dans votre app native, depuis un bandeau Home, un lien produit ou une entrée dédiée du menu.

1. Préparer le pack dans Biscuits Bundles

Installez Biscuits Bundles dans Shopify et créez votre pack dans cette application. L’intégration prend en charge une étape de sélection, des quantités variables avec un incrément de un et une remise en pourcentage, fixe ou par paliers de quantité. La V1 propose une variante à la fois par produit et jusqu’à 249 variantes au total. Les sélections obligatoires, champs personnalisés, packs à prix fixe et parcours à plusieurs étapes ne sont pas encore pris en charge.

La page produit doit contenir le configurateur Biscuits et être accessible sur la boutique web. La boutique web doit être accessible publiquement, sans mot de passe. Les produits proposés et les règles du pack restent gérés dans Biscuits.

2. Publier les produits sur le canal de vente Makappi

  1. Dans Shopify → Produits, ouvrez le produit parent du pack créé par Biscuits.
  2. Vérifiez que son statut est Actif.
  3. Dans Publication / Canaux de vente et applications, cliquez sur Gérer et cochez Makappi.
  4. Cliquez sur Terminé, puis sur Enregistrer sur la fiche produit. Cocher le canal sans enregistrer le produit ne suffit pas.
  5. Répétez pour tous les produits composant le pack et vérifiez leur disponibilité dans les marchés où votre app vend.

3. Configurer l’intégration Makappi

Dans Paramètres → Intégrations → Biscuits Bundles, activez l’intégration, puis enregistrez et publiez la configuration Makappi. Aucun pack, URL de produit ou limite de version à renseigner. Lorsqu’un client ouvre un produit, l’app lit automatiquement sa page web et ouvre le configurateur natif si elle contient un pack Biscuits compatible. Les produits classiques conservent leur fiche habituelle.

4. Ajouter un accès

  • Collections : dans les réglages de l’intégration, activez « Afficher Composer votre pack sous les collections ». Personnalisez le libellé dans chaque langue et choisissez une image facultative. Le bouton apparaît en bas de la liste principale, avec le style du menu.
  • Menu : ajoutez le bloc Biscuits Bundles depuis le bas de la bibliothèque, puis personnalisez son libellé, son icône et sa position. Aucun produit à sélectionner.
  • Home : dans un bandeau ou une image de diaporama, choisissez Select a Destination → Composer votre pack. Aucune URL à saisir.

Ces trois accès recherchent les produits portant le tag biscuits-bundle, publiés sur le canal Makappi. Avec un seul pack, sa sélection de produits s’ouvre directement. Avec plusieurs packs, le client choisit d’abord lequel composer. Conservez ce tag sur les produits parents. Les liens vers un produit précis continuent d’ouvrir son configurateur.

Désactiver l’intégration masque ses entrées de menu dédiées et arrête la détection automatique. Gérez la disponibilité des packs dans Shopify et Biscuits, et retirez les liens vers les produits abandonnés.

5. Tester avant de le proposer aux clients

Choisissez les variantes et quantités, vérifiez les disponibilités et attendez le calcul du prix Shopify, puis ajoutez le pack. L’estimation initiale est remplacée par le prix du pack avant que le bouton d’ajout soit disponible. Shopify calcule le prix final dans le panier : contrôlez ce montant et celui du checkout pour chaque devise de vente, remises applicables comprises. Testez les changements de quantité, la suppression du dernier pack, deux compositions différentes du même pack et un panier contenant des produits classiques. Ouvrez le checkout avec un compte client si votre app l’exige.

En cas de problème

Si le chargement échoue, vérifiez que la page produit publique contient le configurateur Biscuits, que ses règles sont prises en charge et que le parent et ses composants sont publiés sur Makappi. Une erreur de détection bloque la fiche et propose de réessayer, sans permettre d’ajouter un pack non configuré. Après une modification dans Biscuits, le cache de configuration peut prendre jusqu’à une minute à expirer : actualisez ensuite l’écran de l’app. Une restriction de marché ou une rupture de stock peut bloquer une variante même si le produit est publié.

Retour à la FAQ