Overview
Prestashop integration allows to import products, orders, suppliers from Prestashop to Connect and send shipping confirmation and stock updates to Prestashop.
When you run Connect with a Prestashop website, you must keep in mind the followings :
- Products are created in Prestashop and imported to Connect, you can not create products in Connect
- Orders are placed in Prestashop and imported to Connect, you can not create new orders in Connect
- Stock are managed only in Connect, and the quantity sellable is pushed to Prestashop, you must NOT manage stock in Prestashop
- Connect is compatible with Prestashop from the 1.5 version until the latest
- Connect i not compatible with the Prestashop Advanced Stock feature (ASM)
Connect uses only Prestashop webservices, meaning that you dont have to install any module in Prestashop.
Generate Prestashop API key
From your Prestashop admin panel and select menu "Advanced Parameters > Webservices".
First make sure that the webservices are enabled. Also, if you experience problems, you can enable the CGi Mode.
In the top right corner, click on button "Add a new key" :
- Click on the "generate" button to create the key
- Fill description
- Enable the key
- TIck all checkboxes in the first row to give Connect admin permissions
Once this is done, save your key.
Create the Prestashop integration
In Connect, select menu :
Integrations >> New integrations
Then, click on the "New integation" button at the bottom.
Fill the form according to the image above and click on "Save".
Configuration tab
API Connection
Once the integration is created, you must configure your prestashop settings in the "Configuration" tab :
Then, hit the save button : if your settings are correct, you'll get "Data saved." message, else an error message will be displayed.
If you get an error message, Make sure that you enable CGI option in prestashop.
Order import settings
- Import orders to store : select the store to assign to orders imported from this integration. This option makes sense only if you subscribed to the multiple store Connect option
- Import orders from id : with this option, you can ask Connect to start to import orders from a specific prestashop order ID. Pretashop order id is the prestashop order number. There are 2 reasons to use this option :
- It prevents Connect to parse ALL your prestashop orders before accesing to the current one to import (performance improvement)
- It prevents to import all orders that are already shipped
- Order statuses : for each prestashop order status, you can select an action and enable the "Retry" process. It is recommended to import in Connect only paid orders that must be shipped
- Available actions are :
- Do not import : to use for orders that must not be imported / shipped
- Import as valid : to use for orders that must be shipped
- Retry : enable this flag if the order status can change to a status that must be imported. For instance, "Pending payment" should have the retry as the order can change to "Payment accepted". However, "canceled" status must not be flagged as "Retry" as it is a final status
- Shipping method mapping : for each shipping method used in Prestashop, add a new row and match it to a Connect method. If the method you need is not available, please contact the support
- Payment method mapping : you can fill here the matching for payment methods. The prestashop payment string to put in the first column is the payment method available in the order grid in prestashop
Order Status that should be "imported as valid" are Processing ones
Shipping confirmation
When an order is partially or fully shipped, Connect will confirm the shipping to Prestashop.
There are 2 options depending of the order status :
- If the order is fully shipped, Connect sends the tracking number to Prestashop and applies the status "Status for full shipment" to the Prestashop order
- If the order is partially shipped, Connect only applies the status "Status for partial shipment" to the Prestashop order
if no status is configured here, Connect will not change Prestashop order status
Stock level import settings
These settings are used to import the initial stock from Prestashop to Connect when you are ready to go live and want to initialize the Stocks in Connect based on the values in Prestashop.
In the dropdown, select the warehouse where you want to import Prestashop stock levels to.
Once the warehouse is configured, click n the save button.
Now, if you want to import stock levels, go in the "Feeds" tab and click on the "Run now" button for to the "Import stock level" feed :
Stock level export settings
Here you configure what stock levels must be sent to Prestashop.
Every time the available stock for a product changes, Connect will schedule the update to send to Prestashop.
You can configure Connect to send the stocks from several warehouses to Prestashop. For instance, you could send the sum of the main warehouse + a shop + a supplier to Prestashop.
To achieve that goal, select the different warehouses and save.
Feeds tab
Once configuration is done, you will have to run and schedule the different feeds available.
Here's the process advised to run all feeds in the correct order :
- Run the "Import new products" feed manually ("Run now" button) if you have not too much products, else schedule it every hour.
Wait until all products get imported into Connect.
- Schedule the "Update products" feed once a day.
- Schedule the "Import product images" feed every 4 hours.
- Run the "Import new orders" feed manually ("Run now" button) if you have not too much orders to import, and schedule it every 5 minutes.
Wait until all orders get imported into Connect.
- Never run and never schedule the feed "Update orders" now.
- Run the "Import stock levels" feed manually only once time ("Run now" button). Don't schedule it.
Wait until all products stock level get updated into Connect.
- Run the "Import suppliers" feed and schedule it once a day.
- Run the "Product supplier Import" and schedule it once a day.
- Don't schedule and don't run the feed "Stock level export".
- Schedule the "Stock check" feed once a day.
- Don't schedule and don't run the feed "Shipping confirmation".
Never run manually the "Export stock" feed at this moment !
It can have disastrous consequencies as the stock of your Magento will be updated with the one in Connect.
- Schedule the "Retry" feed every hour.
Stock check
This feed is designed to ensure the stock synchronization between Connect and Prestashop.
You should schedule it once a day as it may take time to be executed.
During the stock Check, Connect will download all stock level from Prestashop and compares them with the stock in Connect : if some differences are found, then Connect will send the stock update to Prestashop