Installer Sync WooCommerce/PrestaShop, pas à pas

1Avant de commencer

Inklura Sync se compose de deux extensions qui communiquent directement : l'une s'installe dans WordPress (WooCommerce), l'autre dans PrestaShop. Aucune donnée de boutique ne transite par nos serveurs.

Lisez aussi les cas particuliers : logiciels de caisse, packs, multiboutique, écotaxe ou champs ACF complexes se vérifient avant l'installation.

2Récupérer la clé et les archives

Connectez-vous à votre espace client avec le compte utilisé lors de l'achat. Pour chaque licence active, vous y trouvez :

• la clé de licence au format WD29-XXXX-XXXX-XXXX-XXXX, avec un bouton « Copier la clé » ;
• deux archives : woocommerce-prestashop-bridge-0.8.12.zip pour WordPress et wd29woobridge-0.8.12.zip pour PrestaShop, chacune avec son empreinte SHA-256.

Les liens de téléchargement restent valables 15 minutes : rechargez la page pour en obtenir de nouveaux. N'ouvrez pas les archives et ne les renommez pas. Installez toujours la même version sur les deux boutiques.

Vérifier l'empreinte (recommandé)

Comparez l'intégralité de l'empreinte calculée sur votre poste avec celle affichée dans l'espace client :

Si les empreintes diffèrent, supprimez le fichier et téléchargez-le à nouveau. Les empreintes de chaque version sont aussi publiées sur la page Versions d'Inklura Sync.

3Installer côté WooCommerce

1. Dans l'administration WordPress, ouvrez Extensions›Ajouter une extension puis cliquez sur Téléverser une extension en haut de la page.
2. Choisissez woocommerce-prestashop-bridge-0.8.12.zip et cliquez sur Installer maintenant.

3. Une fois l'installation terminée, cliquez sur Activer l'extension. Elle apparaît dans la liste sous le nom WD29 WooCommerce PrestaShop Bridge, avec un lien Réglages. WooCommerce doit être actif, ainsi que l'extension PHP cURL ; sinon, l'activation s'arrête avec un message.
4. Ouvrez WooCommerce›PrestaShop Bridge. La page Inklura Sync s'ouvre sur Vue d'ensemble. En haut, le bandeau Vous êtes ici · cette administration désigne la boutique que vous consultez, et Boutique partenaire configurée affiche l'autre (vide tant que l'appairage n'est pas fait).

Le Webhook de cette boutique, à copier dans PrestaShop à l'étape 6, se trouve en haut de l'onglet Réglages. Il ressemble à https://votre-boutique-woo.fr/wp-json/wd29-bridge/v1/webhook.

4Installer côté PrestaShop

1. Dans le back-office PrestaShop, ouvrez Modules›Gestionnaire de modules puis cliquez sur Installer un module en haut à droite.
2. Glissez wd29woobridge-0.8.12.zip dans la fenêtre, ou cliquez sur « sélectionnez un fichier ».

3. PrestaShop affiche « Module installé ! » : cliquez sur Configurer. Plus tard, vous retrouverez le module sous le nom WD29 WooCommerce Bridge dans le Gestionnaire de modules.
4. La page Configurer affiche la même page Inklura Sync que dans WordPress, avec les mêmes onglets. Côté PrestaShop, le bandeau Vous êtes ici est à droite : WordPress reste toujours à gauche et PrestaShop à droite, sur les deux boutiques.

Le Webhook de cette boutique (onglet Réglages) dépend des URL simplifiées de PrestaShop : https://votre-boutique-prestashop.fr/fr/module/wd29woobridge/webhook lorsqu'elles sont activées (le segment de langue dépend de votre configuration), https://votre-boutique-prestashop.fr/index.php?fc=module&module=wd29woobridge&controller=webhook sinon. Copiez-le tel qu'affiché.

5Saisir la clé de licence

Ouvrez l'onglet Licence & mises à jour de chaque boutique (WooCommerce›PrestaShop Bridge et Modules›WD29 WooCommerce Bridge›Configurer). Faites la même chose des deux côtés :

