Module ERPkit (synchro Shopify, WooCommerce, Cdiscount et plus) FR
Jump to navigation
Jump to search
| Éditeur | ERPkit (erpkit.app) |
|---|---|
| Identifiant du module | 193042 |
| Licence | Module : GPL v3 ou ultérieure. Service de synchronisation : payant par marketplace, avec une offre gratuite sans carte bancaire |
| Dolibarr | 17 ou plus récent |
| PHP | 7.4 ou plus récent |
| Où l'obtenir | DoliStore |
| Version | Voir le DoliStore |
| Documentation | app.erpkit.app/docs (en anglais) |
| Support | support@erpkit.app |
ERPkit synchronise Dolibarr avec Shopify, WooCommerce, PrestaShop, eBay, Cdiscount, Leroy Merlin, Bricoman (désormais Tecnomat), Castorama et Vente-unique : les prix et le stock partent de Dolibarr, les commandes y arrivent en commandes clients. Il se compose de deux parties :
- Ce module, gratuit, sous GPL v3 ou ultérieure : les attributs supplémentaires de chaque marketplace sur les produits, et une page de configuration pour leurs clés API, qui restent dans Dolibarr.
- Le service de synchronisation sur erpkit.app, payant par marketplace avec une offre gratuite (tarifs sur erpkit.app/fr/pricing).
Marketplaces
| Marketplace | Remarques |
|---|---|
| Shopify | Boutique en ligne |
| WooCommerce | Boutique en ligne (WordPress) |
| PrestaShop | Boutique en ligne, testé sur 1.7, 8 et 9 |
| eBay | 10 sites régionaux : États-Unis, Royaume-Uni, Allemagne, France, Italie, Espagne, Pays-Bas, Belgique, Autriche et Suisse. En accès anticipé : non testé à ce jour sur un compte eBay réel |
| Cdiscount | France |
| Leroy Merlin | France |
| Bricoman (désormais Tecnomat) | France |
| Castorama | France |
| Vente-unique | France, Tchéquie, Finlande, Hongrie et Slovaquie |
Ce qui est synchronisé
| Données | Sens | Remarques |
|---|---|---|
| Prix | Dolibarr vers la marketplace | Un champ de prix par marketplace sur le produit, et un prix barré |
| Stock | Dolibarr vers la marketplace | Physique ou virtuel, au choix pour chaque marketplace |
| Poids et code-barres | Dolibarr vers la marketplace | Si la marketplace les accepte |
| Dates de promotion, écotaxes françaises | Dolibarr vers la marketplace | Si la marketplace les accepte |
| Commandes | Marketplace vers Dolibarr | Commandes clients validées, avec leurs lignes, frais de port et remises ; seulement les statuts choisis ; jamais importées deux fois |
| Tiers | Marketplace vers Dolibarr | Rapproché d'un tiers existant par l'e-mail (ou par le compte client de la marketplace), sinon créé |
| Factures et Factur-X | Dans Dolibarr | Une facture créée à partir de chaque commande importée, validée et classée payée ; un PDF Factur-X joint aux factures validées ou payées |
| Expéditions et suivi | Dolibarr vers la marketplace | Une expédition validée avec un numéro de suivi marque la commande comme expédiée, avec son transporteur |
Réglages par marketplace :
- Règles de prix : une marge sur le prix Dolibarr, un prix barré via une remise, ou un CSV de prix.
- Statuts de commande : les statuts importés, avec les libellés de la marketplace.
- Règles d'expédition : une méthode d'expédition Dolibarr pour chaque commande importée, selon le pays, le montant ou le nombre d'articles, et selon le poids si la marketplace l'envoie.
- Transporteurs : les méthodes d'expédition Dolibarr associées aux transporteurs de la marketplace, pour que les liens de suivi fonctionnent.
Fonctionnement
- Où : sur erpkit.app, pas dans Dolibarr. Le service appelle l'API REST de Dolibarr avec la clé d'un utilisateur Dolibarr dédié, lit les clés des marketplaces enregistrées par ce module et ne les garde pas.
- Quand : toutes les 3 à 8 heures selon l'offre. Seuls les produits modifiés depuis le passage précédent sont envoyés.
- Pourquoi un service hébergé : les API des marketplaces changent souvent, et une correction côté serveur profite à toutes les installations le jour même, sans mise à jour du module.
- Données : aucune copie des produits, commandes ou clients, seulement une empreinte (hash) de chaque produit. La clé API de Dolibarr et les jetons eBay sont chiffrés. Hébergé à Francfort, en Allemagne.
Ce que le module ajoute à Dolibarr
- Une page de configuration : chaque marketplace s'ajoute depuis la liste « + Ajouter une marketplace », avec les champs qu'elle demande (une URL de boutique et des clés, une clé API ou un identifiant vendeur ; aucun pour eBay, qui se connecte depuis le compte ERPkit).
- Des attributs supplémentaires sur les produits pour chaque marketplace ajoutée : l'identifiant qui lie le produit à son annonce, un prix et un prix barré. Certaines marketplaces ajoutent les dates de début et de fin de promotion, et deux champs d'écotaxe partagés, « Éco-participation (FR) » et « Taxe DEEE / DEA (FR) ».
- Deux droits : lecture et écriture de la configuration de synchronisation (libellés en anglais dans Dolibarr).
- Un point d'accès REST,
/api/index.php/erpkit/config, par lequel le service lit les réglages des marketplaces.
Désactiver le module conserve les attributs des produits et leurs données. Retirer une marketplace aussi, sauf si la case qui supprime ses attributs est cochée.
Prérequis
- Le module Dolibarr « API / Web services (serveur REST) » activé.
- Un utilisateur Dolibarr dédié, avec une « Clé pour l'API » et les droits des phases utilisées (liste dans le guide du module, en anglais).
- Votre Dolibarr accessible depuis internet, pas seulement depuis le réseau du bureau : le service appelle son API REST.
- Un compte sur erpkit.app.
Installation
- Télécharger le zip du module sur le DoliStore.
- Dans Dolibarr, aller dans Accueil > Configuration > Modules/Applications, ouvrir l'onglet « Déployer/Installer un module externe » et envoyer le zip.
- Trouver ERPkit dans la liste des modules et l'activer.
- Cliquer sur l'icône d'engrenage à côté d'ERPkit et ajouter chaque marketplace utilisée.
Une mise à jour se déploie de la même façon. Les réglages et les données des produits sont conservés.
Configuration
Sur erpkit.app, chaque marketplace a sa propre synchronisation :
- Saisir l'URL de Dolibarr et la clé de l'utilisateur API.
- Lancer le test de connexion. Il signale aussi les droits manquants.
- Choisir les phases à lancer (produits et stock, commandes, factures, expéditions, Factur-X) et les réglages ci-dessus.
- Lier les produits à leurs annonces : le service propose les correspondances par référence (SKU), à accepter en un clic.
Documentation (en anglais) :
- Le module Dolibarr ERPkit
- Lier les produits
- Le fonctionnement de la synchronisation
- Un guide de configuration par marketplace, dans la documentation
Limites
- Les titres, descriptions, images et le SEO restent sur la marketplace : la synchronisation ne les modifie jamais.
- Pas de création d'annonces : les produits doivent déjà exister sur la marketplace.
- Les prix et le stock vont dans un seul sens, de Dolibarr vers la marketplace.
- Une commande importée n'est plus mise à jour : les remboursements et annulations faits ensuite sur la marketplace se traitent à la main dans Dolibarr.
Support
Par e-mail : support@erpkit.app.
Voir aussi
- Module DoliDropkit : le dropshipping entre deux Dolibarr, par le même éditeur