How to Set up uShip In-Home Delivery

Overview

uShip provides a straight-forward, high-quality option for nationwide in-home furniture delivery services via a set of carefully vetted carrier partners. By connecting your ShipperHQ account to uShip you’ll be able to offer real-time rating for In-Home Furniture Delivery on your eCommerce site. On some eCommerce platforms, you can also create uShip listings automatically or manually using ShipperHQ to help ensure a seamless end to end experience for you and your customers.

Learn more about uShip In-Home Delivery on the ShipperHQ Marketplace.

Note: ShipperHQ currently only supports uShip rating for their In-Home Furniture Delivery service.

Requirements

Platform

uShip Rating functionality is available on any platform platform supported by ShipperHQ! With this capability, you can offer your customers who are purchasing furniture uShip In-Home Delivery with real-time rates.

uShip Listing functionality is currently supported for Magento 2. You must be using version 20.30.0 or higher of the ShipperHQ Magento 2 extension. No additional modules are required beyond the standard ShipperHQ extension.

uShip Account

If you don’t yet have an account with uShip, sign up for a uShip In-Home Delivery account. You will need your uShip username and password to connect ShipperHQ to your uShip account.

Dimensional Rules

In order to use the uShip In-Home Delivery carrier in ShipperHQ you will need to have the ShipperHQ Dimensional Rules Advanced Feature enabled. uShip requires that ShipperHQ sends the dimensions of the products being shipped to retrieve real-time shipping rates.

Setting Up Your Products

If you sell a mixture of furniture and non-furniture items, it’s important to ensure that a uShip rate is retrieved only when customers are purchasing furniture. This can be accomplished using Shipping Groups.

You will also need to ensure that all products which will be using uShip for rating are configured with dimensions in your eCommerce platform’s product catalog.

Creating the Carrier

Rating Configuration

Once you have your uShip API credentials, you can set up the uShip In-Home Delivery carrier in ShipperHQ.

  1. In your ShipperHQ Dashboard in the Marketplace, select uShip and click the “Install & Validate” button
  2. Review the required validation details and, when ready, click Continue
  3. Enter your uShip account Username and Password
  4. ShipperHQ will attempt to connect with uShip to validate your credentials and indicate if validation is successful
    1. If unsuccessful, review the validation error message and, when ready, click Try Again to adjust the details you entered and attempt to validate again
    2. If successful, you’ll see a green success message. Click “Configure This Carrier” to configure your uShip carrier settings
Note Successful installation depends on the accurate entry of the account details required by the carrier. If you experience any issues validating your carrier, confirm that the credentials you’re using are correct.

Creating uShip Listings

When a customer completes checkout on your site for an item eligible for uShip In-Home Delivery, the next step is to create a uShip Listing. While you can always create a listing yourself at uShip.com, you can optionally choose to have ShipperHQ automatically create listings for you or create them yourself via your ecommerce platform. See the steps below for more information.

Once a listing has been created, you can log into your uShip account and see the automatically created listings. From here, you can manage them further from within the uShip dashboard. Contact uShip directly if you have any questions about how your listing, how to edit or update certain details, or the uShip shipping process in general.

uShip Listing functionality is only supported for Magento 2. See Requirements for more details.

Automatic Listing Creation

With this option enabled, ShipperHQ will automatically create a listing on uShip if a customer chooses uShip In-Home Delivery at checkout. Once the customer finishes checkout and an order is created, the ShipperHQ extension will use the product and order details to immediately create the listing.

If your customer does not select uShip at checkout but you still wish to create a uShip Listing for an order, you can do this using the “Create uShip Listing” button under Shipping Details on the Order. For example, if you offer Free Freight to some customers and don’t specify uShip as the service, you can still create a uShip listing. See Manual Listing Creation below for more details.

Enabling Automatic Listing

  1. Edit your uShip carrier in ShipperHQ and select the Listing tab
  2. To enable automatic listing, change the Create Listing setting to “List automatically on order placement”
  3. Save the carrier
  4. Within Magento, synchronize with ShipperHQ to enable the automatic listing creation.

If the listing successfully created, you will see “uShip Listing Created” followed by the uShip Listing ID under Shipping Details on the Order. Clicking on the Listing ID will take you directly to that listing on uShip.

If unsuccessful, you will see “uShip listing failed” to indicate the listing was not successful. See Troubleshooting Listing Creation for more details on why this might happen and how to correct issues around listing. Once you’ve corrected any issues that may have caused listing to fail, you can manually create the listing using the “Create uShip Listing” button on the Order under Shipping Details allowing you to Manually Create a Listing. See Manual Listing Creation below for more details.

Manual Listing Creation

With this option enabled, ShipperHQ will not automatically create uShip listings but you will have the option to create a listing for an Order using the “Create uShip Listing” button under Shipping Details.

Enabling Manual Listing

  1. Edit your uShip carrier in ShipperHQ and select the Listing tab
  2. To enable manual listing, change the Create Listing setting to “Create listings manually”
  3. Save the carrier
  4. Within Magento, synchronize with ShipperHQ to enable listing creation.

Creating a Listing

  1. On an Order which you wish to list on uShip, click the “Create uShip Listing” button under Shipping Details on the Order
  2. You’ll be given the option to adjust what products you wish to list by unchecking or changing the quantity of products in the order
  3. When you continue, you’ll see the amount charged for shipping to the customer as well as a real-time rate from uShip for the products you’ve chosen to list
  4. After confirming, you’ll be shown a success message and the uShip Listing ID. Clicking on the Listing ID will take you directly to the listing on uShip

Once the listing has been created, you’ll now have the uShip Listing ID under Shipping Details on the Order. Only one listing can be created via this process per order. If you only list part of an order initially and wish to list additional items subsequently, you can create a listing directly at uShip.com.

If listing failed, see Troubleshooting Listing Creation for more details on why this might happen and how to correct issues around listing. Once you’ve corrected any issues that may have caused listing to fail, you can attempt to create the listing again following the same steps described above.

Troubleshooting Listing Creation

The most common reason for listing creation failing is that your products do not have dimensions set on them in your product catalog. Note that you may have received a uShip rate if you have a default box set up on your uShip carrier in ShipperHQ even if your products do not have dimensions set on them in your catalog. However, in order to successfully create a listing you will need to ensure that all products being listed have dimensions set on them.

If the ShipperHQ logger is enabled, details of the listing call will be logged out there. This will include any errors that may be returned if listing creation is not successful.

Was this doc helpful?