Set Up Your ShipHero Integration

Overview

AfterShip Returns and ShipHero integration is a two-way integration designed to perform the following actions on both platforms.

1. Create an RMA request within ShipHero when a return is initiated and approved through the AfterShip Returns admin
2. Trigger an automated action within AfterShip Returns based on the return status updates in ShipHero

What you’ll learn

In this article, we will show you:

• How it works
• Integrate ShipHero with AfterShip Returns
• Configure warehouse location in return routing rules
• Returns workflow
• FAQs

How it works

The integration leverages AfterShip Returns’ Webhook feature to create returns in ShipHero as soon as an RMA request is created and approved in AfterShip Returns.

When the warehouse receives the items, and the return status is updated in ShipHero, the integration uses ShipHero’s Webhook feature to auto-mark return requests as received in AfterShip Returns admin.

Integrate ShipHero with AfterShip Returns

1. Go to ** Apps ** in AfterShip Returns admin
2. Click View more apps, and you will be redirected to the AfterShip Returns integration page.

3. Find ShipHero and select it to land on the detailed integration page

4. Select AfterShip Returns from the dropdown and then click Install app
5. Select the right organization (online store) if you have multiple organizations configured in AfterShip Returns (Optional) for which you are establishing this integration
6. To install the ShipHero app, you need to fill in your ShipHero username and password to authenticate the connection

7. Click Install app

Configure warehouse location in return routing rules

Since this integration will auto-trigger a response in AfterShip Returns admin once all the items reach ShipHero’s warehouse location, you must configure the warehouse location to ShipHero in Return routing rules for an auto-return label generation.

1. Go to ** Return routing rules ** in the AfterShip Returns admin
2. Select a return zone for which you wish to enable this return shipping method
3. Add a new routing rule or edit an existing routing rule
4. Navigate to Ship with a return label - Auto-generate return labels under the Return shipping methods.
5. While setting up return shipping information for auto-return label generation, select ShipHero warehouse from the dropdown under Return location

6. Save the changes

When will the RMA requests be marked as received automatically?

• The RMA request will be marked as received as soon as all the products for which the return request is submitted are received by the ShipHero warehouse
• If Auto-mark as received is enabled in AfterShip Returns and ShipHero is selected as the Warehouse location under Return routing rules, the RMA request will be marked as received as soon as all the products for which the return request is submitted are received by the ShipHero warehouse
• Auto-mark as received automation rule will be only triggered if all the products for which the return request is submitted are received by ShipHero.

Returns workflow

1. The customer submits a return request to AfterShip Returns
2. Merchant approves the RMA in AfterShip Returns

3. AfterShip Returns Webhook fires the return event to ShipHero

4. RMA is created in ShipHero using AfterShip Returns’s Webhook Data

5. The ShipHero warehouse receives the return package and updates the return status in ShipHero
6. ShipHero Webhook fires the return event to AfterShip Returns
7. AfterShip Returns auto-mark the return request as received based on ShipHero’s Webhook Data

8. Return request is resolved in AfterShip Returns

FAQs

1. Are newly created exchange orders put "on hold" in ShipHero untill they are marked as received?

AfterShip witnesses three scenarios on how exchange orders are created.

1. For the Replace with the same item orders, an exchange order is created when you click on the Create Shopify order on the RMA detail page or if the Auto-create replacement order is enabled. You have the option to create an exchange order when you see fit eliminating the necessity of putting them on hold.

2. For the Exchange with other items orders placed via Stripe checkout too, you can decide when you want an exchange order to be created, so there is no need to put them on hold.

3. For the Exchange with other items orders placed via Shopify checkout, an exchange order is created right after the return request is successfully submitted from the AfterShip Returns page. To provide merchants with the option to put these orders on hold untill they are marked as received, they can set up a flow in Exchange on your store or Exchange on AfterShip returns page settings > Order fulfillment control. You can conveniently select when do you want the orders to go from On hold to Unfulfilled in Shopify based on the available triggers.

AfterShip Returns' integration with ShipHero does not automatically create an exchange order in ShipHero. The exchange order will be synced from the customer's Shopify store to ShipHero. Therefore, if the order is on hold in Shopify, it will be on hold in ShipHero too.

2. Should merchants process return packages in ShipHero or in AfterShip?

AfterShip Returns' integration with ShipHero ensures syncing the item receiving status from ShipHero. This means that when a user receives returned packages in ShipHero, our system will sync the event and mark the item as received on the RMA.

3. Not seeing an RMA created in ShipHero?

AfterShip syncs the RMA data to ShipHero using the return location mentioned on the return label of the RMA. This means the integration works only when the return method of the RMA is Ship with a return label, and the label must be generated within AfterShip Returns using our carrier integration.

For any further questions or help, please contact our chat support team or reach out to us at support+returns@aftership.com.

Updated on: 15/04/2025