Module ECommerce NG (Magento)

Retour index
Documentation développeur

Return to user
documentation index

<keywords content="Magento, Dolibarr, synchro, synch, interface" />

Informations

Module name	Magento
Editor / Editeur	Teclib - www.teclib.com
Download or buy page / Page achat ou téléchargement	External module - www.dolistore.com
Status / Statut / Estado	Development / Développement
Prerequisites / Prérequis	Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2016-04-8
Note / Nota

Features

Intègre une synchronisation Magento - Dolibarr. Il s'agit d'un module qui s'installe sur Dolibarr. L'accès à Magento est fait par Dolibarr en utilisant les Web services par défaut de Magento.

Installation

From the application

• Download the archive file of module (.zip file)
• Go on menu Home -> Setup -> Modules -> Deploy external module and submit the file.
• Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.

Manually

• Download the archive file of module (.zip file)
• Put the file into the root directory of Dolibarr.
• Uncompress the archive file, for example with command

unzip modulefile.zip

• Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.

Setup

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

Setup on Magento side

• Créer un compte Webservice SOAP/XML RPC depuis l'interface admin System - Webservices - SOAP/XML RPC, par exemple le compte soapuser.
• Mettre un mot de passe dans le champ API key.

Setup on Dolibarr side

Aller sur la page de configuration Dolibarr du module Magento.

• Saisir l'URL des services SOAP Magento.
• Renseigner le login et l'API key créé à l'étape précédente dans Magento (soapuser).
• Choisir la catégorie à utiliser pour marquer les tiers issus de Magento ou ceux à pousser sur Magento. Le tiers assigné à cette catégorie seront poussés en temps réel sur Magento.
• Choisir la catégorie mère dans laquelle sera créée les catégories produits issues de Magento. Les produits créés ou modifiés qui sont assignés à une catégorie ou sous-catégorie de cette dernière seront poussés sur Magento en temps réel.

Usage

Synchronize from Magento to Dolibarr

Synchronizing can be done manually from page Synchronizing Site ...:

Action into Magento	Effect into Dolibarr	When	Note
Categories created/modified into Magento	Created into Dolibarr as sub-categories of the parent category used for Mangeto categories (defined into module setup)	Manual click on "Magento to Dolibarr sync" button	Table llx_ecommerce_category is updated to store link of dolibarr id and remote magento id
Products created/modified into Magento	Created into Dolibarr with categories	Manual click on "Magento to Dolibarr sync" button	Table llx_ecommerce_product is mainained to keep link of dolibarr id and remote magento id
Thirdparties and contact/addresses created/modified into Magento	Created into Dolibarr	Manual click on "Magento to Dolibarr sync" button	Table llx_ecommerce_societe and llx_ecommerce_socpeople is mainained to keep link of dolibarr id and remote magento id
Orders created/modified into Magento	Created into Dolibarr	Manual click on "Magento to Dolibarr sync" button	Table llx_ecommerce_commande is mainained to keep link of dolibarr id and remote magento id
Create a shipment in Magento	Creating a shipment in Magento is changing status of Order from "pending" to "processing". Because it is changing status of order, see case of Order created/modified. The shipment is not downloaded into Dolibarr if entered on Magento		It is recommanded to manage shipments on ERP side
Invoices created/modified into Magento	Created into Dolibarr	Manual click on "Magento to Dolibarr sync" button	Table llx_ecommerce_facture is mainained to keep link of dolibarr id and remote magento id TODO

TODO In a future version, the "Magento to Dolibarr sync" button could be replaced with a scheduled job/script to launch it automaticaly every hour for example.

Synchronize from Dolibarr to Magento

Synchronizing is done in real time.

Action into Dolibarr	Effect into Magento	When	Note
Categories created/modified into Dolibarr	No update is currently done on Magento. In a future version, creation/update into Magento if category is inside the parent category for Magento, defined into module setup	Real time
Products created/modified into Dolibarr	No update is currently done on Magento. In a future version, creation/update into Magento will be done if product has a category inside parent category of Magento product (defined into setup too)	No update is currently done on Magento. In a future version, sync will be in real time
Thirdparties are created or modified into Dolibarr	No update is currently done on Magento. In a future version, creation/update into Magento will be done if thirdparty has the category of Magento thirdparties (defined into setup)	No update is currently done on Magento. In a future version, sync will be in real time
Contact/addresses are created or modified into Dolibarr	None		No update done on Magento
Orders created into Dolibarr	None		Orders created directly into backoffice does not need to appear into ecommerce. See next line for Orders update.
Orders updated into Dolibarr	Order will be updated into Magento if order was created by a "Magento to Dolibarr sync"	Real time	TODO
Shipments created into Dolibarr	Shipment will be created into Magento if source order of shipment was created by a "Magento to Dolibarr sync"	Real time	TODO
Invoice created/updated into Dolibarr	None. In a future, invoice will be created/updated into Magento if source order was coming from Magento	Real time	TODO
Stock of a product is modified (because of a shipment processed of an order or invoice validate, depending on Dolibarr setup for the stock change rule)	Stock is updated on Mangeto if same product is found	Real time	TODO

Development

Development of this module is not included into standard GIT repository of Dolibarr but inside a dedicated repository managed by TecLib.

• GIT Repository: https://github.com/TECLIB/dolibarr