PrestaShop

Updated November 27, 2024 00:28

PrestaShop is a freely accessible open-source eCommerce platform with out-of-the-box features that help merchants build comprehensive eCommerce websites coupled with amazing functionality. ShipStation connects directly to your PrestaShop account. With one click, or on an automated schedule, your orders are downloaded from PrestaShop. As soon as you process a shipment, ShipStation communicates the updated order status, shipping method and tracking information back to PrestaShop.

Want to know more about PrestaShop? Visit the PrestaShop website.

PrestaShop Requirements

Connection Requirements:

An active account with PrestaShop.
Your PrestaShop Web Service Key
Your PrestaShop Store URL
PrestaShop PHP v.7

Scope of Support

Depending on the unique Apache server configuration, other changes to the webserver may be needed to connect ShipStation to PrestaShop. Any modification to the webserver is outside ShipStation's scope of support. If you need assistance modifying the server configuration, we recommend you contact the store developer or PrestaShop support.

Order Import Requirements:

Include a Ship To address.
Must contain at least one physical product. Downloadable products are not imported into ShipStation.

Connect a PrestaShop store to ShipStation

To connect your PrestaShop store to ShipStation you must take steps in both PrestaShop and ShipStation.

Steps in Prestashop

Log in to your PrestaShop admin panel.
Click Advanced Parameters, then Webservice from the drop-down menu.
Click Add new webservice key to create a Key for ShipStation.
Click Generate to create the new Key.

Copy the Key. You'll need it later when connecting to ShipStation.
Enter a Key description (like ShipStation Access Key) in case you need to revisit it in the future.
Toggle the Status to Yes.
Scroll down to the Permissions table and check the View (GET) box for all of the available Resources.

Important

Make sure all Resources have the box checked for the View (GET) permission.
Check the Modify (PUT) box for the order_carriers and orders permissions, then click Save.
Toggle Enable PrestaShop's webservice to Yes. If you use other third-party services with PrestaShop, this may already be enabled.
Click Information from the Advanced Parameters menu.
Copy the Shop URL under Store Information.

Steps in ShipStation

Open a new tab or browser window and log in to your ShipStation account.
Go to Account Settings.
Select Selling Channels from the sidebar, then choose Store Setup.
Click Connect a Store or Marketplace.
Select PrestaShop.
Enter your PrestaShop Web Service Key and Store URL, and map any custom statuses if needed.
Click Test Connection, then Connect if the test is successful.
Note

If ShipStation has trouble authenticating with your server, you or your system admin may need to add a .htaccess file to your webservices directory. This file should contain the following rule:
```
<IfModule mod_rewrite.c> 
RewriteEngine on 
RewriteRule .* - [E=HTTP_AUTHORIZATION:% {HTTP:Authorization} ,L]
</IfModule>
```

After you've completed the connection steps, the store's Settings page will open. You can adjust your store-specific settings like branding and customer notifications, if you wish. Or click Save to close.

Available Features for Prestashop

The ShipStation integration with PrestaShop supports the following standard features:

Feature	Supported?
Custom Statuses
Customer Emails
Customer Phone Numbers
Requested Service
Payment Method
Discounts
Identifies Gift Orders
Internal Notes
Notes from Buyer
Order Weight
Item Weight
Item Images
Item Options
Item Warehouse Location

Order Status Mapping

ShipStation Status	PrestaShop Status
Awaiting Payment	1) Awaiting Cheque Payment 8) Payment Error 10) Awaiting Bank Wire Payment 11) Awaiting PayPal Payment
Awaiting Shipment	2) Payment Accepted 3) Preparation in Progress 12) Payment Remotely Accepted
Shipped	4) Shipped 5) Delivered
Cancelled	6) Canceled 7) Refund
On Hold	9) On Backorder

Data Sent with Shipment Notification

This table indicates which data ShipStation sends to Prestashop with the marketplace shipment notification:

Field	Sent to Marketplace?
Status Update
Tracking Number
Carrier
Service
Carrier Fee
Note to Buyer
Item Information

PrestaShop Additional Features

ShipStation's integration with PrestaShop allows for the following additional features:

