Installation Guide


The installation steps assume that you already have a functioning Odoo server.

If you are a developer, you may want to install the Connector using our buildout configuration, head over Connector with batteries included (buildout).

For the manual installation, just stay there.

Requirements on both servers

The ntp package should be install on the servers hosting Magento and Odoo to ensure a correct synchronization between them


Clone the repositories below in the path where you chosed to store the addons:

$ git clone -b 8.0
$ git clone -b 8.0
$ git clone -b 8.0
$ git clone -b 8.0
$ git clone -b 8.0
$ git clone -b 8.0


Keep the git branches entire. Do not copy-paste the modules in another directory.

Add the branches in the addons path, either using the server command line or adding them in the Odoo server configuration file.

Example using the command line argument:

$ /path/to/openerp-server --addons-path /path/to/connector,/path/to/connector-ecommerce,/path/to/connector-magento,/path/to/e-commerce,/path/to/product-attribute,/path/to/sale-workflow

You also need to install the magento Python package. So install it with either pip or either easy_install:

$ pip install magento

$ easy_install magento

Note that you may need to use the root rights on your system.

In Odoo, update the modules list using Settings > Modules > Update Modules List.

Go to the menu Settings > Modules > Installed Modules, remove the Installed filter and search for Magento Connector, then click on Install.


For the time being, the Magento extension originally built by OpenLabs is still used by the connector. But the version published on Magento Connect is outdated.

Download the following Bazaar branch and install it in Magento:

$ bzr branch lp:magentoerpconnect/magento-module-oerp6.x-stable magento-module

In order to install it:

  1. Move the Openlabs folder in the magento_root/app/code/community.
  2. Move the file app/etc/modules/Openlabs_OpenERPConnector.xml in magento_root/app/etc/modules.
  3. Flush the Magento cache from the admin panel or by removing everything in magento_root/var/cache


This notice does not apply if you use a version of Magento above 1.7. Please check if you have installed Magento 1.7 on PHP with a 5.4.x version. Magento 1.7 is not compatible with this version and would prevent the API to behave normally. In that case, you must retrograde to PHP 5.3.x or apply the patch provided by Magento (see

Configuring the Magento web-services

  1. In the Magento admin panel, go to System > Web-Services > SOAP/XML-RPC - Roles.
  2. Create a new role named openerp with access to All resources.
  3. In System > Web-Services > SOAP/XML-RPC - Users, create a new user named as you want, for instance openerp_connect, and an API key. In User Role, choose the openerp role.

After the installation

Once the addon is installed, you may want to:

  1. Read or read again Key questions when connecting Odoo with Magento
  2. Assign the Connector Manager group on your user.
  3. Create the Backend in Connectors > Magento > Backend, use the role created in Configuring the Magento web-services.
  4. Synchronize the initial metadata using the button Synchronize Metadata on the backend.
  5. Configure the translations if you use them: How to configure translations
  6. Configure: How to configure emails
  7. Configure: Howto: configure payment methods
  8. Configure: Howto: configure automatic workflows
  9. Configure: How to configure shipping methods
  10. Configure: How to configure warehouses
  11. Configure: How to configure pricing

On the backend,

  1. Import the customer groups
  2. Optionally, import the partners, otherwise they will be imported on the fly with the sales orders
  3. Import the product categories
  4. Configure the default values (accounting, …) of the new categories, using the Check the connector checkpoint
  5. Import the products
  6. Configure the new products (accounting, suppliers, stock rules, …) of the new products, using the Check the connector checkpoint
  7. Create an inventory for your products
  8. Update the stock quantities on Magento
  9. Import the sales orders
  10. Once you are all done and happy, configure the schedulers: How to configure schedulers