Le script Shopify est un serveur Node.js qui synchronise automatiquement les prix via l'Admin API Shopify. Modes webhook, poll, ou les deux simultanement.
1
Integration
Integration Shopify
Sommaire
2
Pre-requis
| Composant | Version minimale | Recommandee |
|---|---|---|
| Node.js | 18.0 | 22 LTS |
| Shopify API | 2024-01 | 2024-10+ |
| Express | 4.18 | 4.21+ |
| Plan Shopify | Basic | Advanced+ (rate limit 4 req/s) |
| Plan Rivalyse | Pro | Business+ |
3
Fonctionnalites
- Mode Webhook : serveur Express recevant les events en temps reel
- Mode Poll : interrogation periodique de l'API (configurable, defaut 30 min)
- Mode Both : les deux simultanement
- Correspondance SKU automatique vers les variants Shopify
- Gestion du rate limiting Shopify (retry automatique sur 429)
- Construction d'un SKU map complet en mode poll
- Config via variables d'environnement ou
config.json - Header
X-Module-Version: shopify/1.0.0
4
Installation
- Creer un Custom App dans Shopify Admin (scope
read_products+write_products) - Copier le Admin API access token
- Installer le script :
mkdir rivalyse-sync && cd rivalyse-sync cp rivalyse-sync.js . && npm init -y && npm install express- Configurer les variables d'environnement ou creer
config.json
5
Configuration
# Variables d'environnement
export RIVALYSE_API_URL="https://api.votre-domaine.fr"
export RIVALYSE_JWT_TOKEN="eyJhbGciOi..."
export RIVALYSE_WEBHOOK_SECRET="votre-secret-partage"
export SHOPIFY_STORE="ma-boutique.myshopify.com"
export SHOPIFY_ACCESS_TOKEN="shpat_xxxxxxxxxxxx"
export SYNC_MODE="webhook" # webhook | poll | both
export POLL_INTERVAL_MS="1800000" # 30 min
export WEBHOOK_PORT="3500"
6
Demarrage
# Demarrer le serveur
node rivalyse-sync.js
# Avec PM2 (production)
pm2 start rivalyse-sync.js --name rivalyse-shopify-sync
# Poll unique (pour cron externe)
node rivalyse-sync.js --poll
Mode continu :
7
Reverse proxy (production)
location /rivalyse-webhook {
proxy_pass http://127.0.0.1:3500/webhook;
proxy_set_header X-Webhook-Signature $http_x_webhook_signature;
}
En production, utiliser Nginx devant le port 3500 pour SSL :
8
Rate Limiting Shopify
| Plan Shopify | Limite |
|---|---|
| Basic / Standard | 2 requetes/seconde |
| Advanced / Plus | 4 requetes/seconde |
Le script insere un delai de 550ms entre chaque mise a jour en mode poll. En cas de 429, il attend le delai Retry-After.
9
Depannage
| Probleme | Solution |
|---|---|
| SHOPIFY_STORE required | Configurer la variable d'environnement ou config.json |
| express is required | npm install express |
| SKU not found | Verifier que le SKU variant Shopify correspond au SKU Rivalyse |
| API 401 | Token JWT expire — le regenerer |
| Shopify 403 | Verifier les scopes de l'app Shopify (write_products) |