Feature	Description
Configurable Time Zone	By default, ShipStation assumes that the PrestaShop store's server uses UTC as the timezone. If your PrestaShop account uses a different server timezone, you can define it in the store's settings in ShipStation.
ShipStation uses the reference number of a combination’s record as the SKU for an item.	If items on PrestaShop orders do not have a SKU in ShipStation, you must fill out the Reference field in the PrestaShop Product Combination details. To find the Reference field in your PrestaShop account, go to `Products > Details for a product record > Combination > Details`.
🇫🇷 Pickup Orders	Prestashop orders with pickup information will import into ShipStation for the following carriers in France: Colissimo Mondial Relay Chronopost Your Prestashop store must have one of the supported carrier plugins installed to send the pickup information to ShipStation.

Feature

Description

Configurable Time Zone

By default, ShipStation assumes that the PrestaShop store's server uses UTC as the timezone. If your PrestaShop account uses a different server timezone, you can define it in the store's settings in ShipStation.

ShipStation uses the reference number of a combination’s record as the SKU for an item.

If items on PrestaShop orders do not have a SKU in ShipStation, you must fill out the Reference field in the PrestaShop Product Combination details.

To find the Reference field in your PrestaShop account, go to Products > Details for a product record > Combination > Details.

🇫🇷 Pickup Orders

Prestashop orders with pickup information will import into ShipStation for the following carriers in France:

Colissimo
Mondial Relay
Chronopost

Your Prestashop store must have one of the supported carrier plugins installed to send the pickup information to ShipStation.

PrestaShop Integration Notes

Custom Statuses are supported for Prestashop stores, but they must be set when connecting the store to ShipStation. If the statuses need to be adjusted after a store has been connected, you will need to reconfigure the store connection.

Note

ShipStation only receives the numerical status code when importing orders from PrestaShop. See this article from PrestaShop for more details on their statuses.
Since PrestaShop does not utilize product SKUs, ShipStation will import the product's Reference field as the SKU.

PrestaShop Troubleshooting Tips

Here are some common issues experienced by users, potential causes, and available troubleshooting tips.

Issue	How to troubleshoot or resolve
Error: (500) Internal Server Error	What it means: A (500) Internal Server Error is a generic error message that means something went wrong, but without any additional information to indicate the specific problem. What to do: To resolve a (500) error, you'll first need to investigate what's failing on the server. To do that, you should enable error reporting in PrestaShop. Review this PrestaShop forum post that explains how to enable error reporting. Once you have a detailed error message, use PrestaShop's GitHub page and the PrestaShop Forum to find a solution to the specific error. Try searching the known issues to see if other PrestaShop users have experienced the error before and have any available solutions.
Order Date in ShipStation is different than the Order Date in PrestaShop	What it means: This usually occurs because the PrestaShop server is using a different timezone than the timezone set in the store's settings in ShipStation. This time discrepancy causes the Order Date to be converted incorrectly. What to do: Update the store's settings so the store is using the same timezone as the server where your PrestaShop store is hosted.
Orders placed late in the day are not importing into ShipStation	What it means: Similar to the issue above, this typically occurs because the PrestaShop server is using a different timezone than the timezone set in the store's settings in ShipStation. This time discrepancy causes our import process to inadvertently skip ahead. What to do: Update the store's settings so the store is using the same timezone as the server where your PrestaShop store is hosted.

Issue

How to troubleshoot or resolve

Error: (500) Internal Server Error

What it means: A (500) Internal Server Error is a generic error message that means something went wrong, but without any additional information to indicate the specific problem.

What to do: To resolve a (500) error, you'll first need to investigate what's failing on the server. To do that, you should enable error reporting in PrestaShop. Review this PrestaShop forum post that explains how to enable error reporting.

Once you have a detailed error message, use PrestaShop's GitHub page and the PrestaShop Forum to find a solution to the specific error. Try searching the known issues to see if other PrestaShop users have experienced the error before and have any available solutions.

Order Date in ShipStation is different than the Order Date in PrestaShop

What it means: This usually occurs because the PrestaShop server is using a different timezone than the timezone set in the store's settings in ShipStation. This time discrepancy causes the Order Date to be converted incorrectly.

What to do: Update the store's settings so the store is using the same timezone as the server where your PrestaShop store is hosted.

Orders placed late in the day are not importing into ShipStation

What it means: Similar to the issue above, this typically occurs because the PrestaShop server is using a different timezone than the timezone set in the store's settings in ShipStation. This time discrepancy causes our import process to inadvertently skip ahead.