Connectez PrestaShop à votre veille tarifaire en quelques minutes

Le module Rivalyse Sync écoute les événements price.changed générés par Rivalyse et applique le nouveau prix dans votre PrestaShop en quelques secondes via webhook, ou dans les 30 minutes suivantes via cron périodique. La synchronisation est bidirectionnelle par référence produit (SKU).

Fonctionnalités incluses :

• Mode Webhook : réception des événements price.changed en temps réel
• Mode Cron : polling périodique de l'API (configurable, défaut 30 min)
• Correspondance automatique par référence produit (SKU)
• Mise à jour du prix standard et/ou du prix promo (specific_price)
• Vérification HMAC-SHA256 (timing-safe via hash_equals)
• Header X-Module-Version: prestashop/1.0.0 pour le suivi admin
• Logs dans le dossier var/logs/ de PrestaShop

Vérifiez que votre environnement répond aux exigences minimales avant d'installer Rivalyse Sync. La version PrestaShop la plus récente est recommandée pour bénéficier des dernières optimisations de l'API interne.

L'installation prend moins de 15 minutes. Aucune dépendance Composer ni librairie externe n'est requise : le module est un fichier PHP natif.

1. Téléchargez le module rivalyse-sync.php depuis votre dashboard Rivalyse
2. Copiez-le dans modules/rivalysesync/ de votre PrestaShop
3. Back-office → Modules → Rechercher "Rivalyse Sync" → Installer
4. Renseignez : URL API Rivalyse, token JWT, secret webhook
5. Optionnel : planifiez le cron pour activer le mode poll (voir section suivante)

Une fois installé, le module apparaît dans la liste des modules actifs et enregistre son activation dans var/logs/rivalyse.log.

Deux modes de synchronisation sont disponibles. Le webhook offre une réactivité maximale (quelques secondes), le cron est plus simple à mettre en place si votre hébergeur ne supporte pas les webhooks entrants.

URL webhook à déclarer dans le dashboard Rivalyse :

Rivalyse envoie une requête POST signée HMAC-SHA256 à cette URL dès qu'un changement de prix est détecté.

Cron pour le mode poll (toutes les 30 minutes) :

Les deux modes peuvent fonctionner simultanément. En cas de doublon, la mise à jour la plus récente est conservée.

Le module identifie chaque produit PrestaShop par sa référence (champ "Référence" dans le back-office). Cette référence doit être identique au SKU configuré dans Rivalyse pour que la synchronisation fonctionne.

Pour les produits à déclinaisons, le module met à jour la déclinaison dont la référence correspond au SKU Rivalyse. Les déclinaisons sans correspondance ne sont pas modifiées.

Si aucune correspondance n'est trouvée, le module enregistre un avertissement dans var/logs/rivalyse.log sans lever d'erreur fatale.

Chaque communication entre Rivalyse et votre boutique est authentifiée et vérifiée. Aucune donnée sensible (prix, références) ne transite en clair.

• Vérification HMAC-SHA256 sur chaque webhook (timing-safe via hash_equals)
• Token JWT expirant après 7 jours, à renouveler depuis le dashboard
• Ne jamais exposer le secret webhook ou le token JWT dans le code source ou en dépôt Git
• Le module envoie le header X-Module-Version pour faciliter le suivi des mises à jour côté admin

En cas de dysfonctionnement, commencez par consulter var/logs/rivalyse.log dans votre PrestaShop. La majorité des erreurs provient d'une mauvaise configuration du token JWT ou d'une discordance de référence produit.