ShipHero

ShipHero is a warehouse management service (WMS) used by many Order Editing merchants. ShipHero typically supports all of Order Editing's features and reads live edits made by customers, making it one of the most seamless integrations available.

Key feature: Direct API integration means real-time sync of order edits without complex Flow setups.

How ShipHero Integration Works

Unlike many other systems, ShipHero integrates directly with Order Editing through API keys. This allows:

  • Real-time order edit sync - Changes appear immediately in ShipHero

  • Automatic order holds - Orders stay editable until the grace period ends

  • Prevention of picked orders being edited - Order Editing can see if an order is already being picked and will block edits

Setting Up ShipHero Integration

Step 1: Add Order Editing as a Developer User in ShipHero

Important: Order Editing requires a developer user on your ShipHero account to function properly. This allows Order Editing to:

  • Read information about your ShipHero orders

  • Ensure edits cannot be made after orders are picked

  • Sync changes in real-time

How to Create Developer User:

  1. Log in to your ShipHero account

  2. Follow the tutorial video in the ShipHero integration settings within Order Editing

  3. Navigate to Order Editing > Settings > Integrations > ShipHero

  4. Watch the step-by-step tutorial video provided

You will receive two tokens:

  • Access Token

  • Refresh Token

Important: Save these tokens—you'll need them in the next step.

Step 2: Enter API Tokens in Order Editing

Once you've created the developer user in ShipHero, import the API keys into Order Editing:

  1. Navigate to Order Editing > Settings > Integrations

  2. Select ShipHero

  3. Enter your Access Token in the first field

  4. Enter your Refresh Token in the second field

  5. Click Save

Step 3: Enable ShipHero Integration Options

AFTER entering your API tokens, you can now enable the ShipHero integration features:

  1. In the ShipHero integration settings

  2. Toggle ON the following options:

  3. Enable ShipHero integration

  4. Sync order edits to ShipHero

  5. Click Save

Why wait? The API tokens must be validated before enabling integration features, or the connection won't work properly.

Multiple Warehouse Setup

If You Have More Than One WMS

If your business uses ShipHero alongside other warehouse systems, you can specify which warehouse locations should use the ShipHero direct integration.

How to Limit Integration to Specific Locations:

  1. In ShipHero integration settings

  2. Locate "Limit the ShipHero integration to specific locations"

  3. Select the warehouse(s) that use ShipHero from the dropdown

  4. Leave other warehouses unselected (they'll use different integration methods)

  5. Click Save

Example scenario:

  • Main Warehouse (California) → Uses ShipHero → Select this location

  • Backup Warehouse (Texas) → Uses different WMS → Don't select this location

Shipping Method Upgrades

Enabling Post-Purchase Shipping Upgrades

If you want to allow customers to upgrade their shipping method after purchase (e.g., Standard to Express), you need to configure ShipHero to recognize shipping changes.

How It Works:

  1. Customer upgrades shipping during editing window in Order Editing

  2. Order Editing tags the order with a shipping upgrade indicator

  3. ShipHero reads the tag through its automation rules

  4. ShipHero applies the appropriate shipping method automatically

Setup Required in ShipHero:

You need to map shipping titles in ShipHero using their automations to recognize Order Editing's shipping upgrade tags.

Steps to Configure:

  1. Log in to ShipHero

  2. Go to Settings or Automations

  3. Create automation rules that:

  4. Detect Order Editing shipping upgrade tag

  5. Map those tags to corresponding ShipHero shipping methods

  6. Save your automation rules

Tip: Contact ShipHero support for assistance with creating these automation rules if needed. They can help you map your specific shipping methods correctly.

Shopify Flow: ON-HOLD Master Flow

Recommended Flow for ShipHero

When using ShipHero, we recommend uploading the ON-HOLD Master Flow instead of other Flow types. This Flow is more reliable with ShipHero because the API key constantly refreshes the fulfillment status in real-time.

How to Set Up ON-HOLD Master Flow:

  1. Navigate to Shopify Admin > Apps > Shopify Flow

  2. Create or import the ON-HOLD Master Flow template

  3. Configure the Flow to match your editing deadline (e.g., 30 minutes)

  4. Activate the Flow

Important Settings Summary

In Order Editing:

  • ShipHero API tokens entered: Access Token & Refresh Token

  • ShipHero integration: Enabled

  • Specific locations selected (if using multiple warehouses)

  • Editing Deadline: Configured in Order Editing Settings

In ShipHero:

  • Developer user created for Order Editing

  • (Optional) Shipping method automation rules configured for upgrades

Testing Your Integration

How to Test:

  1. Place a test order on your Shopify store

  2. Check ShipHero immediately:

  3. Order should appear but be marked as "ON HOLD" or similar status

  4. Should NOT be available for picking yet

  5. Make edits to the order:

  6. Add items, change quantities, update address

  7. Verify edits appear in ShipHero in real-time (within seconds/minutes)

  8. Wait for editing period to expire (e.g., 30 minutes)

  9. Check ShipHero again:

  10. Order should now be available for picking

  11. All edits should be reflected correctly

  12. Verify order cannot be edited after picking starts in ShipHero

Troubleshooting

Issue: API Tokens Not Working

Problem: Error message when entering tokens or integration won't enable

Solutions:

  1. Verify tokens were copied correctly (no extra spaces or missing characters)

  2. Confirm developer user was created properly in ShipHero

  3. Check that developer user has correct permissions

  4. Generate new tokens in ShipHero and re-enter them

  5. Contact ShipHero support to verify developer access is active

Issue: Edits Not Appearing in ShipHero

Problem: Changes made in Order Editing don't sync to ShipHero

Solutions:

  1. Verify API tokens are entered and integration is enabled

  2. Check that ShipHero integration options are toggled ON (Step 3)

  3. Confirm order is within editing window timeframe

  4. Test with a new order to see if issue persists

  5. Check ShipHero API connection status in integration settings

Issue: Orders Available for Picking Too Early

Problem: Orders appear ready to pick in ShipHero before editing window ends

Solutions:

  1. Verify ON-HOLD Master Flow is active in Shopify Flow

  2. Check that Flow timing matches your editing deadline

  3. Confirm Flow is applying hold status correctly

  4. Test Flow with a new order

Issue: Shipping Upgrades Not Working

Problem: Customer changes shipping method but ShipHero doesn't recognize it

Solutions:

  1. Verify shipping automation rules are configured in ShipHero

  2. Check that Order Editing tags are being applied to orders

  3. Confirm tag names in ShipHero automations match Order Editing's tags

  4. Contact ShipHero support to verify automation rules are set up correctly

Issue: Orders Stuck After Editing Period

Problem: Orders remain on hold and don't release for picking

Solutions:

  1. Check that ON-HOLD Master Flow is removing hold status after grace period

  2. Verify Flow is completing successfully in Shopify Flow dashboard

  3. Manually remove hold status for stuck orders

  4. Review Flow configuration and timing

FAQ?

How do we integrate?

What is Shopify Flow?

PreviousCIN7 OMNINextJames & James

Last updated