|
| 1 | +========================= |
| 2 | +PrestaShop-Odoo connector |
| 3 | +========================= |
| 4 | + |
| 5 | +.. |
| 6 | + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 7 | + !! This file is generated by oca-gen-addon-readme !! |
| 8 | + !! changes will be overwritten. !! |
| 9 | + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 10 | + !! source digest: sha256:d55da052f17578b24462cb1021eff586a11e452868fad86cfeb82fb891b692b4 |
| 11 | + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 12 | +
|
| 13 | +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png |
| 14 | + :target: https://odoo-community.org/page/development-status |
| 15 | + :alt: Beta |
| 16 | +.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png |
| 17 | + :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html |
| 18 | + :alt: License: AGPL-3 |
| 19 | +.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fconnector--prestashop-lightgray.png?logo=github |
| 20 | + :target: https://github.com/OCA/connector-prestashop/tree/15.0/connector_prestashop |
| 21 | + :alt: OCA/connector-prestashop |
| 22 | +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png |
| 23 | + :target: https://translation.odoo-community.org/projects/connector-prestashop-15-0/connector-prestashop-15-0-connector_prestashop |
| 24 | + :alt: Translate me on Weblate |
| 25 | +.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png |
| 26 | + :target: https://runboat.odoo-community.org/builds?repo=OCA/connector-prestashop&target_branch=15.0 |
| 27 | + :alt: Try me on Runboat |
| 28 | + |
| 29 | +|badge1| |badge2| |badge3| |badge4| |badge5| |
| 30 | + |
| 31 | +This module connects Odoo and PrestaShop. |
| 32 | + |
| 33 | +PrestaShop (http://www.prestashop.com/) is a popular e-commerce platform |
| 34 | +written in PHP/MySQL and published under the Open Software licence v3.0. |
| 35 | + |
| 36 | +This module allows the synchronization of the following objects from PrestaShop |
| 37 | +to Odoo: |
| 38 | + |
| 39 | +* Websites |
| 40 | +* Stores and languages |
| 41 | +* Carriers |
| 42 | +* Product categories |
| 43 | +* Products |
| 44 | +* Combinations of products |
| 45 | +* Partner categories |
| 46 | +* Customers |
| 47 | + |
| 48 | +Once these objects are synchronised, it will allow the import of sales orders, |
| 49 | +together with the related customers. |
| 50 | + |
| 51 | +As an extra feature, you can also export the stock quantities back to |
| 52 | +PrestaShop. |
| 53 | + |
| 54 | +If you want to export from Odoo to PrestaShop changes made on the products, |
| 55 | +product categories or product images, you need to install |
| 56 | +*connector_prestashop_catalog_manager* module in this same repository. |
| 57 | + |
| 58 | +This connector supports PrestaShop version up to 1.6.11. Maybe later versions |
| 59 | +are also supported, but they haven't been tested. It uses the webservices of |
| 60 | +PrestaShop. |
| 61 | + |
| 62 | +**Table of contents** |
| 63 | + |
| 64 | +.. contents:: |
| 65 | + :local: |
| 66 | + |
| 67 | +Configuration |
| 68 | +============= |
| 69 | + |
| 70 | +To configure this module, you need to set several things in both PrestaShop |
| 71 | +and Odoo: |
| 72 | + |
| 73 | +Steps in PrestaShop |
| 74 | +=================== |
| 75 | + |
| 76 | +#. Go to the control panel (usually at <url>/adminps). |
| 77 | +#. Login into the system. |
| 78 | +#. Go to *Advanced Parameters > Web service* |
| 79 | +#. Add a new entry. |
| 80 | +#. Generate a new API key that will be needed later. |
| 81 | +#. Grant all the needed access according your security policy. |
| 82 | + |
| 83 | +Steps in Odoo |
| 84 | +============= |
| 85 | + |
| 86 | +#. Go to *Connectors > PrestaShop > Backends*. |
| 87 | +#. Create a new record for registering a PrestaShop backend. You will bind |
| 88 | + this backend to an specific company and warehouse. |
| 89 | +#. Define the main URL of the PrestaShop web, and the webservice key you |
| 90 | + got in PrestaShop. |
| 91 | +#. Define other parameters like the discount and shipping products, or if the |
| 92 | + taxes are included in the price. |
| 93 | +#. Click on "Synchronize Metadata" button. This will bring the basic shop |
| 94 | + information that you can find on *Websites* and *Stores* menus. |
| 95 | +#. Click on "Synchronize Base Data" button. This will import carriers, |
| 96 | + languages, tax groups and the rest of base data that are needed for the |
| 97 | + proper work. |
| 98 | +#. Go to *Accounting > Configuration > Taxes > Tax Groups*, and include |
| 99 | + for each of the tax definition imported from PrestaShop, the corresponding |
| 100 | + taxes in Odoo. |
| 101 | +#. Activate the job runner, checking the connector documentation for setting |
| 102 | + the server correctly for using it in |
| 103 | + http://odoo-connector.com/guides/jobrunner.html |
| 104 | +#. Alternatively, if you are not able to activate it, you can enable the |
| 105 | + scheduled job called "Enqueue Jobs". |
| 106 | +#. Activate the scheduled jobs for importing the records you want: |
| 107 | + |
| 108 | + * PrestaShop - Export Stock Quantities |
| 109 | + * PrestaShop - Import Carriers |
| 110 | + * PrestaShop - Import Customers and Groups |
| 111 | + * PrestaShop - Import Products and Categories |
| 112 | + * PrestaShop - Import Sales Orders |
| 113 | + * PrestaShop - Import suppliers |
| 114 | + * PrestaShop - Payment methods |
| 115 | + |
| 116 | +Usage |
| 117 | +===== |
| 118 | + |
| 119 | +To use this module, you need to: |
| 120 | + |
| 121 | +#. Go to *Connectors > Queue > Jobs*, and check the correct enqueuing of |
| 122 | + the tasks. |
| 123 | +#. Check on each menu the resulting imported records (Customers, Sales |
| 124 | + Orders...) |
| 125 | + |
| 126 | +Test dependencies |
| 127 | +================= |
| 128 | + |
| 129 | +Extra libs are required to run the tests: |
| 130 | +* ``vcrpy`` |
| 131 | +* ``freezegun`` |
| 132 | + |
| 133 | +Known issues / Roadmap |
| 134 | +====================== |
| 135 | + |
| 136 | +* Work with multiple warehouses. |
| 137 | +* Tests. |
| 138 | + |
| 139 | +Bug Tracker |
| 140 | +=========== |
| 141 | + |
| 142 | +Bugs are tracked on `GitHub Issues <https://github.com/OCA/connector-prestashop/issues>`_. |
| 143 | +In case of trouble, please check there if your issue has already been reported. |
| 144 | +If you spotted it first, help us to smash it by providing a detailed and welcomed |
| 145 | +`feedback <https://github.com/OCA/connector-prestashop/issues/new?body=module:%20connector_prestashop%0Aversion:%2015.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_. |
| 146 | + |
| 147 | +Do not contact contributors directly about support or help with technical issues. |
| 148 | + |
| 149 | +Credits |
| 150 | +======= |
| 151 | + |
| 152 | +Authors |
| 153 | +~~~~~~~ |
| 154 | + |
| 155 | +* Akretion |
| 156 | +* Camptocamp |
| 157 | +* AvanzOSC |
| 158 | +* Tecnativa |
| 159 | +* Mind And Go |
| 160 | + |
| 161 | +Contributors |
| 162 | +~~~~~~~~~~~~ |
| 163 | + |
| 164 | +* Sébastien Beau < [email protected]> |
| 165 | +* Benoît Guillot < [email protected]> |
| 166 | +* Alexis de Lattre < [email protected]> |
| 167 | +* Guewen Baconnier < [email protected]> |
| 168 | +* Sergio Teruel < [email protected]> |
| 169 | +* Mikel Arregi < [email protected]> |
| 170 | +* Pedro M. Baeza < [email protected]> |
| 171 | + |
| 172 | +* Florent THOMAS < [email protected]> |
| 173 | +* Francisco Fernández < [email protected]> |
| 174 | +* Florian da Costa < [email protected]> |
| 175 | + |
| 176 | + |
| 177 | + |
| 178 | + |
| 179 | +* `Greenice <https://www.greenice.com>`_: |
| 180 | + |
| 181 | + * Fernando La Chica < [email protected]> |
| 182 | + |
| 183 | +Other credits |
| 184 | +~~~~~~~~~~~~~ |
| 185 | + |
| 186 | +* `PrestaShop logo <http://seeklogo.com/prestashop-logo-178788.html>`_. |
| 187 | +* `Odoo logo <https://www.odoo.com/es_ES/page/brand-assets>`_. |
| 188 | +* `Cable <https://openclipart.org/detail/174134/cable-with-connector>`_. |
| 189 | + |
| 190 | +Maintainers |
| 191 | +~~~~~~~~~~~ |
| 192 | + |
| 193 | +This module is maintained by the OCA. |
| 194 | + |
| 195 | +.. image:: https://odoo-community.org/logo.png |
| 196 | + :alt: Odoo Community Association |
| 197 | + :target: https://odoo-community.org |
| 198 | + |
| 199 | +OCA, or the Odoo Community Association, is a nonprofit organization whose |
| 200 | +mission is to support the collaborative development of Odoo features and |
| 201 | +promote its widespread use. |
| 202 | + |
| 203 | +This module is part of the `OCA/connector-prestashop <https://github.com/OCA/connector-prestashop/tree/15.0/connector_prestashop>`_ project on GitHub. |
| 204 | + |
| 205 | +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. |
0 commit comments