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.

  • Admin credentials for your Shopify account, or Admin permissions given in Shopify.

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.

    Locate Your Store URL

    Log in to your Shopify store admin panel. Click on the View your online store icon to the right of Online Store in the Sales Channels section. This will open your store in a new window. Your store URL is displayed in the address bar of the new browser window.

    The Shopify admin panel displays the view your online store link, which is represented by an eye icon.
  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:

About Shopify Statuses

Shopify orders have three different types of statuses: Order, Fulfillment, and Payment. Please see the Additional Details section of this Shopify article for a full description.

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.

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.

Connects to Shopify's Inventory features

ShipStation can display Shopify's inventory stock count, and will reduce stock from the appropriate inventory location when ShipStation sends the shipment update to Shopify. See Shopify Inventory for more information.

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.

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.

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

Shopify Store Settings in ShipStation

Modify Marketplace Settings popup for a Shopify store

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

  • Import Harmonization Codes

    Enable this feature (on a per-store basis) to locate your Harmonized System (HS) Codes and import them into the order's customs declarations in ShipStation. Experience better compliance for cross-border shipping and trust that your packages won't get stuck in customs.

    If you set a 6-digit HS code for a product on Shopify’s side, we will auto-fill the customs section with HS codes when we import orders placed with that product. The item options will now include the Harmonization code in addition to options such as size and color attached to the SKU. There's no need to set this up separately 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.

  • Import in 'Buy With Prime' orders as Shipped

    For Shopify accounts that use the Buy with Prime feature - these orders by default do not import into ShipStation since they are automatically fulfilled by FBA. Enable this setting to import these orders directly into the Shipped status in ShipStation (this allows visibility of the order while preventing the possibility of double shipping).

  • 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.

    Shows Custom Field Mapping dropdown with arrow pointing to Customer Tag option

    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

  • Import Harmonization Codes from Shopify

    • The Harmonization System (HS) code will NOT be added to product defaults in ShipStation.

    • Shopify’s Import Harmonization Code feature overrides ShipStation's product information on the order. Customs Item Value and Country of Origin are exceptions to this override.

    • If you set  International Settings - Customs Declarations to Use Pre-Defined Values, ShipStation's International Customs Settings will override Shopify settings.

    • ShipStation only imports the 6-digit harmonization code. The 8-digit harmonization code is destination-specific, and will not import.

  • 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 the 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.

  • If an order imports into On Hold from Shopify, the item quantity will be set to 0 until the status changes to Awaiting Shipment. This can impact automation rules using Order Subtotal, Order Total, Order Weight, or Total Quantity as criteria. You can:

    • Manually rerun the rules when the order status changes

    • Update the rule to use different criteria for On Hold orders

  • 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.

  • If you are using Shopify's Inventory features, link the Ship From Location to a Shopify Inventory source so you can view your stock counts in ShipStation. See Shopify Inventory for more information.

  • 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 the Order Total and the 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

Shopify Store Status Error

If your Shopify store shows an Address Verification Error icon: white exclamation point inside a red circle., you can view the error by hovering over the Update all Stores button at the top of your screen and clicking on Error updating - see more.

In most cases, you will need to Reconfigure Your Shopify Store.

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.

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