Search 1.9 billion lines of Odoo code on GitHub
connector_prestashop
<a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg">
</a>
<a name="odoo-prestashop-connector"></a>
<h2>Odoo PrestaShop Connector</h2>
<p>This module connects Odoo and PrestaShop.</p>
<p>PrestaShop (<a class="reference external" href="http://www.prestashop.com/">http://www.prestashop.com/</a>) is a popular e-commerce platform
written in PHP/MySQL and published under the Open Software licence v3.0.</p>
<p>This module allows the synchronization of the following objects from PrestaShop
to Odoo:</p>
<ul class="simple">
<li>Websites</li>
<li>Stores and languages</li>
<li>Carriers</li>
<li>Product categories</li>
<li>Products</li>
<li>Combinations of products</li>
<li>Partner categories</li>
<li>Customers</li>
</ul>
<p>Once these objects are synchronised, it will allow the import of sales orders,
together with the related customers.</p>
<p>As an extra feature, you can also export the stock quantities back to
PrestaShop.</p>
<p>If you want to export from Odoo to PrestaShop changes made on the products,
product categories or product images, you need to install
<em>connector_prestashop_catalog_manager</em> module in this same repository.</p>
<p>This connector supports PrestaShop version up to 1.6.11. Maybe later versions
are also supported, but they haven't been tested. It uses the webservices of
PrestaShop.</p>
<a name="installation"></a>
<h3>Installation</h3>
<p>Installation requirements based on Odoo version 12.0.
It doesn't require any plug-in in PrestaShop, but requires an extra Python
library in Odoo server side, called prestapyt, download it from:</p>
<p><a class="reference external" href="https://github.com/prestapyt/prestapyt.git">https://github.com/prestapyt/prestapyt.git</a></p>
<p>Or you can use pip install system to install it</p>
<p>sudo pip3 install prestapyt</p>
<p>Requires "base_multi_image module", on version 12 it's available from:</p>
<p><a class="reference external" href="https://github.com/PESOL/server-tools/tree/12.0-mig-base_multi_image">https://github.com/PESOL/server-tools/tree/12.0-mig-base_multi_image</a></p>
<p>Finally install "vcr" python library :</p>
<p>apt-get install python3-vcr</p>
<a name="configuration"></a>
<h3>Configuration</h3>
<p>To configure this module, you need to set several things in both PrestaShop
and Odoo:</p>
<a name="steps-in-prestashop"></a>
<h4>Steps in PrestaShop</h4>
<ol class="arabic simple">
<li>Go to the control panel (usually at <url>/adminps).</li>
<li>Login into the system.</li>
<li>Go to <em>Advanced Parameters > Web service</em></li>
<li>Add a new entry.</li>
<li>Generate a new API key that will be needed later.</li>
<li>Grant all the needed access according your security policy.</li>
</ol>
<a name="steps-in-odoo"></a>
<h4>Steps in Odoo</h4>
<ol class="arabic simple">
<li>Go to <em>Connectors > PrestaShop > Backends</em>.</li>
<li>Create a new record for registering a PrestaShop backend. You will bind
this backend to an specific company and warehouse.</li>
<li>Define the main URL of the PrestaShop web, and the webservice key you
got in PrestaShop.</li>
<li>Define other parameters like the discount and shipping products, or if the
taxes are included in the price.</li>
<li>Click on "Synchronize Metadata" button. This will bring the basic shop
information that you can find on <em>Websites</em> and <em>Stores</em> menus.</li>
<li>Click on "Synchronize Base Data" button. This will import carriers,
languages, tax groups and the rest of base data that are needed for the
proper work.</li>
<li>Go to <em>Accounting > Configuration > Taxes > Tax Groups</em>, and include
for each of the tax definition imported from PrestaShop, the corresponding
taxes in Odoo.</li>
<li>Activate the job runner, checking the connector documentation for setting
the server correctly for using it in
<a class="reference external" href="http://odoo-connector.com/guides/jobrunner.html">http://odoo-connector.com/guides/jobrunner.html</a></li>
<li>Alternatively, if you are not able to activate it, you can enable the
scheduled job called "Enqueue Jobs".</li>
<li>Activate the scheduled jobs for importing the records you want:</li>
</ol>
<blockquote>
<ul class="simple">
<li>PrestaShop - Export Stock Quantities</li>
<li>PrestaShop - Import Carriers</li>
<li>PrestaShop - Import Customers and Groups</li>
<li>PrestaShop - Import Products and Categories</li>
<li>PrestaShop - Import Sales Orders</li>
<li>PrestaShop - Import suppliers</li>
<li>PrestaShop - Payment methods</li>
</ul>
</blockquote>
<a name="usage"></a>
<h3>Usage</h3>
<p>To use this module, you need to:</p>
<ol class="arabic simple">
<li>Go to <em>Connectors > Queue > Jobs</em>, and check the correct enqueuing of
the tasks.</li>
<li>Check on each menu the resulting imported records (Customers, Sales
Orders...)</li>
</ol>
<a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/108/9.0"><img alt="Try me on Runbot" src="https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas" /></a>
<a name="test-dependencies"></a>
<h3>Test dependencies</h3>
<p>Extra libs are required to run the tests:
* <code>vcrpy</code>
* <code>freezegun</code></p>
<a name="known-issues-roadmap"></a>
<h3>Known issues / Roadmap</h3>
<ul class="simple">
<li>Work with multiple warehouses.</li>
<li>Tests.</li>
</ul>
<a name="bug-tracker"></a>
<h3>Bug Tracker</h3>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/connector-prestashop/issues">GitHub Issues</a>. In case of trouble, please
check there if your issue has already been reported. If you spotted it first,
help us smashing it by providing a detailed and welcomed feedback.</p>
<a name="credits"></a>
<h3>Credits</h3>
<a name="images"></a>
<h4>Images</h4>
<ul class="simple">
<li><a class="reference external" href="http://seeklogo.com/prestashop-logo-178788.html">PrestaShop logo</a>.</li>
<li><a class="reference external" href="https://www.odoo.com/es_ES/page/brand-assets">Odoo logo</a>.</li>
<li><a class="reference external" href="https://openclipart.org/detail/174134/cable-with-connector">Cable</a>.</li>
</ul>
<a name="contributors"></a>
<h4>Contributors</h4>
<ul class="simple">
<li>Sébastien Beau <<a class="reference external" href="mailto:sebastien.beau@akretion.com">sebastien.beau@akretion.com</a>></li>
<li>Benoît Guillot <<a class="reference external" href="mailto:benoit.guillot@akretion.com">benoit.guillot@akretion.com</a>></li>
<li>Alexis de Lattre <<a class="reference external" href="mailto:alexis.delattre@akretion.com">alexis.delattre@akretion.com</a>></li>
<li>Guewen Baconnier <<a class="reference external" href="mailto:guewen.baconnier@camptocamp.com">guewen.baconnier@camptocamp.com</a>></li>
<li>Sergio Teruel <<a class="reference external" href="mailto:sergio.teruel@tecnativa.com">sergio.teruel@tecnativa.com</a>></li>
<li>Mikel Arregi <<a class="reference external" href="mailto:mikelarregi@avanzosc.es">mikelarregi@avanzosc.es</a>></li>
<li>Pedro M. Baeza <<a class="reference external" href="mailto:pedro.baeza@tecnativa.com">pedro.baeza@tecnativa.com</a>></li>
<li>Simone Orsi <<a class="reference external" href="mailto:simone.orsi@camptocamp.com">simone.orsi@camptocamp.com</a>></li>
<li>Florent THOMAS <<a class="reference external" href="mailto:florent.thomas@mind-and-go.com">florent.thomas@mind-and-go.com</a>></li>
<li>Francisco Fernández <<a class="reference external" href="mailto:ffernandez@planetatic.com">ffernandez@planetatic.com</a>></li>
<li>Michele Trevisan <<a class="reference external" href="mailto:michele.trevisan@didotech.com">michele.trevisan@didotech.com</a>></li>
</ul>
<a name="maintainer"></a>
<h4>Maintainer</h4>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>This module is maintained by the OCA.</p>
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.</p>
<p>To contribute to this module, please visit <a class="reference external" href="https://odoo-community.org">https://odoo-community.org</a>.</p>