1. Copiez la clé depuis votre espace client (bouton « Copier la clé »).
2. Collez-la dans le champ Clé de licence, puis cliquez sur Enregistrer la clé. Les espaces, tirets et minuscules sont acceptés.
3. L'extension active la boutique auprès de plugins.inklura.fr et affiche aussitôt l'état : Licence active, puis la clé (ses quatre derniers caractères seulement), la formule, les paires utilisées, l'échéance et la date de la dernière vérification.

Une fois la clé enregistrée, le bouton devient Remplacer la clé, à côté de Vérifier maintenant et Retirer la clé de cette boutique. La paire est décomptée quand les deux boutiques se sont déclarées : chacune transmet l'adresse de l'autre, ce qui les associe sur le serveur.

6Relier les deux boutiques en mode audit

Les deux extensions s'authentifient avec un secret partagé que vous choisissez : au moins 32 caractères, identique des deux côtés, différent de la clé de licence. Générez-le avec votre gestionnaire de mots de passe ou dans un terminal :

Ne le placez jamais dans une URL, un ticket, une capture ou un dépôt de code.

Dans WooCommerce

Ouvrez l'onglet Réglages :

1. Mode : Audit : réception sans écriture.
2. Webhook PrestaShop : collez le « Webhook de cette boutique » affiché par PrestaShop (étape 4).
3. Modifications simultanées du catalogue : laissez Mettre en pause pour examen pour commencer (un produit modifié des deux côtés attend votre arbitrage), ou donnez la priorité à WooCommerce ou à PrestaShop. Choisissez la même règle des deux côtés.
4. Secret partagé : collez le secret.
5. Laissez les deux cases facultatives décochées pour l'instant, puis cliquez sur Enregistrer les réglages.

Dans PrestaShop

Mêmes réglages dans l'onglet Réglages du module : mode audit, Webhook WooCommerce (le « Webhook de cette boutique » affiché par WordPress), même règle de conflit, même secret. Les trois champs de fiscalité sont décrits à l'étape suivante. Cliquez sur Enregistrer les réglages.

Sous les réglages, les sections Champs personnalisés et Statuts des commandes (côté WordPress) se règlent plus tard, si besoin.

7Vérifier la fiscalité

Le connecteur ne devine jamais un taux de TVA. Avant la première synchronisation :

• WooCommerce : vérifiez que les taxes sont activées et configurées (WooCommerce›Réglages›TVA). Vos prix peuvent rester saisis TTC.
• PrestaShop, correspondance des taux : le champ Taux de TVA → identifiant du groupe de règles de taxes, en JSON associe chaque taux à un groupe de règles de taxes PrestaShop. Exemple pour la TVA française : {"20":1,"10":2,"5.5":3}. Les identifiants se lisent dans International›Taxes›Règles de taxes, colonne ID.
• PrestaShop, prix sans information fiscale : Taux de TVA des prix reçus sans information fiscale (%) et Ces prix sont saisis (TTC ou HT) ne servent que si un produit arrive sans taux exploitable. Laissez le taux vide tant que vous n'êtes pas sûr : la fiche sera signalée plutôt que mal calculée.

8Tester la connexion

Dans WooCommerce, ouvrez l'onglet Activité : la première section, Actions & maintenance, commence par le bouton Tester la connexion. L'extension appelle PrestaShop avec une requête signée et affiche sa réponse en haut de la page. Faites de même côté PrestaShop.

Une réponse contenant "ok":true confirme que l'adresse, le certificat et le secret sont bons ; elle indique aussi le mode et l'état du worker de l'autre boutique. En cas d'erreur, le message s'affiche à la place :

9Première synchronisation

Il reste à faire connaître à chaque boutique l'existant de l'autre. Chaque fiche garde son identité d'origine (par exemple woo:product:1001) : les UGS vides et les e-mails ne servent jamais à fusionner deux fiches. Deux méthodes, que vous pouvez combiner.

Captures par lots, en mode audit

Les captures envoient les fiches existantes à l'autre boutique comme des modifications ordinaires : en audit, elles sont reçues sans être appliquées, puis appliquées au passage en live. Lancez-les depuis WooCommerce, qui déclenche aussi la capture côté PrestaShop.

