Connecter WooCommerce à Epsylon

Avant de commencer

• Un compte Epsylon avec le module e-commerce (offre Shop)
• Un site WordPress 5.8 ou plus récent, avec WooCommerce 6.0 ou plus
• PHP 7.4 minimum sur l'hébergement
• Un accès administrateur au site WordPress

Installation pas à pas

1. 1. Créer la clé d'API dans Epsylon

   Dans Epsylon : Paramètres → Intégrations → Clés API → Créer une clé. Donnez-lui un nom explicite (« Boutique WooCommerce ») et choisissez le magasin concerné.

   • La clé et le secret ne s'affichent qu'une seule fois, à la création : copiez-les immédiatement.
   • Une clé est liée à un magasin : avec plusieurs magasins, créez une clé par boutique.
   • Les permissions nécessaires sont read, write:stock et write:orders. Les clés créées depuis cet écran les reçoivent automatiquement.

   Une clé créée directement par l'API sans préciser les permissions n'a que « read ». Elle répond correctement aux lectures et refuse silencieusement toutes les écritures. Le test de connexion de l'extension détecte ce cas et vous le dit.
2. 2. Activer WooCommerce côté Epsylon

   Toujours dans Paramètres → Intégrations, ouvrez le panneau WooCommerce et activez-le. Trois réglages comptent.

   • Vendeur associé aux commandes web. À défaut, Epsylon crée un utilisateur système « WordPress Bot » qui portera ces documents.
   • Type de document créé à réception d'une commande : brouillon, bon de commande ou facture.
   • Email de notification, facultatif : vous recevez un message à chaque commande synchronisée.
3. 3. Installer l'extension sur WordPress

   Téléchargez l'archive ZIP en haut de cette page, puis dans WordPress : Extensions → Ajouter → Téléverser une extension → choisir le fichier → Installer → Activer.

   • WooCommerce doit être installé et actif : l'extension le vérifie et refuse de démarrer sinon.
   • L'extension est compatible avec le stockage haute performance des commandes (HPOS) : rien à désactiver.
   • Pour mettre à jour, désactivez puis supprimez l'ancienne version avant de téléverser la nouvelle. Vos réglages sont conservés.
4. 4. Renseigner la connexion

   Dans WordPress : WooCommerce → Epsylon Sync. Saisissez l'adresse de votre instance Epsylon, la clé et le secret, puis enregistrez et cliquez sur « Tester la connexion ».

   • L'adresse est celle de votre instance, par exemple https://app-epsylon.fr — sans /api à la fin.
   • Le test vérifie deux choses : que la clé est reconnue, et qu'elle porte bien les permissions d'écriture.
   • S'il manque une permission, le message vous dit précisément laquelle : corrigez la clé dans Epsylon puis relancez le test.
5. 5. Aligner les références (SKU)

   C'est le point qui décide de tout : la correspondance entre les deux catalogues se fait uniquement par SKU. La référence du produit WooCommerce doit être strictement identique à celle du produit Epsylon — majuscules, tirets et espaces compris.

   • SKU identique : le stock et le prix se synchronisent, et la commande crée une ligne rattachée au produit.
   • SKU différent ou absent : la commande arrive quand même, mais en ligne libre, au prix de la boutique et avec une TVA de 20 % par défaut, sans mouvement de stock.
   • Avant la première synchronisation, exportez vos deux catalogues et comparez les références. C'est une heure de travail qui évite des semaines d'écarts de stock.
6. 6. Activer les synchronisations

   Dans le même écran, activez la synchronisation des stocks, celle des prix si vous le souhaitez, et choisissez la fréquence. Un bouton permet aussi de lancer une synchronisation immédiate.

   • Le stock publié en ligne est le stock disponible : physique moins réservé. Une pièce réservée pour une réparation en cours disparaît donc de la boutique.
   • La synchronisation des prix pousse le prix TTC d'Epsylon vers le produit WooCommerce. Laissez-la désactivée si vous pratiquez des prix web différents.
   • La planification s'appuie sur wp-cron : sur une boutique à faible trafic, déclenchez-la par une tâche cron serveur pour qu'elle soit régulière.

Dépannage

« Connexion établie, mais la clé API n'a pas toutes les permissions »

La clé n'a que la lecture. Dans Epsylon, supprimez-la et recréez-en une depuis Paramètres → Intégrations → Clés API : les clés créées par cet écran reçoivent read, write:products, write:stock et write:orders.

Le test renvoie « Clé API invalide »

La clé ou le secret comporte un espace en trop, ou la clé a été révoquée. Recopiez les deux valeurs, ou générez une nouvelle clé — le secret n'étant affiché qu'à la création, il n'est pas récupérable ensuite.

Le test échoue sans réponse du serveur

L'adresse de l'instance est erronée, ou votre hébergeur WordPress bloque les requêtes sortantes. Vérifiez l'adresse dans un navigateur, puis demandez à votre hébergeur d'autoriser les appels HTTP sortants (wp_remote_request).

Le stock affiché en ligne est inférieur à celui d'Epsylon

C'est le comportement attendu : la boutique publie le stock disponible, donc déduction faite des quantités réservées par les commandes et les réparations en cours.

Une commande arrive sans lien avec le produit

Le SKU ne correspond pas. La ligne est alors créée en texte libre, au prix du site et à 20 % de TVA. Corrigez la référence des deux côtés, puis reprenez la ligne dans le document.

Les stocks ne se mettent pas à jour tout seuls

La planification WordPress ne s'exécute qu'à la visite d'une page. Sur une boutique peu fréquentée, remplacez-la par une tâche cron serveur appelant wp-cron.php à intervalle fixe.