ERPLY – Prestashop Inventory Module
We are happy to publish an updated Prestashop inventory module to synchronize products and orders between Erply and Prestashop (version 126.96.36.199). As the module is still in beta, please contact us at firstname.lastname@example.org and we’ll give you the access and setup instructions.
This module allows two-way synchronization of categories, products and customer groups. Also one way (from Prestashop to Erply) synchronization of customers, customer addresses, orders and order history. This guide details the setup and use of the Erply module.
1. Erply – Prestashop Inventory Connector setup
To start using the module, follow the steps listed below:
1.1. Erply module installation
Copy the Erply module to the Prestashop ‘Modules’ folder. Log in to Prestashop
administration panel and go to the ‘Modules’ page.
Choose Migration Tools module category from categories list.
Click the Erply Synchronizer “Install” button, a „successful installation“ message appears on the Erply Synchronizer module.
1.2. Erply module setup
Click „Configure“ on Erply Synchronizer module.
On the module page type in your Erply user credentials and save them using the “Save” button.
Before synchronizing the products some settings can be made and saved.
Priority – Select which system has higher priority when the same object (product, customer etc.) has been changed in both systems since the last synchronization.
Default Tax – If tax value is not found in product data this value is used.
Export orders from – Initial order export will be made starting from this date.
To begin the synchronization choose the synchronization direction (from Presta to ERPLY, from ERPLY to Presta or both ways) and click the ‘Start’ button.
After the initial synchronization use the ‘Start’ button if you wish to update existing data.
Keep in mind that Erply allows 500 API requests in an hour. If that number is exceeded, an
error message will show. In this case, return to the module page, wait for an hour and try to continue the synchronization by clicking the ‘Start’ button.
To enable automatic synchronization cron_all.php from module folder should be added to server’s crontab.
1.3. Erply module synchronization details
This module performs a two-way synchronization of the Erply – Prestashop product categories, Erply – Prestashop customer groups and Erply – Prestashop product, so all Erply products and customers appear in Prestashop and all Prestashop products and customers appear in Erply.
In case of Erply -> Prestashop synchronization the fields are mapped as:
1.3.1. Category/product group synchronization
1.3.2. Product synchronisation
|vatrate||id_tax_rules_group (local id is matched by vatrate value)|
|vatrate||id_tax (local id is matched by vatrate value)|
|brandName||id_manufacturer (New manufacturer is added if not found)|
|supplierName||id_supplier (New supplier is added if missing)|
|warehouses (sum of “free” field for all warehouses)||Quantity is added to product|
|images||Images are added to product|
1.3.3. Customer groups synchronization
The module also imports product images only from Erply to Prestashop.
Also, the synchronization module allows you to perform a one-way synchronization of the Prestashop -> Erply customers, customer address, orders and order history, so all Prestashop customers, customer addresses, orders and order histories appear in Erply.
In case of Prestashop -> Erply synchronization the fields are mapped as:
1.3.4. Customers synchronization
1.3.5. Customer address synchronisation
|typeID||id from Erply API getAddressTypes response|
1.3.6. Orders synchronization
|id||Order id if the order is synced before, null otherwise|
|type||“INVWAYBILL” is sent by default|
|customerID||Customer id if the customer is synced before, null otherwise|
|payerID||Customer id if the customer is synced before, null otherwise|
|addressID||Address id if the address is synced before, null otherwise|
|payerAddressID||Address id if the address is synced before, null otherwise|
|internalNotes||Prestashop Invoice Number: “invoice_number”|
|#productID||Product id if product is synced before, null otherwise|
*Shipping is sent as last product.
1.3.7. Order history synchronization
All updated orders are synchronized with Erply. If the order is deleted from Prestashop it is deleted from Erply also. If the order is paid invoiceState is updated to “READY” with saveSalesDocument update method.
If the order is paid new payment is synced to Erply with field mapping:
|customerID||clientID from Erply API getSalesDocuments response|
|documentID||“READY” or “PENDING” depending on the status|
|sum||Total from Erply API getSalesDocuments response|
|currencyCode||currencyCode from Erply API getSalesDocuments response|