1. Dans Activité›Actions & maintenance, avec Offset du lot à 0, cliquez sur Catalogues : WordPress ↔ PrestaShop. Le message indique « Lot capturé : X sur WordPress, Y sur PrestaShop. Offset suivant : 10 ».
2. Saisissez cet offset (10, 20, 30…) et recommencez jusqu'à obtenir 0 des deux côtés.
3. Même méthode avec Contacts : WordPress ↔ PrestaShop, puis Commandes : WordPress ↔ PrestaShop si vous voulez l'historique des commandes.
4. Cliquez sur Traiter les échanges de WordPress (et, côté PrestaShop, Traiter les échanges de PrestaShop) pour envoyer tout de suite ce qui attend, sans attendre le worker.

Pour un gros catalogue, vous pouvez aussi laisser faire le worker (étape suivante) : à chaque passage, il capture 10 fiches de chaque type et reprend là où il s'était arrêté.

Contrôlez ensuite l'onglet Rapports des deux boutiques : catalogue suivi (un stock inconnu reste « inconnu », jamais zéro), commandes et lignes sans lien, contacts reçus. Chaque tableau se filtre entre les originaux créés sur cette boutique et les copies provenant de l'autre. Côté WordPress, les statuts de commande PrestaShop inconnus sont créés avec leur libellé d'origine ; associez-les si besoin à un statut WooCommerce dans Réglages›Statuts des commandes.

Comparer les écarts et synchroniser à la demande

Seconde méthode, directe : l’onglet Comparer & synchroniser lit les deux boutiques et écrit uniquement ce que vous demandez, même lorsque la synchronisation automatique est arrêtée ou en audit. Le mode reste inchangé. La boutique de destination doit avoir une licence qui autorise les écritures.

1. Choisissez les Fiches (Produits, variantes et métadonnées, Commandes ou Contacts clients) et le sens dans Source → destination, par exemple WordPress / WooCommerce → PrestaShop.
2. Cliquez sur Comparer / actualiser. La comparaison ne modifie rien. Elle affiche les originaux par lots de 20 (Suivant pour la suite), avec le décompte à créer, à mettre à jour, identiques et à examiner. Chaque ligne montre la fiche WordPress à gauche, la fiche PrestaShop à droite, les mentions Original et Copie et les différences. Cochez Afficher uniquement les écarts pour masquer les fiches identiques.
3. Pour une seule fiche, cliquez sur Créer sur ou Mettre à jour sur, suivi du nom de la boutique de destination. C’est ainsi qu’on rattrape une commande passée pendant un arrêt de la synchronisation : choisissez Commandes et le sens de la boutique où elle a été passée.
4. Pour un ensemble, Synchroniser toute cette famille traite la famille choisie ; Synchronisation complète traite les produits, puis les contacts, puis les commandes, toujours dans le sens sélectionné. Gardez la page ouverte pour suivre la progression. Arrêter après la fiche en cours conserve ce qui est fait, et relancer ignore les fiches déjà synchronisées. En cas d’erreur, utilisez Copier le journal, puis actualisez la comparaison.

Une fiche modifiée localement ou en conflit est signalée « à examiner » et n’est jamais écrasée. Si une fiche change après la comparaison, l’action est refusée : actualisez avant de réessayer.

Une comparaison n’est pas un inventaire forcé

Les variantes, images et champs autorisés suivent leurs produits. Les stocks des produits existants continuent à suivre leurs mouvements : « Quantités différentes » renvoie aux événements de stock dans Activité. Les contacts restent dans le répertoire de l’extension, sauf si les comptes clients natifs sont activés, et les contacts invités ne sont pas des comptes clients : leurs totaux peuvent différer entre plateformes.

Depuis une fiche produit, commande ou client

Chaque fiche native affiche aussi un panneau Inklura Sync : dans la colonne latérale des produits et des commandes WooCommerce, en bas du profil d'un client WordPress, dans l'onglet Modules de la fiche produit PrestaShop, en bas des pages commande et client de PrestaShop.

