Module Shopify Integration

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Retour index
Documentation développeur

File Doc dev.png

Retour index
Documentation Utilisateur
File Doc user.png

Informations

Module name Shopify Integration
Editor / Editeur Association P'tite Tête - https://shopifyintegration.ptitetete.com
Download or buy page / Page achat ou téléchargement External module - www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis

Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2025-06-16
Note / Nota

Module Shopify Integration

Synchronisation transparente entre votre système ERP Dolibarr et votre plateforme e-commerce Shopify

Le module Shopify Integration permet d'intégrer votre système ERP Dolibarr avec votre boutique Shopify pour synchroniser les produits, gérer les stocks et importer les commandes automatiquement. Une solution complète pour gérer vos workflows e-commerce de manière fluide et automatisée.

Fonctionnalités principales

Synchronisation des produits

  • Importation sélective : Synchronisation uniquement des produits simples (ni parents ni enfants) depuis Dolibarr vers Shopify
  • Gestion des variantes : Support complet des produits parents et de leurs variantes
  • Mise à jour bidirectionnelle : Synchronisation des informations produit (descriptions, prix, stock, catégories) entre les deux plateformes
  • Gestion des catégories : Utilisation d'une requête SQL récursive pour gérer les hiérarchies complexes de catégories

Synchronisation des commandes

  • Import automatique : Importation automatique des commandes Shopify dans Dolibarr
  • Gestion du stock en temps réel : Mise à jour automatique des niveaux de stock dans Dolibarr
  • Facturation automatisée : Génération automatique de factures dans Dolibarr

Synchronisation des clients

  • Importation/mise à jour : Synchronisation des informations clients depuis Shopify vers Dolibarr
  • Unification CRM : Centralisation des données CRM pour une gestion simplifiée

Sécurité et performances

  • Protection des données sensibles : Masquage des clés API dans les logs (affichage uniquement des 4 derniers caractères)
  • Optimisation SQL : Requêtes optimisées pour une meilleure performance
  • Gestion d'erreurs robuste : Mécanismes de récupération et de gestion d'erreurs avancés

Versions et langues supportées

  • Version actuelle : 2.0.23
  • Langues disponibles : Anglais, Français, Allemand, Espagnol, Italien
  • Compatibilité : Dolibarr 13+ et Shopify API Admin v2025-01

Installation

Prérequis de validation

Important : Avant d'utiliser ce module, assurez-vous qu'il peut être déployé via la fonctionnalité "Déployer un module externe" de Dolibarr (disponible dans le menu Accueil → Configuration → Modules). Cette validation est obligatoire pour tous les modules DoliStore.

Méthode 1 : Via DoliStore (Recommandée)

  1. Accéder à https://www.dolistore.com
  2. Rechercher "Shopify Integration"
  3. Télécharger le module module_shopifyintegration-2.0.23.zip
  4. Dans Dolibarr : Accueil → Configuration → Modules → Déployer un module externe
  5. Téléverser le fichier .zip
  6. Le module sera automatiquement déployé

Méthode 2 : Installation manuelle

  1. Télécharger le fichier depuis https://shopifyintegration.ptitetete.com
  2. Placer le fichier dans le répertoire /custom de Dolibarr
  3. Décompresser l'archive : unzip module_shopifyintegration-2.0.23.zip
  4. Vérifier que le répertoire shopifyintegration est dans /custom

Activation

  1. Aller dans Accueil → Configuration → Modules
  2. Localiser "Shopify Integration" dans l'onglet approprié
  3. Cliquer sur "Activer"
  4. Cliquer sur l'icône de configuration (⚙️) pour accéder aux paramètres

Configuration

Configuration Dolibarr

  1. API REST : Activer l'API REST de Dolibarr
  2. Clé API : Créer une clé API pour un utilisateur administrateur
  3. Catégories : Configurer les catégories de produits à synchroniser avec Shopify

Configuration Shopify

  1. Application privée : Créer une application privée dans votre compte Shopify
  2. Permissions API : Configurer les permissions pour l'accès aux produits, clients et commandes
  3. Clés d'accès : Récupérer l'Access Token et l'API Key

Paramètres du module

  • URL de la boutique Shopify : Saisir l'URL de votre boutique
  • Authentification : Configurer les clés d'accès Shopify
  • Catégories de synchronisation : Sélectionner les catégories de produits à synchroniser
  • Fréquence de synchronisation : Configurer les tâches CRON pour la synchronisation automatique

