Integration With ShipHero

Last Updated: January 20, 2025

ReturnGO integrates with ShipHero to help you receive and process returned products and adjust stock levels as necessary.


ShipHero is a warehouse management system that helps you sync restocking, receiving of packages, and available inventory levels with your ReturnGO account and online store.

Capabilities 

The ShipHero-ReturnGO integration supports:

  • Automatic creation of a return record in ShipHero when a return request is approved on ReturnGO and a return label is issued.
  • Reporting of returned item inspection results from ShipHero back to ReturnGO. 

Requirements 

To link your ShipHero account to ReturnGO, you will need: 

  • ShipHero Refresh Token

To get your ShipHero Refresh Token:

  1. In your ShipHero account, go to My Account > Developer Users.
  2. Click on ADD A 3RD PARTY DEVELOPER on the top right side of the page.

Shiphero

 3. Fill in the details and click ADD DEVELOPER.

 4. Once the user has been created, the API Token will appear.

Linking your ShipHero Account to ReturnGO 

To link your ShipHero account to ReturnGO: 

  1. Go to Integration > Products & Services
  2. Click on +ADD PRODUCT OR SERVICE. 
  3. Choose ShipHero from the drop-down list. 
  4. Click on the check mark.
  5. Enter your credentials. 
  6. Click CONNECT. 

Configuring Field Mapping for Sales Credit

You can upload a JSON config file to map the required fields for fetching details in ShipHero. This enables you to configure the specific data you want ReturnGO to transmit to ShipHero.

Note: This is particularly useful for more advanced users who have a developer and need to customize the information sent to ShipHero.

Search Order By Field
You can use this property to define how orders are fetched on ShipHero, using either order ID or Order Name.

Available values for this field:

  • orderId - Fetch by Order ID
  • orderName - Fetch by Order Name

File Structure

Here's an example of the structure of the JSON file:

{

    "searchOrderByField": "orderId"

}

OR

{

"searchOrderByField": "orderName"

}

Note: If no config is added to the integration, the default is to fetch orders by Order ID.

Uploading the Config File

To upload the config file:

  1. Go to Settings > Integrations > Products & Services.
  2. Open the ShipHero integration box
  3. In the Create RMA Config in JSON Format field, paste the contents of the config file.
  4. Click on the save icon to confirm.

ShipHero-Related Issues 

For ShipHero-related issues, please contact ShipHero customer support.

For any other issues, feel free to contact ReturnGO support through chat or email.