Overview
ShipHero is a cloud warehouse management and fulfilment platform for ecommerce brands and 3PLs. Order Editing has a direct integration with ShipHero that holds an order in the warehouse while your customer edits it, then releases it so ShipHero picks, packs, and ships the final order. Edits are supported live, right up until picking starts.
The warehouse only ever picks the final, edited order.
Edits are supported live, up until picking begins.
Works for single warehouses, multi-location setups, and 3PLs.
How it works
While an order can be edited, Order Editing holds it in ShipHero so the warehouse doesn't start picking it. When the editing deadline passes, or the order is fully paid, Order Editing releases the hold and ShipHero fulfils the final order.
ShipHero also tells Order Editing when picking begins. If the warehouse starts work early, the editing window closes automatically so the picked order and the customer's order always match.
Step 1: Add Order Editing as a developer in ShipHero
In ShipHero, open your Users page at app.shiphero.com/dashboard/users and add a developer user for Order Editing.
Generate an Access Token and a Refresh Token, and copy both.
On the Shiphero page in Order Editing, Get your access tokens opens the ShipHero Users page, and View tutorial shows a short video of this step.
Step 2: Connect ShipHero in Order Editing
In Order Editing, go to Integrations and open Shiphero.
In Authentication Keys, paste your Shiphero Access Token and Shiphero Refresh Token.
Select Save Shiphero tokens. Order Editing checks the tokens and registers the webhooks it needs automatically.
Turn on Use Shiphero integration. This switch is available once your tokens are saved.
To confirm the connection at any time, select Check status at the top of the page.
Step 3: Choose your hold behaviour
The two hold settings sit on the Shiphero integration page, under Use Shiphero integration:
Setting | What it does | When it's available |
|---|---|---|
Disable editing when Shiphero starts picking | Customers can edit until ShipHero assigns the order to a tote. The editing window then closes, so the picked order always matches. | After your tokens are saved. |
Hold orders until the editing deadline | Pauses orders in ShipHero until the editing deadline passes, then releases them. | Needs a time-based editing deadline. It can't be turned on when your deadline is custom or set by Shopify Flow. |
If Hold orders while they can be edited is turned on in your order hold settings, Hold orders until the editing deadline is switched on automatically and can't be turned off here. The page shows an Automatically enabled banner when this happens.
Step 4 (3PL): Warehouse operator settings
Select Advanced in the page navigation. It's available once ShipHero is connected.
Turn on Enable settings for warehouse operators (3PL).
Enter your 3PL Name and Customer ID.
Advanced also shows whether the Tote Cleared and Tote Complete webhooks were found, and lists any orders Order Editing is currently holding in ShipHero.
Step 5 (multi-location): Location-specific accounts
Your Shopify locations are listed under Locations in the page navigation.
Select a location.
Turn on Enable Shiphero for this location.
If that location uses a different ShipHero account, select Override tokens and enter its tokens. Select Use default tokens to go back to your default tokens.
Troubleshooting
Orders are being picked before editing finishes
Turn on Hold orders until the editing deadline so the hold is placed as soon as the order arrives. If the setting is greyed out, check that your editing deadline is time-based rather than custom or Flow-based. Order Editing only releases holds it placed itself, so it won't interfere with holds your team adds manually.
Edits made after picking started aren't applied
With Disable editing when Shiphero starts picking turned on, the editing window closes the moment ShipHero assigns the order to a tote. Edits need to be made before then.
Multi-location orders aren't holding correctly
Check that each location is enabled and that its tokens are set correctly under Locations.
Common questions
Does this support live edits?
Yes. Because the integration connects directly to ShipHero, customers can edit right up until the warehouse starts picking. Once picking begins, the window closes automatically.
Will it interfere with holds my team places in ShipHero?
No. Order Editing tracks the holds it places and only releases those. Any holds your team adds in ShipHero are left untouched.