• La comparaison se lance à l'affichage du panneau et ne lit que les données enregistrées : sens de la synchronisation, original ou copie importée, résumé de chaque côté, écarts, déclinaisons concernées, événements en attente et dernier événement. Actualiser (WordPress) ou Comparer avec WooCommerce (PrestaShop) la relance.
• Sur un produit, Voir sur PrestaShop ou Voir sur WooCommerce ouvre la fiche publique correspondante. Ouvrir l'administration PrestaShop (ou WooCommerce) ouvre la fiche liée dans l'autre administration, après connexion et avec vos droits habituels : aucune session ni aucun mot de passe n'est transmis.
• Lorsqu'un écart peut être résolu, un bouton de synchronisation nommant le sens apparaît (par exemple Envoyer vers PrestaShop). Il demande une confirmation, vérifie à nouveau les deux fiches et n'applique que cette fiche, sans changer le mode automatique. Une modification intervenue entre-temps, un conflit local, une licence insuffisante ou un retrait de déclinaison à vérifier bloquent l'écriture.

10Planifier la tâche cron (worker)

La synchronisation avance grâce à un worker à lancer chaque minute sur le serveur de chaque boutique, sous le compte système habituel du site. Sans lui, les modifications sont bien enregistrées dans la file, mais rien ne part tant que personne ne clique sur Traiter les échanges. WP-Cron ne suffit pas, car il dépend des visites.

Testez d'abord la commande à la main (adaptez les chemins) :

Puis ajoutez la ligne correspondante à la crontab du compte du site (crontab -e), une seule par serveur, après avoir créé un dossier de journaux privé :

Aucun secret n'apparaît dans ces commandes : le worker lit les réglages enregistrés dans la boutique. Un verrou empêche deux passages simultanés. Chez un hébergeur mutualisé sans SSH, utilisez son interface « tâches cron » avec la même commande. Le worker vérifie aussi la licence une fois par jour (étape 12).

Surveiller

La même commande avec --command=health fait un contrôle en lecture seule, sans données clients. Code de sortie 0 : tout va bien ; 2 : un point à examiner, ou synchronisation arrêtée ; 1 : le worker ne démarre pas ; 64 : arguments incorrects. Branchez ce code sur la supervision de votre hébergement : l'extension n'envoie aucune alerte elle-même.

11Vérifications, puis mode live

Dans Vue d'ensemble, les indicateurs État du suivi, En attente et À résoudre et la section Diagnostics résument ce qui reste à examiner. Avant de passer en live, réalisez ces vérifications sur un produit et un moyen de paiement de test :

1. Une commande WooCommerce : un seul miroir dans PrestaShop, même total TTC et même taxe, stock déduit une seule fois.
2. Une commande PrestaShop (ou une vente en caisse) : un seul miroir dans WooCommerce, statut correct, stock déduit une seule fois.
3. Une annulation ou un retour sur la boutique d'origine : statut et registre de remboursement recopiés, stock restauré une seule fois.
4. Arrêt du worker d'une boutique pendant quelques minutes, modification, puis redémarrage : les deux boutiques convergent et les diagnostics repassent au vert.
5. Un même produit modifié des deux côtés : la règle de conflit choisie s'applique.

Quand tout est conforme, passez le Mode à Synchronisation live sur les deux boutiques (onglet Réglages), puis enregistrez. Le badge en haut de la page indique alors « Synchronisation active ». Les événements reçus pendant l'audit sont appliqués aux passages suivants du worker.

12Contrôle de licence

Une licence couvre une ou plusieurs paires : une boutique WooCommerce et une boutique PrestaShop (Essentiel et Pro : 1 paire, Agence : le nombre prévu au devis). Les hôtes de développement (localhost, 127.0.0.1, *.test, *.local, *.localhost, *.example) ne sont jamais décomptés.

La licence ne décide que d'une chose : si une boutique réglée en mode live peut appliquer les événements reçus. Sinon, elle continue en mode audit : tout est reçu et conservé, rien n'est supprimé, et le mode live reprend seul dès que la licence redevient valable. Le badge affiche alors « Mode audit · licence ».

Vérification quotidienne

• Chaque boutique vérifie sa licence une fois par jour, depuis le worker (étape 10), jamais pendant la visite d'un client. La requête est limitée à 8 secondes.
• Chaque réponse est signée (Ed25519) et vérifiée par l'extension : elle doit concerner cette boutique, cette clé, et être récente.
• Serveur injoignable ou réponse non vérifiable : rien ne change. L'extension réessaie plus tard (d'une à six heures), note « Dernier essai » dans l'onglet Licence et le signale dans les diagnostics après trois jours sans réponse.
• Le bouton Vérifier maintenant force une vérification, par exemple juste après un renouvellement.

