Installation et Autorisations
BundlesIQ s'installe via le Shopify App Store en utilisant l'authentification OAuth standard. Cette page explique quel accès l'application nécessite et pourquoi.
Installer BundlesIQ
- Visitez la liste de BundlesIQ sur le Shopify App Store
- Cliquez sur Ajouter l'application et confirmez l'installation sur votre boutique Shopify
- Examinez les autorisations demandées et approuvez-les
- Complétez l'assistant d'intégration pour sélectionner votre mode de gestion par défaut et configurer les paramètres de base
Autorisations Requises
BundlesIQ demande les portées d'accès Shopify suivantes lors de l'installation :
Produits
| Portée | Pourquoi BundlesIQ en a besoin |
|---|---|
read_products |
Rechercher des données de produits/variantes de bundles et de composants (prix, SKUs, statut, images) pour la détection, le calcul des prix et la modal de recherche de produits |
write_products |
Synchroniser les niveaux de stock de bundles dérivés et les prix de vente au détail vers le produit SKU fantôme lorsque la synchronisation des stocks ou la synchronisation des prix de vente est activée |
Commandes
| Portée | Pourquoi BundlesIQ en a besoin |
|---|---|
read_orders |
Détecter les bundles sur les commandes entrantes, lire les lignes d'articles, les étiquettes, les allocations de remises et les métadonnées pour le traitement et le tableau de bord de santé |
write_orders |
Écrire des étiquettes de traitement (BIQ_PROCESSING, BIQ_READY, BIQ_ERROR), écrire des métadonnées d'audit de transformation et mettre à jour les attributs de note de commande |
write_order_edits |
Transformer les commandes via l'API de modification de commande — ajouter des lignes d'articles de composants, appliquer des remises et modifier ou supprimer la ligne d'article de bundle |
Commandes Brouillon
| Portée | Pourquoi BundlesIQ en a besoin |
|---|---|
read_draft_orders |
Détecter les bundles sur les commandes brouillon et lire les données des lignes d'articles pour le traitement B2B et de gros |
write_draft_orders |
Transformer les commandes brouillon en remplaçant les lignes d'articles via la mutation draftOrderUpdate. Utilisé également pour revenir sur les transformations des commandes brouillon |
Inventaire
| Portée | Pourquoi BundlesIQ en a besoin |
|---|---|
read_inventory |
Calculer la disponibilité des bundles à partir des niveaux de stock de composants à travers les emplacements |
write_inventory |
Synchroniser l'inventaire des bundles dérivés vers la variante SKU fantôme. En mode Parent-Only (BOM), utilisé également pour réserver, consommer et libérer l'inventaire des composants via l'API de l'état d'inventaire de Shopify |
Exécution
| Portée | Pourquoi BundlesIQ en a besoin |
|---|---|
read_fulfillments |
Lire l'état de la commande d'exécution pour déterminer l'éligibilité à la retenue et vérifier l'état d'exécution pendant le traitement |
write_assigned_fulfillment_orders |
Placer et libérer des retenues d'exécution sur les commandes assignées à vos emplacements (protection 3PL) |
write_merchant_managed_fulfillment_orders |
Placer et libérer des retenues d'exécution sur les commandes d'exécution gérées par le marchand (protection 3PL) |
write_third_party_fulfillment_orders |
Placer et libérer des retenues d'exécution sur les commandes d'exécution tierces (protection 3PL) |
Remises, Emplacements et Autres Données
| Portée | Pourquoi BundlesIQ en a besoin |
|---|---|
read_discounts |
Lire les informations sur les codes de remise et les remises automatiques des commandes pour prendre en compte les remises promotionnelles dans l'allocation des prix des composants |
read_locations |
Lire les données d'emplacement de Shopify pour la synchronisation de l'inventaire multi-emplacements et la configuration de la stratégie d'emplacement Parent-Only (BOM) |
read_markets |
Lire la configuration des marchés et des devises pour le support de la tarification multi-devises |
read_locales |
Lire les paramètres de localisation de la boutique pour un contenu localisé |
read_metaobjects |
Lire les définitions de métaobjets utilisées par l'extension de vitrine pour l'affichage "Ce qui est inclus" |
read_returns |
Lire les données de retour pour suivre le comportement de réapprovisionnement des composants pour les commandes de bundles |
Webhooks Enregistrés
BundlesIQ s'abonne aux webhooks Shopify pour répondre aux événements de la boutique en temps réel. Les principaux groupes de webhooks sont décrits ci-dessous.
Traitement de Base
Ces webhooks pilotent la détection des bundles et la transformation des commandes :
| Webhook | But |
|---|---|
orders/create |
Détecter les nouvelles commandes contenant des produits de bundle et commencer le traitement |
orders/updated |
Détecter les changements de commande et soutenir les flux de travail de re-traitement |
orders/paid |
Déclencher le traitement pour les flux de travail soumis au paiement. Utilisé également par le mode Parent-Only (BOM) lorsque le moment de réservation est défini sur orders/paid |
orders/cancelled |
Libérer l'inventaire des composants réservé (mode Parent-Only) et mettre à jour l'état de traitement |
draft_orders/create |
Détecter les nouvelles commandes brouillon contenant des produits de bundle |
draft_orders/update |
Traiter les commandes brouillon lorsqu'elles sont créées ou modifiées |
draft_orders/delete |
Nettoyer l'état de traitement lorsqu'une commande brouillon est supprimée |
Synchronisation de l'Inventaire et du Catalogue
Ces webhooks maintiennent la disponibilité des bundles, la tarification et la configuration synchronisées avec votre catalogue Shopify :
| Webhook | But |
|---|---|
inventory_levels/update |
Recalculer la disponibilité des bundles lorsque le stock de composants change à n'importe quel emplacement |
inventory_levels/connect / disconnect |
Suivre quand l'inventaire est activé ou désactivé à un emplacement, affectant les calculs de disponibilité des bundles |
inventory_items/create / update / delete |
Suivre les changements dans les paramètres des articles d'inventaire (par exemple, statut de suivi, coût) pour les composants et les SKUs fantômes |
products/create / update / delete |
Détecter quand des produits de composants ou des SKUs fantômes sont créés, modifiés ou supprimés. Utilisé pour la synchronisation des prix de vente, les vérifications de statut et la validation des bundles |
collections/create / update / delete |
Suivre les changements de collection qui peuvent affecter la visibilité des produits de bundle |
Exécution et Cycle de Vie des Commandes
BundlesIQ surveille les événements d'exécution pour gérer les retenues de protection 3PL, suivre l'état des commandes pour le tableau de bord de santé et gérer la consommation d'inventaire en mode Parent-Only (BOM) :
| Webhook | But |
|---|---|
orders/fulfilled / orders/partially_fulfilled |
Suivre l'avancement de l'exécution. En mode Parent-Only, déclenche la consommation de l'inventaire des composants réservé |
orders/edited |
Détecter les modifications externes aux commandes qui ont déjà été traitées par BundlesIQ |
orders/delete |
Nettoyer l'état de traitement lorsqu'une commande est supprimée |
refunds/create |
Détecter les remboursements sur les commandes de bundle pour mettre à jour le tableau de bord de santé et, en mode Parent-Only, réapprovisionner l'inventaire des composants réservé ou consommé |
fulfillment_orders/* |
Un ensemble de webhooks de commande d'exécution (déplacé, fusionné, divisé, retenue libérée, routage complet, et autres) utilisés pour gérer les retenues d'exécution natives de Shopify pour la protection 3PL |
fulfillments/create / update |
Suivre la création et les mises à jour d'exécution pour l'état de traitement et la gestion du cycle de vie de l'inventaire |
fulfillment_events/create |
Suivre les événements de jalon d'exécution (par exemple, expédié, livré) |
Remises, Marchés et Emplacements
| Webhook | But |
|---|---|
discounts/create / update / delete |
Suivre les changements de remises qui peuvent interagir avec l'allocation des prix des bundles |
markets/create / update / delete |
Suivre les changements de configuration des marchés pour le support de la tarification multi-devises |
locations/create / update / delete |
Suivre les changements d'emplacement pour la synchronisation de l'inventaire multi-emplacements et la stratégie d'emplacement Parent-Only |
selling_plan_groups/create / update / delete |
Suivre les changements de plan de vente par abonnement pour la compatibilité avec les commandes d'applications d'abonnement |
Cycle de Vie de l'Application
BundlesIQ s'abonne aux webhooks de cycle de vie de l'application et de facturation à des fins opérationnelles :
| Webhook | But |
|---|---|
app/uninstalled |
Nettoyer les données de l'application, libérer les retenues d'exécution et révoquer l'accès lorsque l'application est supprimée |
app_subscriptions/update |
Suivre les changements de plan de facturation et les mises à jour d'utilisation |
app_subscriptions/approaching_capped_amount |
Déclencher des notifications lorsque l'utilisation excédentaire de Scale+ approche le plafond de dépenses |
app/scopes_update |
Détecter les changements dans les portées d'accès accordées |
shop/update |
Suivre les changements de configuration de la boutique (devise, fuseau horaire, plan) |
Stockage des Données
BundlesIQ stocke les données suivantes :
- Définitions de bundles — Nom du bundle, statut, référence SKU fantôme, liste des composants, configuration des prix et contraintes
- Journaux de traitement — Enregistrements horodatés de chaque transformation de commande, y compris le statut de succès/échec, les indicateurs et les détails de prix
- Instances de bundles — Instantané par commande de quels bundles ont été détectés, comment ils ont été transformés et le mappage des lignes d'articles résultantes
- Paramètres de la boutique — Votre préférence de mode de gestion, portée de traitement, configuration de protection 3PL et paramètres de synchronisation
Toutes les données sont stockées en toute sécurité dans l'infrastructure cloud de BundlesIQ. Les métadonnées des bundles sont également écrites dans les métadonnées de commande Shopify pour l'auditabilité.
Exigences en matière de Pare-feu et de Réseau
BundlesIQ fonctionne comme un service hébergé dans le cloud. Aucune configuration de pare-feu n'est requise de votre part. La livraison des webhooks utilise l'infrastructure standard de webhooks de Shopify.