Connect Prestashop to Qapla’
The connection takes place through official Prestashop webservices.
In order to make Qapla’ communicate with your Prestashop, you have to follow these steps:
1. Activate the Webservices
From Prestashop administration panel select: Advanced Parameters / Webservice.
Activate «Enable PrestaShop WebService» and «Save».
2. Add a new access key
Click on «Add a new access key
Click on «Create» and save the key on Qapla’.
Click on the first checkbox «View (GET)»to give access to all data as read only and save.
3. Writing permissions to update orders
The status writing must be enabled in the webservice permissions on Prestashop.
Click the permissions listed below, in the «Modify (PUT)» and «Add (POST)» columns.
4. Enter the data on Qapla’
For what concerns Prestashop, the configuration is ended.
Ecco la traduzione:
Go to Settings > Channels > [Channel Name] > Configure > E-Commerce, select the platform, and enter the key previously generated in PrestaShop.
After entering it, click «Save and run test». Once your PrestaShop store is connected to Qapla’, you can configure the import of orders or shipments and the automatic order status update directly on PrestaShop.
5. Activating order import
To activate order import, go to: Settings > Channels > [Channel Name] > Configure > Imports > Orders
Select the desired import mode:
- Automatic: Qapla’ will query your platform every hour (at .00, e.g., 9:00, 10:00, 11:00, etc.) to import new orders and update existing ones.
- Manual: you can start the import at any time from the Labels section, by selecting PrestaShop and clicking on Manual Import.
Statuses excluded from import
You can exclude specific order statuses from the import (in addition to those excluded by default), thus customizing the workflow based on your operational needs.
Custom payment statuses for Cash on Delivery (COD) orders
Some CMS platforms allow you to customize payment statuses, in addition to the standard ones provided by the system.
If you have configured custom payment statuses to identify Cash on Delivery (COD) orders, it is essential to communicate this to Qapla’ Customer Care to ensure correct order import management.
If you only use standard statuses, no action is required.
Write to support@qapla.it listing the exact wording of the custom order payment statuses used for Cash on Delivery. Once Qapla’ Customer Care confirms they have been added, orders with these payment statuses will be automatically recognized as COD orders.
Advanced Settings
Within the “Imports > Orders” section, you can activate the following options:
- Import product images
- Import weight
- Customs code and Country of origin: allows importing this data from the order’s products, if available in the CMS. Enter the name of the custom attribute to be read in the appropriate field.
- Import order-related messages as notes: Qapla’ imports notes from PrestaShop by default, reading the “other” field. Checking this option enables merging the contents of PrestaShop’s “other” and “messages” fields into a single note visible on Qapla’.
- Import PUDO (plugin function): allows importing the “alias” field related to the pick-up point ID, only if you use a dedicated plugin like the BRT PUDO plugin.
- Weight import mode for variants:
- The variant’s weight overwrites the base weight (default setting)
- The variant’s weight is added to the base weight: useful if the variant represents an additional weight to the main product. Example: an order weighs 5 kg and the variant 2 kg, the total is 7 kg; with this option, the total weight is imported: base weight + variant.
Carrier Pre-assignment
It is possible to automatically import the carrier pre-assigned in PrestaShop.
To configure this function correctly:
- Verify the Carrier IDs present on your PrestaShop platform (you can use WS Test). Each carrier ID has a carrier code.
- Each carrier ID configured and used on your platform must be associated with the carriers available on your channel/account.
The carrier code must be entered in the Transcoding code field in the carrier configuration section. If you want to associate multiple carrier codes, you can enter them separated by a comma, with no spaces. Example: “BARTOLINI,BRT,BRT-IT” - Write to support@qapla.it to complete the configuration, sending the channel name, all the codes, and the carrier to associate them with.
On the next import, the orders will be associated with the correct carrier. It is recommended to verify the actual import and the correct carrier assignment on one or more orders after saving the configuration, to ensure the value mapping is correct.
Set default weight
Set a default weight to apply to imported orders.
Set default number of parcels
Define a default number of parcels for each imported order.
6. Updating the order on PrestaShop
To activate the automatic update on PrestaShop, go to: Settings > Channels > [Channel Name] > Configure > Updates > E-commerce
Enable the available update options:
- Shipped
- Update the order to “shipped” when the shipment is trackable.
- Update the order to “shipped” when the goods are actually in the carrier’s hands (The statuses for Qapla’ are: Departed, In transit, Out for delivery)
- Delivered: Update the order to “delivered” when the shipment is delivered
- Returned: Do not update to “delivered” when the shipment has returned or been returned to the sender
- Tracking number: Update shipments on PrestaShop by inserting the Tracking Number.
Each type of update can be associated with a specific Order Status configured in your PrestaShop.
7. Activating shipment import
To activate shipment import, go to: Settings > Channels > [Channel Name] > Configure > Imports > Shipments > Connectors > PrestaShop Connector > Set up Connector.
Within this section, set the time(s) when Qapla’ will import shipments from PrestaShop.
- You can configure up to two times per channel
- If you wish to set more than two times, contact our customer care by writing to support@qapla.it
The import will run automatically at the configured times.
Not working?
Qapla’ uses the official PrestaShop APIs (Web Services).
If it doesn’t work, we recommend requesting verification from the manager who administers the site on PrestaShop.
Self-test
By accessing the /api folder of your PrestaShop (e.g., https://www.yoursite.com/api), you will get a login prompt:
Enter the access key in the “Username” field and leave the password blank.
If successful, you will get an XML data page; otherwise, an error like «401 Unauthorized».
In case of an error, the key may be incorrect.
Enabling CGI mode
If it doesn’t work, enable CGI mode for PHP by going to the PrestaShop admin panel and selecting: Advanced Parameters / Webservice, «Enable CGI mode for PHP».
Troubleshooting
Qapla’ uses standard PrestaShop Web Services, accessing the www.yoursite.ext/api/ endpoint.
If configured correctly, operation is guaranteed.
| Error | Description | Solution |
| 401 Unauthorized | Qapla’ is not authorized to access | The key provided is incorrect or has not been authorized following the procedure explained above. |
| 403 Forbidden | The server forbids access to Qapla’ | Check if the site has security strategies (Firewall) active and make sure Qapla’s IPs are authorized. To request the complete and updated list of IPs, contact our support by writing to support@qapla.it. |
| 404 Not Found | The URL or endpoint being accessed does not exist | Verify the correctness of the site URL and confirm that the site is indeed a PrestaShop. |
| 500 Internal Server Error | Internal error of the site’s server | Check the cause on your server. |
| Bad HTTP response | The site is unreachable | The site URL is incorrect, offline, or no longer exists. |
| 301 Moved Permanently | The site URL redirects to another | Enter the correct site URL. |
| 302 Found | The site URL redirects to another | Enter the correct site URL. |
| Could not resolve host: www.xxx.xx | The URL does not exist | Enter the correct site URL. |
| OpenSSL SSL_connect: Connection reset by peer in connection to www.xxx.xx:443 | Problems with the site’s certificate | Verify the site’s https certificate. |
In general, connections to servers respond with HTTP error codes.
Pick-up Point Management
The Qapla’ PUDO solution is available: pick-up points for flexible shipments and deliveries.
Offer your customers the choice of carrier delivery points and import all the information directly into Qapla’ for shipment management.
See all the details in our dedicated guide: PrestaShop PUDO Plugin.