Eldy: /* Informations */

2025-06-16T21:02:50Z

Informations

← Older revision		Revision as of 21:02, 16 June 2025
Line 13:		Line 13:
	\|modulename=Shopify Integration		\|modulename=Shopify Integration
	\|editor=Association P'tite Tête		\|editor=Association P'tite Tête
	\|web= shopifyintegration.ptitetete.com		\|web=https://shopifyintegration.ptitetete.com
	\|webbuy={{LinkToPluginDownloadDoliStore\|keyword=shopify}}		\|webbuy={{LinkToPluginDownloadDoliStore\|keyword=shopify}}
	\|status=stable		\|status=stable

Eldy: /* Informations */

2025-06-16T21:02:30Z

Informations

← Older revision		Revision as of 21:02, 16 June 2025
Line 12:		Line 12:
	{{TemplateModuleInfo		{{TemplateModuleInfo
	\|modulename=Shopify Integration		\|modulename=Shopify Integration
	\|editor=		\|editor=Association P'tite Tête
	\|web=		\|web= shopifyintegration.ptitetete.com
	\|webbuy={{LinkToPluginDownloadDoliStore\|keyword=shopify}}		\|webbuy={{LinkToPluginDownloadDoliStore\|keyword=shopify}}
	\|status=stable		\|status=stable
Line 20:		Line 20:
	\|note=		\|note=
	}}		}}


	=Module Shopify Integration=		=Module Shopify Integration=

Eldy at 21:01, 16 June 2025

2025-06-16T21:01:32Z

← Older revision		Revision as of 21:01, 16 June 2025
Line 1:		Line 1:
			<!-- BEGIN interlang links -->
			<!-- Do NOT edit this section
			Links below are automatically managed by PolyglotBot
			You can edit links on the English source page : Module_Google -->
			<!-- END interlang links -->

			[[Category:Modules complémentaires]]
			{{TemplateDocDev}}
			{{TemplateDocUtil}}

			=Informations=
			{{TemplateModuleInfo
			\|modulename=Shopify Integration
			\|editor=
			\|web=
			\|webbuy={{LinkToPluginDownloadDoliStore\|keyword=shopify}}
			\|status=stable
			\|prerequisites=
			\|minversion=
			\|note=
			}}


	=Module Shopify Integration=		=Module Shopify Integration=
	'''Synchronisation transparente entre votre système ERP Dolibarr et votre plateforme e-commerce Shopify'''		'''Synchronisation transparente entre votre système ERP Dolibarr et votre plateforme e-commerce Shopify'''

P'tite tête: Création page documentation module Shopify Integration

2025-06-06T09:13:53Z

Création page documentation module Shopify Integration

New page

=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)===

#Accéder à <nowiki>https://www.dolistore.com</nowiki>
#Rechercher "Shopify Integration"
#Télécharger le module <code>module_shopifyintegration-2.0.23.zip</code>
#Dans Dolibarr : '''Accueil → Configuration → Modules → Déployer un module externe'''
#Téléverser le fichier .zip
#Le module sera automatiquement déployé

===Méthode 2 : Installation manuelle===

#Télécharger le fichier depuis <nowiki>https://shopifyintegration.ptitetete.com</nowiki>
#Placer le fichier dans le répertoire <code>/custom</code> de Dolibarr
#Décompresser l'archive : <code>unzip module_shopifyintegration-2.0.23.zip</code>
#Vérifier que le répertoire <code>shopifyintegration</code> est dans <code>/custom</code>

===Activation===

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

==Configuration==

===Configuration Dolibarr===

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

===Configuration Shopify===

#'''Application privée''' : Créer une application privée dans votre compte Shopify
#'''Permissions API''' : Configurer les permissions pour l'accès aux produits, clients et commandes
#'''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 <code>clone</code> 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''' : <nowiki>https://shopifyintegration.ptitetete.com</nowiki>

===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 <code>htdocs/modulebuilder/template</code> :
<code>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</code>

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

*✅ Structure conforme au template officiel
*✅ Compatibilité avec le répertoire <code>/custom</code>
*✅ 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''' : <nowiki>https://shopifyintegration.ptitetete.com</nowiki>
*'''DoliStore''' : <nowiki>https://www.dolistore.com</nowiki> (rechercher "Shopify Integration")
*'''Wiki Dolibarr''' : <nowiki>https://wiki.dolibarr.org</nowiki>

===Support et communauté===

*'''Support technique''' : shopifyintegration@ptitetete.com
*'''Forum Dolibarr''' : <nowiki>https://www.dolibarr.org/forum</nowiki>
*'''Documentation Dolibarr''' : <nowiki>https://wiki.dolibarr.org</nowiki>

----'''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
[[Category:Modules complémentaires]]
[[Category:E-commerce]]
[[Category:Synchronisation]]
[[Category:Shopify]]
__FORCETOC__

Module Shopify Integration - Revision history

Eldy: /* Informations */

Eldy: /* Informations */

Eldy at 21:01, 16 June 2025

P'tite tête: Création page documentation module Shopify Integration