Utilisation

Synchronisation des produits

Les produits sont synchronisés de Dolibarr vers Shopify selon les règles suivantes :

  • Seuls les produits assignés aux catégories configurées sont synchronisés
  • Les produits parents et leurs variantes sont gérés automatiquement
  • Les images, descriptions et prix sont synchronisés en temps réel

Gestion des commandes

  • Les commandes Shopify sont automatiquement importées dans Dolibarr
  • Les clients sont créés ou mis à jour automatiquement
  • Les niveaux de stock sont ajustés en temps réel
  • Les factures peuvent être générées automatiquement

Traitement par lots

Le module supporte le traitement par lots pour une synchronisation efficace de grandes quantités de données.

Améliorations récentes (Version 2.0.8+)

Corrections SQL critiques

  • Suppression du LEFT JOIN incorrect : Élimination des inclusions erronées de produits enfants et parents
  • Conditions NOT EXISTS : Ajout de deux conditions pour exclure précisément les produits ayant des enfants et les produits enfants
  • Optimisation des performances : Simplification et optimisation de la logique SQL

Améliorations de sécurité

  • Protection des objets de configuration : Utilisation de la méthode clone pour éviter les modifications involontaires
  • Masquage sécurisé des clés API : Amélioration de la protection des données sensibles dans les logs

Support et documentation

Documentation incluse

Une documentation complète est fournie avec le module, incluant :

  • Guide d'installation pas à pas
  • Configuration détaillée de Shopify et Dolibarr
  • Exemples de cas d'utilisation
  • Résolution des problèmes courants

Support premium

  • Support inclus : 1 an de support premium avec votre achat
  • Contact : shopifyintegration@ptitetete.com
  • Site web : https://shopifyintegration.ptitetete.com

Développement et maintenance

  • Éditeur : Association P'tite Tête
  • Développeur principal : Cédric Petitcuenot
  • Statut : Module activement maintenu et mis à jour

Prérequis techniques

  • Dolibarr : Version 13.0 ou supérieure
  • PHP : Version 7.4 ou supérieure
  • Base de données : MySQL 5.7+ ou MariaDB 10.2+
  • Shopify : Boutique avec accès aux API Admin
  • Serveur web : Apache ou Nginx avec mod_rewrite

Tarification

Module disponible en licence commerciale avec :

  • Support technique inclus (1 an)
  • Mises à jour gratuites
  • Documentation complète
  • Installation et configuration assistées

Pour plus d'informations sur les tarifs, contactez : shopifyintegration@ptitetete.com

Informations techniques

Structure du module

Le module respecte la structure standard Dolibarr définie dans htdocs/modulebuilder/template : 

shopifyintegration/
├── README.txt                              # Introduction du module
├── core/
│   ├── modules/
│   │   └── modShopifyintegration.class.php # Descripteur du module
│   └── triggers/                           # Déclencheurs automatiques
├── lang/                                   # Fichiers de traduction (en, fr, de, es, it)
├── sql/                                    # Scripts de création de tables
├── docs/                                   # Documentation complète
└── img/                                    # Icônes et images du module

Conformité DoliStore

Ce module respecte toutes les règles de validation DoliStore :

  • ✅ Structure conforme au template officiel
  • ✅ Compatibilité avec le répertoire /custom
  • ✅ Aucune modification des fichiers core Dolibarr
  • ✅ Respect des normes de développement Dolibarr
  • ✅ Test de déploiement via l'interface standard validé

Licences et conditions

  • Licence : Compatible GPL v3 (conformément aux exigences Dolibarr)
  • Code source : Fourni avec le module pour personnalisations
  • Support commercial : 1 an inclus avec l'achat

Liens et ressources

Sites officiels

  • Site du module : https://shopifyintegration.ptitetete.com
  • DoliStore : https://www.dolistore.com (rechercher "Shopify Integration")
  • Wiki Dolibarr : https://wiki.dolibarr.org

Support et communauté

  • Support technique : shopifyintegration@ptitetete.com
  • Forum Dolibarr : https://www.dolibarr.org/forum
  • Documentation Dolibarr : https://wiki.dolibarr.org

Développé par : Association P'tite Tête - Cédric Petitcuenot

Dernière mise à jour de cette page : Juin 2025

Version documentée : 2.0.23

Mots-clés : Shopify, e-commerce, synchronisation, ERP, CRM, produits, commandes, clients, stock

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_Shopify_Integration&oldid=63505"