Shopify: Integration Guide

How to add a Shopify store to ShipStation, what features are available, other need-to-know details, and troubleshooting tips.

Shopify is a hosted-shopping-cart for your ecommerce store that offers enhanced store features through its integrated app marketplace. The ShipStation Shopify integration supports order and product imports, custom field data imports, customer-requested shipping services and much more!

Need an account? Sign up for a free 14-day Shopify trial!

Shopify Integration Requirements

Connection Requirements:

  • An active Shopify account.

  • Your Shopify store domain.

Order Import Requirements:

  • The order has been created within 90 days of the current date.

  • Orders must contain at least one physical product.

  • Orders will not import if certain fields are missing in the feed (e.g., address line 1, postal code, etc)

  • Include a Ship To address.

Connect a Shopify Store to ShipStation

To connect your Shopify store to your ShipStation account:

  1. Select the Shopify tile.

    Shopify logo on square tile button that reads, "Connect".
  2. Enter your Shopify Domain, then click Connect.

    The Shopify set modal is open with the domain field highlighted and an arrow pointing to the connect button.

    To find your Shopify Domain, log in to your Shopify account and go to your dashboard. Copy the part of the URL after https:// but before /admin:

    Shopify store url in browser with myshopify.com highlighted.
  3. After you click Connect, you'll be redirected to Shopify, and the ShipStation Application will be added to your Shopify account. No additional action is needed if you're already logged in to Shopify. If you're not logged in to ShipStation, you'll be prompted to log in now.

Once the application installs, you'll be redirected back to your ShipStation account, where you can update the store-specific settings in ShipStation.

Available Features for Shopify Integration

The ShipStation integration with Shopify supports these standard features:

Additional Features for the Shopify Integration

The ShipStation integration with Shopify allows for these additional features:

Feature

Description

Import Shopify Fraud Assessment

Identify possible illegitimate orders in ShipStation when Shopify's Fraud Risk Assessment feature is enabled. Shopify's fraud assessment can be imported into one of an order's Custom Fields.

Instant Order Import

Enable the Automatic Import setting for Shopify to import new orders to ShipStation as soon as they are ready to ship.

Update Modified Shopify Orders

Update Shopify order changes after the order has been imported to ShipStation. Review Shopify's: Update Modified Shopify Orders help article for more information.

Send Updates to Shopify Warehouse Location

This feature is only available on the newest version of the Shopify integration.

Notify Shopify when an order's warehouse location has changed within ShipStation to appropriately deduct inventory from the correct warehouse location.

To properly enable this, you must do the following:

  • Enable stock in Shopify for the relevant warehouses.

  • Set up a separate Ship From Location for every Shopify Warehouse and link it to the appropriate inventory source.

    Warehouse Name

    Name the Ship From Location exactly the same as your Shopify Warehouse location for easier tracking.

  • Enable “Use a Ship From Location Inventory Source as the Location for Marketplace Notifications” in ShipStation's Shopify store settings,

The Ship From Location that is selected needs to have a Shopify Inventory Source connected to it for this setting to work as expected.

Processing Time

Shopify has a feature available on Shopify Plus plans called “Processing Time” which displays the time between when an order is placed by a customer and when the order should be fulfilled by the business.

The processing time is imported into ShipStation with orders as the "Ship By" date. You can view it in Order Details and the Order Grid. You can use the Ship By date in your Automation Rules.

Supports Partial Shipping

If you split a Shopify order in ShipStation, the shipment update we'll send to Shopify will only include the products within the shipped order.

Supports Shopify POS

ShipStation will import Shopify POS orders as long as they are for a physical product and as long as they require shipping.

Support-Enabled Additional Features for Shopify

In addition to those features already listed, you can request the ShipStation support team to enable the following settings for your Shopify store.

Feature

Description

Exclude Third-Party Fulfilment

When enabled, ShipStation will only import products in an order if the fulfilment type is set to Manual or Shopify.

This feature is primarily used if you have a fulfilment provider (like Fulfilment by Amazon) connected to your Shopify account.

Map "authorized" to Awaiting Payment

