PrestaShop

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

  1. Log in to your PrestaShop admin panel.

  2. Click Advanced Parameters, then Webservice from the drop-down menu.

    Prestashop Advanced Parameters menu with webservice highlighted.
  3. Click Add new webservice key to create a Key for ShipStation.

    Prestashop_Webservice_AddKeyBTN_MRK.png
  4. Click Generate to create the new Key.

    Copy the Key. You'll need it later when connecting to ShipStation.

    Prestashop_Webservice_GenerateBTN_MRK.png
  5. Enter a Key description (like ShipStation Access Key) in case you need to revisit it in the future.

  6. Toggle the Status to Yes.

    Prestashop webservice status toggle with Yes highlighted.
  7. Scroll down to the Permissions table and check the View (GET) box for all of the available Resources.

    Prestashop webservice with View GET checkbox highlighted.

    Important

    Make sure all Resources have the box checked for the View (GET) permission.

  8. Check the Modify (PUT) box for the order_carriers and orders permissions, then click Save.

    Prestashop_Webservice_ResourcePermissions-ModifyPUT_MRK.png
  9. Toggle Enable PrestaShop's webservice to Yes. If you use other third-party services with PrestaShop, this may already be enabled.

    PrestaShop Enable webservice with Yes toggle highlighted.
  10. Click Information from the Advanced Parameters menu.

    Prestashop Advanced parameters with Configuration Information highlighted.
  11. Copy the Shop URL under Store Information.

    PrestaShop Store Information with Shop URL highlighted.

Steps in ShipStation

  1. Select PrestaShop.

    PrestaShop Logo
  2. Enter your PrestaShop Web Service Key and Store URL, and map any custom statuses if needed.

  3. 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:

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

Green checkmark. Supported feature. Yes.

Tracking Number

Green checkmark. Supported feature. Yes.

Carrier

Green checkmark. Supported feature. Yes.

Service

Red X mark. Unsupported feature. No.

Carrier Fee

Red X mark. Unsupported feature. No.

Note to Buyer

Red X mark. Unsupported feature. No.

Item Information

Red X mark. Unsupported feature. No.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

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.

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

ShipStation will import the customer's email address with the order data and can send shipment confirmation and delivery emails to that email address (configured in your Store settings).

ShipStation will import the customer phone number with the order data.

ShipStation will import the shipping method chosen by the customer during their store checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation can determine if an order is a gift from the order data sent by the store.

ShipStation will import internal notes or order activity from the store into the ShipStation Internal Notes field.

ShipStation will import notes provided by the customer when they made their purchase.

ShipStation will import the total order weight from the store.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order. These images will appear as thumbnails in your Order Details and can be included in email notifications and packing slips.

ShipStation will import item options (such as color or size) for each line item in the order. This data will appear in your Order Details and can be included in customer emails and packing slips.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

PrestaShop Integration Notes

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

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.

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

ShipStation will import the customer's email address with the order data and can send shipment confirmation and delivery emails to that email address (configured in your Store settings).

ShipStation will import the customer phone number with the order data.

ShipStation will import the shipping method chosen by the customer during their store checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation can determine if an order is a gift from the order data sent by the store.

ShipStation will import internal notes or order activity from the store into the ShipStation Internal Notes field.

ShipStation will import notes provided by the customer when they made their purchase.

ShipStation will import the total order weight from the store.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order. These images will appear as thumbnails in your Order Details and can be included in email notifications and packing slips.

ShipStation will import item options (such as color or size) for each line item in the order. This data will appear in your Order Details and can be included in customer emails and packing slips.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.