Articles in this section

Connecting a WooCommerce Store to ShipHero

Updated

WooCommerce is one of the many online eCommerce platforms that integrates with ShipHero. This article will walk you through the basic steps related to setting up your WooCommerce store in ShipHero.

Table of Contents

Prep Your WooCommerce WordPress Site

Before connecting your WooCommerce store to ShipHero, you will need to enable WordPress permalinks and obtain a REST API Key. Instructions on how to do this are below.

Enable WordPress Permalinks

  • Log in to your WordPress Admin Panel and go to Settings > Permalinks
  • Make sure that your WordPress Permalinks are set to Post Name:

    3_e1d7948e-015f-498a-8fa9-0e8be62f84a4.png

Generate a WooCommerce REST API Key

  • Login to your WordPress Admin Panel
  • Go to WooCommerce > Settings > Advanced > REST API
  • Select Add Key. You are taken to the Key Details screen.

    4_restapi-addkey.png
  • Add a Description.
  • Select the User you would like to generate a key for in the dropdown.
  • Set permissions to Read/Write.
  • Select Generate API Key.
    5_api-keydetails.png

Enable the Legacy REST API

  • Go to WooCommerce > Settings > Advanced > Legacy API
  • Click the Enable the Legacy REST API checkbox
  • ShipHero uses the Legacy V3 API version, the latest by default. We can connect a store that uses V2 API, though be aware that WooCommerce and ShipHero will deprecate it eventually.  

Connect WooCommerce to ShipHero

Once a REST API key has been obtained and the Legacy REST API has been enabled on your WooCommerce store, then you are ready to connect your store to ShipHero!

Screenshot 2024-02-28 at 10.07.00 AM.png

  • Click Add a New Store on the right hand side of the screen and select WooCommerce

Screenshot 2024-02-28 at 10.09.02 AM.png

  • Give your store a name, enter your Consumer Key, Secret, and the URL for your store, then click Connect.

Screenshot 2024-02-28 at 10.09.58 AM.png

We recommend subscribing to WooCommerce's Shipment Tracking plugin so that tracking information is provided to customers. If you have the plugin installed, you can disable the Add Tracking Number to Customer Notes option to prevent multiple notifications being sent to the customer.

How to Map Statuses Between WooCommerce & ShipHero

In WooCommerce, you have different order statuses that you can use. You can tell ShipHero what these statuses mean and how the application should handle each of the statuses.

How to Map Statuses

  1. Go to https://app.shiphero.com/dashboard/stores.
  2. Select the store name and then Map Statuses.

Map Status Examples

  • Set the status Pending to "Do Not Import" so that orders that are awaiting fulfillment in WooCommerce won't be imported into ShipHero until the status changes to something you want to be imported.
  • Set the status Awaiting Payment to "Import" into ShipHero, but under the Order Hold option choose "Payment Hold" so that the order is not fulfilled until the payment clears.
  • You can also map any WooCommerce status to a custom status that you created in ShipHero.
Was this article helpful?
11 out of 19 found this helpful

More Resources

  • ShipHero Public API

    Connect your tools and AI agents directly to ShipHero with the Public API. Build powerful integrations, automate workflows, and tap into real-time data using the AI tools you prefer, with the option for secure, read-only access for AI-driven insights without added risk.

  • ShipHero Academy

    Explore ShipHero Academy for certifications, deep-dive training, and expert-led courses on WMS and fulfillment. Build your expertise and help your team operate at a higher level.

  • Change Log

    Stay up to date with the latest improvements across ShipHero. The Change Log gives you a clear view of new features, enhancements, and fixes as they roll out—so you always know what’s new and what’s better.