When enabled, ShipStation will import Shopify orders in the Authorized status as Awaiting Payment orders in ShipStation. If this setting is not enabled, Authorized orders import as Awaiting Shipment.

Use Fulfillable Quantity

The Use Fulfillable Quantity setting allows ShipStation to update the quantity of an item on an order in ShipStation if that value changes in Shopify.

Enable this setting to allow the line items in ShipStation to update based on the actions taken in Shopify.

The fulfillable quantity value in Shopify updates when orders are fulfilled within Shopify, are partially cancelled, or the line items are edited within Shopify. If any of these actions occur, ShipStation will update the quantity the next time you refresh your Shopify store in ShipStation.

This integration allows you to define the Status Mappings for the store connection.

ShipStation will import the customer's email address with the order and can send customer shipment confirmation and delivery emails, which are configured in your Store Settings.

ShipStation will import the customer phone number.

ShipStation will import the shipping method chosen by the customer at time of checkout.

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

ShipStation will import discount and coupon information for the order.

ShipStation is able to determine if an order was placed as a gift.

ShipStation will import internal notes or order activity from the selling channel.

ShipStation will import notes left by the customer at time of checkout. Displayed as Customer notes in ShipStation's Legacy Layout.

ShipStation will import the total order weight from the selling channel.

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.

ShipStation will import item options (such as color or size) for each line item in the order.

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

Shopify Store Settings in ShipStation

Shopify marketplace settings popup.

You can enable the following options in the Shopify Store Settings in ShipStation:

  • Import Closed Orders

    When enabled, ShipStation will import orders in the Closed or Archived status from Shopify into the Shipped status in ShipStation. If this setting is not enabled, ShipStation will not import these orders from Shopify.

  • Shopify Discount Codes In Notes

    Enable this if your customers use discount codes with their orders and you want that discount code to appear in the order's Internal Notes in ShipStation.

  • Map "partially_paid" To Awaiting Payment

    When enabled, ShipStation will import Shopify orders in the Partially Paid status into the ShipStation Awaiting Payment status. If this setting is not enabled, Partially Paid orders will import into Awaiting Shipment instead.

  • Use a Ship From Location Inventory Source as the Location for Marketplace Notifications

    You can change the original Ship From Location to a different Ship From location inside of ShipStation (as long as that Ship From Location is connected to the appropriate Shopify order Source). When the label is created, ShipStation will notify Shopify to deduct inventory from the newly designated warehouse.

  • Map "authorized" to Awaiting Payment

    When enabled, ShipStation will import Shopify orders in the Authorized status into the ShipStation Awaiting Payment status. If this setting is not enabled, Authorized orders will import into Awaiting Shipment instead.

  • Custom Fields

    Shopify sends additional order details to ShipStation that are not mapped to a ShipStation field by default. If you need these details in ShipStation, you can map them to the ShipStation Custom Fields #1, #2, and #3.

    SET_STORE_Shopify_CustomFieldMapping_MRK.png

    Select the item you wish to map to a custom field from the drop-down menu and save your changes. Going forward, ShipStation will pull that data into the assigned Custom Field in ShipStation when the order imports (previously imported orders will not be affected).

    The following fields are available from Shopify to map in ShipStation:

    • Bill Address

    • Bill Name

    • Customer Tags

    • Fraud Risk

    • Order Count

    • Order Tags

    • Shopify Order ID

    • Total Spent

    • Total Spent - Total Price

    • Note Attributes

