Prérequis, installation dans custom/, configuration, premier test et mise à jour. Commencez sur une copie de votre base.
Dolibarr 18 à 24 avec PHP 7.4 à 8.3 et l’extension cURL ; les modules Produits, Commandes et Tiers activés (Stocks pour l’inventaire, Variantes pour les combinaisons). Un Dolibarr joignable en HTTPS depuis internet, car Shopify appelle le webhook. Travaillez d’abord sur une copie de votre base et, si possible, une boutique de développement.
Shopify ne permet plus de créer une application personnalisée historique depuis l’admin de la boutique. Créez une application dans le Dev Dashboard Shopify avec les droits Admin API produits, commandes, inventaire, clients, fulfillments et emplacements, plus read_publications et write_publications pour publier sur la Boutique en ligne. Copiez son client ID et son client secret. Une application personnalisée créée auparavant continue de fonctionner avec son jeton shpat_.
Téléchargez l’archive depuis Dolistore et décompressez-la dans custom/shopifysync, ou déployez-la depuis Accueil → Configuration → Modules/Applications → Déployer un module externe. Activez Shopify Sync. Aucun paquet Composer ni SDK n’est nécessaire.
Dans la configuration du module, saisissez le domaine de la boutique, choisissez le mode d’authentification (jeton collé, ou client ID et secret), collez les identifiants et laissez la version d’API à 2026-01. Sélectionnez l’emplacement d’inventaire et l’entrepôt cible. Cliquez sur « Tester la connexion » : chaque contrôle doit être vert, et chaque anomalie dit quoi corriger.
N’activez que les flux utiles (commandes, produits, stock, clients, expéditions, remboursements), fixez la source de vérité produits, stock et prix, et décidez si une commande payée crée la facture et enregistre le règlement. Cliquez ensuite sur « Inscrire les webhooks Shopify ». L’assistant d’installation en six étapes peut faire tout cela, rattachement par SKU compris pour un catalogue existant.
Dans Accueil → Configuration → Travaux planifiés, activez les tâches de traitement de la file et de réconciliation. Sur Dolibarr 24, ajoutez $dolibarr_cron_allow_cli = 1 dans conf/conf.php, sinon les tâches en ligne de commande sont comptées en erreur.
Passez une commande de test dans Shopify : au passage suivant de la file, la commande doit apparaître dans Dolibarr avec ses lignes, et le tableau de bord doit afficher le job terminé. Modifiez un produit Dolibarr et vérifiez-le sur Shopify. Si votre catalogue existe déjà des deux côtés, utilisez « Rattacher les variantes par SKU » puis « Rattraper les commandes des N derniers jours » depuis le tableau de bord.
Sauvegardez la base et les documents, remplacez le répertoire custom/shopifysync par la nouvelle version, puis désactivez et réactivez le module pour enregistrer les nouvelles tables et les hooks ; les réglages sont conservés. Les nouveautés sont désactivées par défaut : une installation existante se comporte comme avant tant que vous ne les activez pas.
