Centre d’aide
Price Checker
Connecter WooCommerce
L’écriture inverse met à jour les prix de votre boutique WooCommerce par l’intermédiaire de l’API REST de WooCommerce, à l’aide de clés que votre boutique nous délivre lors d’un flux d’autorisation unique (wc-auth). Aucune extension ni modification de code n’est requise sur votre boutique — l’API REST et l’écran d’autorisation propres à WooCommerce font le travail.
Ce dont vous avez besoin
- Un compte administrateur sur votre site WordPress.
- Votre boutique servie en HTTPS. Le flux d’autorisation de WooCommerce nous retransmet vos clés API par une connexion sécurisée, et il refuse de fonctionner en HTTP simple.
- Les permaliens conviviaux activés (Réglages → Permaliens → toute option autre que « Simple »). L’écran d’autorisation de WooCommerce et son API REST dépendent tous deux de règles de réécriture que les permaliens simples ne fournissent pas — voir Dépannage ci-dessous si vous n’êtes pas certain de l’option utilisée.
- Le forfait Max ou Enterprise — l’écriture inverse vers WooCommerce, comme les autres connecteurs de plateforme, est offerte sur les forfaits Max et Enterprise.
Connexion
- Accédez à Paramètres → Intégrations.
- Choisissez WooCommerce et saisissez l’URL de votre boutique (par exemple
https://boutique.exemple.com). - Vous serez redirigé vers votre boutique pour vous connecter en tant qu’administrateur, si ce n’est pas déjà fait.
- WooCommerce affiche un écran d’approbation qui énumère exactement l’accès demandé : accès en lecture/écriture à votre boutique, limité aux produits. Approuvez pour continuer.
- Votre boutique crée une paire de clés API REST et nous la retransmet directement — vous ne voyez ni ne copiez jamais de clé vous-même. Une fois cette transmission réussie, la connexion est enregistrée et vous êtes ramené à la page d’intégration.
Dans la liste WooCommerce → Réglages → Avancé → API REST de votre boutique, la clé que nous créons apparaît avec la description « Agnotiq MarginTide Pricing Intelligence - API (…) ». Si vous vous êtes connecté avant l’adoption de ce nom, votre clé existante affiche plutôt « Agnotiq Price Checker - API (…) » — il s’agit de la même connexion dans les deux cas, et les deux continuent de fonctionner; vous n’avez pas besoin de vous reconnecter uniquement pour voir le nouveau nom.
Quels prix l’écriture inverse peut mettre à jour
L’écriture inverse lit et écrit le champ prix habituel de vos produits.
- Le prix d’un produit simple est lu et écrit directement par son UGS.
- Le prix d’un produit variable se trouve sur chacune de ses variations, et non sur le produit parent — l’écriture inverse résout une UGS de variation vers sa variation précise et y écrit le prix, indépendamment de ses variations sœurs et de son parent.
- Un produit parent (variable) qui n’a pas de prix propre — parce que la tarification n’existe que sur ses variations — n’a rien que l’écriture inverse puisse mettre à jour si vous ciblez une recommandation sur l’UGS du parent plutôt que sur celle d’une variation.
Révoquer l’accès
Vous pouvez révoquer l’accès des deux côtés :
- Dans cette application : accédez à Paramètres → Intégrations → WooCommerce → Déconnecter. La clé enregistrée est supprimée immédiatement; les approbations en attente restent dans la file et peuvent être rejetées manuellement.
- Dans votre boutique : WooCommerce → Réglages → Avancé → API REST, trouvez la clé décrite ci-dessus, puis révoquez-la ou supprimez-la à cet endroit. Votre prochain changement de prix échouera et vous invitera à vous reconnecter.
Dépannage
Pendant la connexion :
| Ce que vous voyez | Ce que cela signifie |
|---|---|
| Une erreur 404 pendant l’autorisation, ou le flux de connexion n’atteint jamais l’écran d’approbation | Votre boutique utilise des permaliens Simple. Passez à toute autre structure de permaliens sous Réglages → Permaliens, puis tentez de vous connecter à nouveau — les permaliens simples ne peuvent pas prendre en charge l’autorisation ou les routes de l’API REST de WooCommerce. |
| Votre boutique affiche « An error occurred in the request and at the time were unable to send the consumer data » | Votre boutique n’a pas pu nous joindre pour livrer la clé — généralement un pare-feu, une extension de sécurité, une restriction des connexions sortantes sur le serveur de la boutique, ou un certificat TLS expiré ou mal configuré. Vérifiez avec la personne responsable de votre hébergement, puis réessayez. |
| Vous revenez à la page d’intégration avec un avis « connexion refusée » | Vous (ou la personne qui a approuvé la demande) l’avez refusée, ou avez annulé à l’écran de connexion WordPress. Recommencez à partir de l’étape 2 ci-dessus si vous souhaitez vous connecter. |
| Vous revenez à la page d’intégration avec un avis « nous n’avons pas reçu les clés » | Votre boutique a approuvé la demande, mais la clé ne nous est jamais parvenue — généralement le même problème de connectivité que le cas « unable to send the consumer data » ci-dessus. Réessayez; si le problème persiste, vérifiez la connectivité sortante de votre boutique. |
Une fois connectée, lors de changements de prix individuels :
| Code de motif | Ce que cela signifie | Quoi faire |
|---|---|---|
auth_failed | Votre boutique a rejeté la clé enregistrée. Généralement, la clé a été révoquée ou régénérée du côté de la boutique. Si vous êtes certain que la clé est encore valide et que le problème persiste, votre hébergeur retire peut-être l’en-tête d’autorisation des requêtes REST avant que WooCommerce ne le voie — contactez le soutien. | Reconnectez la boutique. Si la reconnexion ne règle pas le problème, contactez le soutien. |
sku_not_found | L’UGS de la recommandation ne correspond à aucun produit ni variation dans votre boutique, ou correspond au parent d’un produit variable (qui n’a pas de prix propre — voir Quels prix l’écriture inverse peut mettre à jour ci-dessus). | Confirmez que l’UGS existe dans WooCommerce et, pour les produits variables, qu’il s’agit de l’UGS d’une variation. |
ambiguous_sku | Plus d’un produit ou d’une variation dans votre boutique partage cette UGS. | Rendez les UGS uniques dans WooCommerce, puis réessayez. |
transport_failed | La requête vers votre boutique a expiré ou la connexion a été interrompue avant que nous recevions une réponse. | Généralement temporaire — réessayez. Si le problème persiste, vérifiez que votre boutique est accessible et n’est pas surchargée. |
vendor_rejected | WooCommerce a rejeté l’écriture elle-même (par exemple, le produit n’existe plus, ou le parent d’une variation ne correspond plus à ce que nous avions résolu). | Vérifiez le produit dans WooCommerce, puis réessayez à partir d’une recommandation à jour. |
Conseils
- Testez une nouvelle connexion sur un seul produit à faible risque avant d’approuver un lot complet de recommandations par ce canal.
- Si le contrôle de santé quotidien de votre boutique échoue deux fois de suite, nous afficherons une bannière « attention requise » sur l’intégration et enverrons un courriel à la personne qui l’a connectée — c’est un avis, pas un blocage, donc les approbations peuvent tout de même réussir si la boutique est en fait accessible.
- La vérification en conditions réelles de ce flux sur une installation WooCommerce en production, ainsi qu’une décision sur l’offre d’une extension WooCommerce Marketplace à la place du flux d’autorisation actuel, sont prévues pour une prochaine version (#1429) — le connecteur ci-dessus est celui qui est offert aujourd’hui.
Pour aller plus loin
- Poussez les prix acceptés vers votre boutique — comment l’écriture inverse et les approbations fonctionnent pour chaque connecteur.
- Définissez vos politiques de tarification et garde-fous — les règles que l’écriture inverse respecte.
- Invitez votre équipe et définissez les rôles — attribuez le rôle d’approbateur.