Additional Details about the Shopify Integration

  • Orders in Shopify have 3 different types of statuses: Order, Fulfilment, and Payment.

    • Order status can be Open, Archived, or Cancelled

    • Fulfilment status can be Fulfilled, Unfulfilled, Partially Fulfilled, Scheduled,and On Hold

    • Payment status can be Authorized *, Paid, Partially Paid**, Pending, Refunded, Unpaid, and Voided

  • Orders in the Authorized status will import as Awaiting Shipment by default. If you want ShipStation to treat Authorized orders as Awaiting Payment instead, please contact ShipStation support.

  • Partially Paid orders in an Open status will import into Awaiting Shipment by default. If you enabled the store setting Map "partially_paid" To Awaiting Payment those orders will instead import into Awaiting Payment.

  • If an order imports into Awaiting Payment from Shopify, the order status should update to Awaiting Shipment if the order is updated to Paid in Shopify (upon next store refresh).

  • A customer record will not be created if an order imports into Awaiting Payment (even if email is present). The customer record will be created after the order moves to Awaiting Shipment.

  • By default, ShipStation will ignore Shopify orders in the Closed or Archived status.

  • ShipStation cannot import orders while they are in the Draft status.

  • Updating On Hold orders: ShipStation will update orders in the On Hold status if changes are made to the order on Shopify. If expected changes do not appear in ShipStation after you have refreshed the store, contact ShipStation support to request they set your refresh date back to the date the change occurred and refresh the store again.

  • Shopify will only import orders with physical products into ShipStation.

  • Automatic Discounts: A discount applied at checkout that does not require the customer to manually enter a code at checkout. ‘Automatic Discounts’ from Shopify do not import into ShipStation. These discounts are a different type of discount than the ‘Discount Codes’ that would import as a line item. This difference may be why you see a discrepancy between Order Total and Amount Paid.

Shopify Troubleshooting Tips

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

Issue

How to troubleshoot or resolve

An order refunded in Shopify may still import into ShipStation if its order status hasn’t changed.

What to do: When you refund a Shopify order, you must also update its order status to Cancelled so the order will not import into ShipStation.

Shopify's subscription-based order placement not supported

ShipStation does not currently support orders placed using Shopify's new subscription-based order placement feature because this new feature causes confusion with mapping for the Requested Service.

While the Shopify orders will import, the orders placed through this new method cause Shopify to send us multiple Requested Service values with the order data. ShipStation can only display a single value for the Requested Service on any order.

SOLUTION 1: The best workaround is to map the newly displayed Requested Service value shown in the orders to use a particular service.

SOLUTION 2: If service mapping won't work for you, consider adding an Order Tag to these "subscription orders" in Shopify and mapping the Order Tags to a Custom Field through the Store Settings. This way, you can use an Automation Rule to assign services as needed.

A Shopify order is not importing into ShipStation

What it means: There are multiple reasons why a Shopify order would not import into ShipStation, but here are the most common:

  • No physical products in the order.

  • No Ship To address information for the customer.

  • Order is older than 90 days.

  • Order is still in Draft status.

  • The order does not require fulfilment, or is fulfilled by a third party.

What to do: In these cases, your best option is to update the order in Shopify, if possible. If you cannot update the order, ShipStation will be unable to import the order.

In addition, ShipStation by default does not import orders that are Closed or Archived. If you need to import Closed and Archived orders, enable the Import Closed Orders option in your Store Settings page.

After creating a label, ShipStation updated the Shopify order but only left a note with the tracking information and did not update it as fulfilled

What it means: This happens when ShipStation tries to create a fulfilment update for the Shopify order, but we receive an error from Shopify that the fulfilment could not be created for one of the following reasons:

  • The order is already fulfilled. ShipStation cannot create a new fulfilment for a Shopify order that is already fulfilled.

  • One or more Shopify products in the order are set to use a fulfilment service.

  • Your store is using Shopify's inventory management features, but the Ship From Location used to create the shipping label was not linked to the correct Shopify inventory source, or the product is out of stock. See Shopify Inventory for more information.

What to do: If this occurs, ShipStation will not be able to update the order as fulfilled. You may be able to update the order directly on Shopify.

This integration allows you to define the Status Mappings for the store connection.

ShipStation will import the customer's email address with the order and can send customer shipment confirmation and delivery emails, which are configured in your Store Settings.

ShipStation will import the customer phone number.

ShipStation will import the shipping method chosen by the customer at time of checkout.

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

ShipStation will import discount and coupon information for the order.

ShipStation is able to determine if an order was placed as a gift.

ShipStation will import internal notes or order activity from the selling channel.

ShipStation will import notes left by the customer at time of checkout. Displayed as Customer notes in ShipStation's Legacy Layout.

ShipStation will import the total order weight from the selling channel.

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.

ShipStation will import item options (such as color or size) for each line item in the order.

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