1. Start the integration
Go to Holded Store, from the top left menu.
From the "Integrations" tab, click on "PrestaShop".
Once PrestaShop is selected, click Activate; the PrestaShop icon will appear in the left menu under "Integrations".
Click on "Connect and configure" and, in the pop-up panel, click again on "Connect and configure".
In the PrestaShop configuration modal click on "Download PrestaShop Plugin".
☝🏼 For the Plug-in to work correctly, you need to have PHP version 7.4 and PrestaShop 1.7.8.
Once downloaded, go to Menu > Settings > More > Developers.
Click on the button "+ New API Key" and create a new key.
In your PrestaShop account, you can go to the Modules list and upload the folder of the plug-in you downloaded from Holded.
Copy the API key in the Holded plug-in settings section.
☝🏼 Ideally, generate only one API key. If you have more than one shop or more than one synchronization, you can use the same key.
Click "Save".
2. Complete the integration
Select PrestaShop from the Holded Store and click Activate.
Enter the first part of your PrestaShop URL (usually the name of your shop).
Click “Settings” to open the synchronization window with the 4 sections:
Sales:
Follow these steps to configure how to import your orders:
1. Fill in the data:
Convert to: select how you want to convert your orders between Sales Order, Sales Ticket, or Sales Invoice.
Sales account: select the sales account you want to link to your orders.
Payment methods: link your PrestaShop payment methods to the banks or gateways you have added to your Holded account.
2. Select the Advanced settings option to define things like document numbering and accounting accounts:
Create contact: check this box if you want to create a new contact in Holded each time an order is imported.
Template: in case you have set up a document template, click on the drop-down menu to select it.
Manual account number: tick this box to select a unique account number for all your created contacts.
Default tax: check this box to apply the configured tax in case PrestaShop displays empty or 0% tax.
Automatic tax adjustment: by checking this box, the system will apply an automatic rounding so that the amount of the invoice in Holded is the same as in PrestaShop.
If not activated, there may be a difference of cents due to different rounding methods being applied between the two platforms.Document numbering: select from the drop-down menu which number you want to apply from those previously configured in Holded.
Use invoice number: by checking this box, the invoice number will be the same as the invoice generated in PrestaShop.
Show delivery address: tick this box if you want the delivery address to be shown on the document generated in Holded.
Import payment method: tick this option if you need the payment method to be the same as in PrestaShop.
Relate contact by ID: Check this box if you want your contact in Holded to be linked to PrestaShop's internal contact ID.
If unchecked, the contact will be linked first by email and then by VAT number.
3. Select Configure order statuses to mark the status of your order respecting the status numbers previously configured in PrestaShop:
Paid: Orders with the related number will be imported as tickets or invoices and marked as paid.
Pending: orders with the related number will be imported as tickets or invoices with no payment added.
Products
Click the drop-down menu to choose whether you want to import your products. Note that the import is unidirectional, i.e. products are transferred from PrestaShop to Holded, but not the other way around.
Stock Level
Click on the drop-down menu to choose between:
I want to synchronize stock levels (bidirectional): any change in the stock of a product on one of the two platforms (by order, manual adjustment, or import) will automatically update the stock on the other, as long as the SKUs match.
For example: if you have 88 units on Holded and 77 on PrestaShop, and you sell 1 on PrestaShop, its stock drops to 76. That same number (76) is updated in Holded, adjusting the total on both platforms.I don't want to synchronize stock levels (unidirectional): stock is only deducted in Holded when an order is processed in PrestaShop.
Example: if you have 88 units in Holded and 77 in PrestaShop, and you sell 1 in PrestaShop, Holded only subtracts that sold unit and remains at 87, without matching the total with PrestaShop.
Warehouses
Click on the drop-down menu to select the warehouse where you want to register your stock movement.
After following these 4 steps, click the "Save" button at the top right of your screen.
Click on the Synchronize button at the top right of your screen every time you need to update the data.
Delete my PrestaShop shop on Holded
If you want to delete your PrestaShop shop on Holded, follow these steps:
First, in PrestaShop, go to Modules > Module Manager.
Locate the 'Holded' module, drop down the options, and click Deactivate.
Once deactivated, go back to the options and click Uninstall.
Once this is done, the shop will usually disappear from the Integrations section of your Holded account. However, sometimes it may still be listed there. To confirm this, go to Menu > Settings > Integrations > Prestashop. If you still see the shop listed:
Click on Settings.
In the bottom section of the page, click Delete shop.
☝🏼 Remember that deleting the shop will delete the data and settings associated with it; be sure to copy any important information before you do this. Data already synchronized (documents, products, contacts) will not be deleted.