Synchronisation des produits Shopify
Comment les produits, les commandes et les collections se synchronisent entre Shopify et Umbrella.
Synchronisation des produits Shopify
Umbrella utilise les webhooks Shopify pour synchroniser automatiquement et en temps réel vos produits, collections, commandes, clients et données d’expédition. Lorsqu’un changement survient dans votre boutique Shopify, Umbrella met automatiquement à jour l’éligibilité aux garanties, les prix et les polices.
Données synchronisées
Produits
Umbrella synchronise le titre du produit, son handle, son type, son fournisseur, ses tags, ses variantes (ID, titre, prix, SKU), ses images et son appartenance aux collections. Ces données alimentent les règles d’attribution des plans de garantie (par exemple, « appliquer à tous les produits portant le tag ‘electronics’ »).
Commandes
Umbrella traite le numéro de commande, les articles, les informations client, le statut de paiement, le statut d’expédition ainsi que les données de remboursement et d’annulation. Ces informations permettent de créer et d’activer les polices de garantie, et de calculer les délais de réclamation.
Autres données
- Collections — Utilisées pour les règles d’éligibilité aux garanties basées sur les collections
- Clients — Associés aux polices de garantie pour les recherches par compte
- Expéditions — Suivies pour déterminer quand le délai de réclamation commence (s’il est configuré pour démarrer à l’expédition)
Retraitement manuel
Si les données semblent désynchronisées, lancez un retraitement manuel depuis Tableau de bord → Paramètres → Intégrations → Shopify :
- Retraiter les produits — Récupère à nouveau tous les produits et met à jour le cache local
- Retraiter les commandes — Récupère à nouveau les commandes récentes et rapproche les polices de garantie
- Retraiter les collections — Récupère à nouveau les collections et met à jour les règles d’éligibilité
Pour les catalogues volumineux, l’opération peut prendre plusieurs minutes.
Fiabilité des webhooks
- Shopify livre chaque webhook au moins une fois (les doublons sont gérés sans risque)
- Si l’endpoint du webhook est temporairement indisponible, Shopify réessaie avec un délai exponentiel pendant 48 heures au maximum
- Utilisez le retraitement manuel pour récupérer les données manquées
Dépannage
| Problème | Solution |
|---|---|
| Les nouveaux produits n’apparaissent pas dans les règles de garantie | Attendez 1 à 2 minutes le traitement du webhook, puis vérifiez l’état de synchronisation des produits |
| Une commande ne crée pas de police de garantie | Vérifiez que la commande contient un article de garantie et qu’elle a été payée |
| Le délai de réclamation ne démarre pas | Confirmez que la commande a été expédiée |
| Produits désynchronisés après un import en masse | Utilisez le retraitement manuel pour actualiser toutes les données produits |
Voir aussi
- Intégration Shopify — Configuration générale de la connexion Shopify
- Extensions de paiement Shopify — Affichage de la garantie au paiement
- Créer des plans de garantie — Règles d’éligibilité des produits