Quand une action est nécessaire, l'onglet Licence & mises à jour l'indique (« Le mode live est configuré mais suspendu par la licence : cette boutique fonctionne en mode audit ») et un bandeau « Inklura Sync : » suivi de l'état apparaît sur toutes les pages d'administration de WordPress et du back-office PrestaShop, avec un lien vers la licence. Il disparaît dès que la licence est de nouveau valable.

Changer de boutique

Sur l'ancienne boutique, cliquez sur Retirer la clé de cette boutique et confirmez : la paire est libérée sur le serveur. Si l'ancienne boutique n'est plus accessible, utilisez « Libérer » sur la paire dans votre espace client. Saisissez ensuite la clé sur la nouvelle boutique.

13Mettre à jour

Avec une licence active, les deux extensions se mettent à jour depuis leur propre administration. Chaque archive est téléchargée avec votre clé et son empreinte SHA-256 est contrôlée avant installation. Réglages, correspondances et historique sont conservés.

• WordPress : la nouvelle version apparaît dans Extensions et dans Tableau de bord›Mises à jour, comme pour toute extension, et l'onglet Licence & mises à jour affiche « Version X disponible » avec un lien vers Extensions. Cliquez sur Mettre à jour. WordPress cherche les nouveautés deux fois par jour.
• PrestaShop : l'onglet Licence & mises à jour affiche « Version X disponible », la version installée et un bouton Mettre à jour le module. Les fichiers du module sont remplacés un à un, après contrôle complet de l'archive.

Gardez la même version des deux côtés : mettez à jour les deux boutiques l'une après l'autre, puis contrôlez la vue d'ensemble. Les comparaisons et les panneaux des fiches natives supposent que les deux extensions sont à jour. Sans licence active, ou sans accès sortant vers plugins.inklura.fr, téléchargez les archives depuis l'espace client et installez-les comme aux étapes 3 et 4 (WordPress propose alors Remplacer l'extension actuelle par celle que vous avez téléversée).

Le détail de chaque version et les empreintes des archives sont sur la page Versions d'Inklura Sync.

14Dépannage

Messages à l'enregistrement

Les messages du test de connexion sont détaillés à l'étape 8.

Diagnostics

Les codes ci-dessous apparaissent dans la section Diagnostics de la Vue d'ensemble et de l'onglet Activité, avec la fiche ou le sens concerné et l'action à mener, ainsi que dans la sortie de --command=health.

Autres situations

• Rien ne bouge : le mode est-il audit (réception sans application) ? Le worker tourne-t-il des deux côtés ? L'indicateur En attente de la vue d'ensemble doit baisser à chaque minute. Le journal des échanges (Activité) indique l'état et l'erreur de chaque envoi.
• « Comparaison indisponible » dans Comparer & synchroniser : vérifiez la connexion (étape 8) et que les deux extensions ont la même version.
• Un stock affiché inconnu : normal pour un produit dont la boutique source ne suit pas le stock. L'action Mettre à zéro les quantités inconnues des déclinaisons Woo ne s'utilise qu'en connaissance de cause.
• Quantités différentes signalées dans une comparaison : les stocks suivent leurs mouvements, pas la comparaison. Consultez les événements de stock dans Activité.

Pour nous écrire, indiquez les versions de WordPress, WooCommerce, PrestaShop et de l'extension, ainsi que le code de diagnostic. Masquez les données personnelles dans les captures et journaux.

15Désinstaller

Passez d'abord le mode à Arrêtée des deux côtés et retirez les lignes de la crontab. La désactivation, comme la désinstallation du module PrestaShop, conserve les correspondances et l'historique de déduplication, pour pouvoir reprendre sans doublon. Ne réutilisez pas ces données pour relier une autre paire de boutiques.

Les produits, commandes et clients créés dans chaque boutique restent en place : ce sont des fiches natives. Pensez à retirer la clé de licence avant de désinstaller pour libérer la paire.