Le module PrestaShop synchronise automatiquement les prix detectes par Rivalyse vers votre boutique. Deux modes : webhook temps reel (notification instantanee) et cron periodique (toutes les 30 min).
1
Integration
Integration PrestaShop
Sommaire
2
Pre-requis
| Composant | Version minimale | Recommandee |
|---|---|---|
| PrestaShop | 1.7.0 | 8.x |
| PHP | 7.4 | 8.1+ |
| MySQL | 5.7 | 8.0+ |
| Plan Rivalyse | Pro | Business+ |
3
Fonctionnalites
- Mode Webhook : reception des events
price.changeden temps reel - Mode Cron : polling periodique de l'API (configurable)
- Correspondance automatique par reference produit (SKU)
- Mise a jour du prix standard et/ou du prix promo (
specific_price) - Verification HMAC-SHA256 (timing-safe)
- Header
X-Module-Version: prestashop/1.0.0pour suivi admin - Logs dans le dossier
var/logs/PrestaShop
4
Installation
- Telecharger le module
rivalyse-sync.phpdepuis le dashboard - Copier dans
modules/rivalysesync/de votre PrestaShop - Back-office → Modules → Rechercher "Rivalyse Sync" → Installer
- Configurer : URL API, Token JWT, Secret webhook
- Optionnel : planifier le cron pour le mode poll
5
Configuration du cron
# Toutes les 30 minutes
*/30 * * * * php /var/www/html/modules/rivalysesync/cron.php >> /var/log/rivalyse-ps.log 2>&1
Pour le mode poll (en complement ou remplacement du webhook) :
6
URL webhook
https://votre-boutique.com/module/rivalysesync/webhook
Configurez cette URL dans le dashboard Rivalyse :
7
Correspondance produits
Le module cherche la reference produit PrestaShop correspondant au SKU Rivalyse. Les references doivent correspondre exactement.
Si un produit a des declinaisons, le module met a jour la declinaison dont la reference correspond.
8
Securite
- Verification HMAC-SHA256 sur chaque webhook (timing-safe via
hash_equals) - Token JWT expire apres 7 jours — le renouveler regulierement
- Ne jamais exposer le secret webhook ou le token JWT dans le code source
- Le module envoie un header
X-Module-Versionpour le suivi des mises a jour
9
Depannage
| Probleme | Solution |
|---|---|
| Module non visible | Verifier que le dossier est dans modules/rivalysesync/ et que le fichier principal est correct |
| Erreur 500 webhook | Verifier les logs PrestaShop (var/logs/) et la configuration PHP |
| Prix non mis a jour | Verifier que la reference produit correspond au SKU Rivalyse |
| Erreur HMAC | Verifier que le secret webhook correspond a celui configure dans le dashboard |
| Token expire | Regenerer le token JWT depuis le dashboard (expire 7 jours) |