1. Activate the Webservices<\/h3>\n
From Prestashop administration panel select: Advanced Parameters \/ Webservice<\/strong>.<\/p>\n Activate \u00abEnable PrestaShop WebService\u00bb <\/strong>and \u00abSave\u00bb.<\/p>\n Click on \u00abAdd a new access key<\/p>\n Click on \u00abCreate<\/strong>\u00bb\u00a0and save the key on Qapla’.<\/p>\n Click on the first checkbox \u00abView (GET)<\/strong>\u00bbto give access to all data as read only and save.<\/p>\n <\/p>\n The status writing must be enabled in the webservice permissions on Prestashop.<\/p>\n Click the permissions listed below, in the \u00abModify (PUT)<\/strong>\u00bb \u00a0and \u00abAdd (POST)<\/strong>\u00bb columns.<\/p>\n <\/p>\n For what concerns Prestashop, the configuration is ended.<\/p>\n Ecco la traduzione:<\/p>\n Go to Settings > Channels > [Channel Name] > Configure > E-Commerce<\/strong>, select the platform, and enter the key previously generated in PrestaShop.<\/p>\n After entering it, click \u00abSave and run test<\/strong>\u00bb.\u00a0Once 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.<\/p>\n To activate order import<\/strong>, go to: Settings > Channels > [Channel Name] > Configure > Imports > Orders<\/strong><\/p>\n Select the desired import mode:<\/p>\n Statuses excluded from import<\/strong><\/p>\n 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.<\/p>\n Custom payment statuses for Cash on Delivery (COD) orders<\/strong><\/p>\n Some CMS platforms allow you to customize payment statuses, in addition to the standard ones provided by the system.<\/p>\n 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.<\/p>\n If you only use standard statuses, no action is required.<\/p>\n Write to support@qapla.it listing<\/strong> the exact wording of the custom order payment statuses<\/strong> 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.<\/p>\n Advanced Settings<\/strong><\/p>\n Within the \u201cImports > Orders\u201d section, you can activate the following options:<\/p>\n Carrier Pre-assignment<\/strong><\/p>\n It is possible to automatically import the carrier pre-assigned<\/strong> in PrestaShop.<\/p>\n To configure this function correctly:<\/p>\n <\/p>\n Set default weight<\/strong><\/p>\n Set a default weight to apply to imported orders.<\/p>\n Set default number of parcels<\/strong><\/p>\n Define a default number of parcels for each imported order.<\/p>\n 6. Updating the order on PrestaShop<\/p>\n To activate the automatic update on PrestaShop, go to: Settings > Channels > [Channel Name] > Configure > Updates > E-commerce<\/p>\n Enable the available update options:<\/p>\n Each type of update can be associated with a specific Order Status<\/strong> configured in your PrestaShop.<\/p>\n To activate shipment import<\/strong>, go to: Settings > Channels > [Channel Name] > Configure > Imports > Shipments > Connectors > PrestaShop Connector > Set up Connector. The import will run automatically at the configured times.<\/p>\n Qapla’ uses the official PrestaShop APIs (Web Services)<\/a>.<\/p>\n If it doesn’t work, we recommend requesting verification from the manager who administers the site on PrestaShop.<\/p>\n Self-test<\/strong><\/p>\n By accessing the \/api folder of your PrestaShop<\/strong> (e.g., https:\/\/www.yoursite.com\/api), you will get a login prompt:<\/p>\n Enter the access key in the “Username” field and leave the password blank.<\/p>\n If successful, you will get an XML data page; otherwise, an error like \u00ab401 Unauthorized\u00bb.<\/p>\n In case of an error, the key may be incorrect.<\/p>\n Enabling CGI mode<\/strong><\/p>\n If it doesn’t work, enable CGI mode for PHP by going to the PrestaShop admin panel and selecting: Advanced Parameters \/ Webservice, <\/strong>\u00abEnable CGI mode for PHP<\/strong>\u00bb.<\/strong><\/p>\n Troubleshooting<\/strong><\/p>\n Qapla’ uses standard PrestaShop Web Services<\/strong>, accessing the www.yoursite.ext\/api\/ endpoint.<\/p>\n If configured correctly, operation is guaranteed.<\/p>\n In general, connections to servers respond with HTTP error codes<\/a>.<\/p>\n![](\"https:\/\/cp.qapla.it\/img\/help\/prestashop\/webservice\/1.jpg\")
<\/p>\n2. Add a new access key<\/h3>\n
![](\"https:\/\/cp.qapla.it\/img\/help\/prestashop\/webservice\/2.jpg\")
<\/p>\n3. Writing permissions to update orders<\/h3>\n
![](\"https:\/\/cp.qapla.it\/img\/help\/prestashop\/webservice\/3.jpg\")
<\/p>\n4. Enter the data on Qapla’<\/h3>\n
![\"\"](\"http:\/\/help.qapla.it\/wp-content\/uploads\/2025\/08\/Screenshot-2025-10-21-114308.png\")
<\/a><\/p>\n5. Activating order import<\/h3>\n
\n
\n
\n
\n
\nThe carrier code must be entered in the Transcoding code<\/b> 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<\/strong>. Example: “BARTOLINI,BRT,BRT-IT”<\/li>\n
\nOn 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.<\/li>\n<\/ol>\n\n
\n
7. Activating shipment import<\/h3>\n
\n<\/strong>Within this section, set the time(s) when Qapla\u2019 will import shipments from PrestaShop.<\/p>\n\n
Not working?<\/h3>\n
![](\"https:\/\/sellsend2.gls-italy.com\/help\/img\/prestashop\/test.jpg\")
<\/p>\n![\"\"](\"http:\/\/help.qapla.it\/wp-content\/uploads\/2017\/10\/Prestashop-Modalit\u00e0-CGI.png\")
<\/a><\/p>\n\n\n
\n Error<\/strong><\/td>\n Description<\/strong><\/td>\n Solution<\/strong><\/td>\n<\/tr>\n<\/thead>\n\n \n 401 Unauthorized<\/td>\n Qapla’ is not authorized to access<\/td>\n The key provided is incorrect or has not been authorized following the procedure explained above.<\/td>\n<\/tr>\n \n 403 Forbidden<\/td>\n The server forbids access to Qapla’<\/td>\n 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.<\/td>\n<\/tr>\n \n 404 Not Found<\/td>\n The URL or endpoint being accessed does not exist<\/td>\n Verify the correctness of the site URL and confirm that the site is indeed a PrestaShop.<\/td>\n<\/tr>\n \n 500 Internal Server Error<\/td>\n Internal error of the site’s server<\/td>\n Check the cause on your server.<\/td>\n<\/tr>\n \n Bad HTTP response<\/td>\n The site is unreachable<\/td>\n The site URL is incorrect, offline, or no longer exists.<\/td>\n<\/tr>\n \n 301 Moved Permanently<\/td>\n The site URL redirects to another<\/td>\n Enter the correct site URL.<\/td>\n<\/tr>\n \n 302 Found<\/td>\n The site URL redirects to another<\/td>\n Enter the correct site URL.<\/td>\n<\/tr>\n \n Could not resolve host: www.xxx.xx<\/td>\n The URL does not exist<\/td>\n Enter the correct site URL.<\/td>\n<\/tr>\n \n OpenSSL SSL_connect: Connection reset by peer in connection to www.xxx.xx:443<\/td>\n Problems with the site’s certificate<\/td>\n Verify the site’s https certificate.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Pick-up Point Management<\/h2>\n