Metadata-Version: 2.1
Name: odoo14-addon-connector-prestashop
Version: 14.0.2.0.3.dev7
Summary: PrestaShop-Odoo connector
Home-page: https://github.com/OCA/connector-prestashop
Author: Akretion,Camptocamp,AvanzOSC,Tecnativa,Mind And Go,Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: AGPL-3
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 14.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Requires-Python: >=3.6
Requires-Dist: bs4
Requires-Dist: freezegun
Requires-Dist: html2text
Requires-Dist: odoo14-addon-connector-ecommerce
Requires-Dist: odoo14-addon-onchange-helper
Requires-Dist: odoo14-addon-product-multi-category
Requires-Dist: odoo14-addon-product-multi-image
Requires-Dist: odoo (<14.1dev,>=14.0a)
Requires-Dist: prestapyt
Requires-Dist: vcrpy

.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
   :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
   :alt: License: AGPL-3

=========================
Odoo PrestaShop Connector
=========================

This module connects Odoo and PrestaShop.

PrestaShop (http://www.prestashop.com/) is a popular e-commerce platform
written in PHP/MySQL and published under the Open Software licence v3.0.

This module allows the synchronization of the following objects from PrestaShop
to Odoo:

* Websites
* Stores and languages
* Carriers
* Product categories
* Products
* Combinations of products
* Partner categories
* Customers

Once these objects are synchronised, it will allow the import of sales orders,
together with the related customers.

As an extra feature, you can also export the stock quantities back to
PrestaShop.

If you want to export from Odoo to PrestaShop changes made on the products,
product categories or product images, you need to install
*connector_prestashop_catalog_manager* module in this same repository.

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.

Installation
============

It doesn't require any plug-in in PrestaShop, but requires an extra Python
library in Odoo server side, called prestapyt:

https://github.com/prestapyt/prestapyt/

You can use pip install system to install it

`sudo pip install prestapyt`

Configuration
=============

To configure this module, you need to set several things in both PrestaShop
and Odoo:

Steps in PrestaShop
-------------------

#. Go to the control panel (usually at <url>/adminps).
#. Login into the system.
#. Go to *Advanced Parameters > Web service*
#. Add a new entry.
#. Generate a new API key that will be needed later.
#. Grant all the needed access according your security policy.

Steps in Odoo
-------------

#. Go to *Connectors > PrestaShop > Backends*.
#. Create a new record for registering a PrestaShop backend. You will bind
   this backend to an specific company and warehouse.
#. Define the main URL of the PrestaShop web, and the webservice key you
   got in PrestaShop.
#. Define other parameters like the discount and shipping products, or if the
   taxes are included in the price.
#. Click on "Synchronize Metadata" button. This will bring the basic shop
   information that you can find on *Websites* and *Stores* menus.
#. 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.
#. Go to *Accounting > Configuration > Taxes > Tax Groups*, and include
   for each of the tax definition imported from PrestaShop, the corresponding
   taxes in Odoo.
#. Activate the job runner, checking the connector documentation for setting
   the server correctly for using it in
   http://odoo-connector.com/guides/jobrunner.html
#. Alternatively, if you are not able to activate it, you can enable the
   scheduled job called "Enqueue Jobs".
#. Activate the scheduled jobs for importing the records you want:

  * PrestaShop - Export Stock Quantities
  * PrestaShop - Import Carriers
  * PrestaShop - Import Customers and Groups
  * PrestaShop - Import Products and Categories
  * PrestaShop - Import Sales Orders
  * PrestaShop - Import suppliers
  * PrestaShop - Payment methods

Usage
=====

To use this module, you need to:

#. Go to *Connectors > Queue > Jobs*, and check the correct enqueuing of
   the tasks.
#. Check on each menu the resulting imported records (Customers, Sales
   Orders...)

.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
   :alt: Try me on Runbot
   :target: https://runbot.odoo-community.org/runbot/108/9.0

Test dependencies
=================

Extra libs are required to run the tests:
* ``vcrpy``
* ``freezegun``

Known issues / Roadmap
======================

* Work with multiple warehouses.
* Tests.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues
<https://github.com/OCA/connector-prestashop/issues>`_. 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.

Credits
=======

Images
------

* `PrestaShop logo <http://seeklogo.com/prestashop-logo-178788.html>`_.
* `Odoo logo <https://www.odoo.com/es_ES/page/brand-assets>`_.
* `Cable <https://openclipart.org/detail/174134/cable-with-connector>`_.

Contributors
------------

* Sébastien Beau <sebastien.beau@akretion.com>
* Benoît Guillot <benoit.guillot@akretion.com>
* Alexis de Lattre <alexis.delattre@akretion.com>
* Guewen Baconnier <guewen.baconnier@camptocamp.com>
* Sergio Teruel <sergio.teruel@tecnativa.com>
* Mikel Arregi <mikelarregi@avanzosc.es>
* Pedro M. Baeza <pedro.baeza@tecnativa.com>
* Simone Orsi <simone.orsi@camptocamp.com>
* Florent THOMAS <florent.thomas@mind-and-go.com>
* Francisco Fernández <ffernandez@planetatic.com>
* Florian da Costa <florian.dacosta@akretion.com>
* Marc Poch <mpoch@planetatic.com>
* JesusVMayor <jesus@comunitea.com>
* Hai Lang <hailn@trobz.com>

Maintainer
----------

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

This module is maintained by the OCA.

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.

To contribute to this module, please visit https://odoo-community.org.


