Shopify Integration Guide

The following guide outlines how to set up, integrate, and use the uShip Shopify app for seamless shipping.

Getting Started

The Shopify app provides check-out rates or the potential for free/fixed price shipments for big and bulky furniture or similar items. This plug-in does not work for LTL, Freight, or customers with many different irregular SKUs. Stores with a regular inventory of furniture or similar items would be an ideal fit. For more details please contact uShip at apisupport@uship.com.

Prerequisites

Each implementation of the uShip app may differ based on your particular use case. However, as a general rule, you must have:

• A Shopify Store

  • With CCS (Carrier Calculated Services) enabled. Please reach out to Shopify support before installing the app to ensure that CCS is enabled. Here is a link to Shopify's article regarding CCS

• A link to the unlisted uShip app

• A location set on your store

• Product Metafields created for Length, Width, Height

  • Setup Video

• Products with a title, description, price, weight and dimensions

• uShip Rate Provider set as a rate provider within a Shipping Profile

It should be noted that the app may not function properly if installed alongside any proprietary product inventory management apps. uShip's Shopify integration currently only supports shipments within the United States.

Installing the uShip App

Log in to your Shopify store to get started. Once logged in:

1. Download the unlisted uShip app with the link provided by your uShip contact.
2. Select Install on development store from the App actions dropdown menu.
3. Choose your store from the Select a store dropdown in the pop-up window. You will then be brought to a grant permissions screen.
4. Click Install unlisted app.
5. Navigate HERE to generate the API Key needed to connect your uShip account.
6. Copy API Key, paste into space for "Access Key" and click "Submit"

You can now go to the Apps page and click the uShip app to login to configure your location and products for shipping.

Creating Metafields

Both new products and existing products can be configured for uShip. However, every product must have a price, weight and size dimensions (length, width and height) as well as the SKU or variant ID added to be eligible.

Creating New Metafields

1. In Shopify Admin, go to Settings > Custom Data > Products > Add Definition

   1. You will create separate Definitions for Length, Width, and Height

2. Set Name

   1. Suggest using Length, Width, or Height

3. IMPORTANT: Edit Namespace and Key

   1. Example: uship.length, uship.height, uship.width
   2. If this isn't set correctly the dimensions won't fetch at time of checkout and no rate will be returned

4. Select Type: Dimension

5. Click Save

Editing existing products

1. Click the product you’d like to make eligible from your Products screen.
2. Click More actions > Edit Shipping Properties. Add the length, width and height fields as well as the SKU and variant ID.
3. Return to your inventory and repeat as needed for other products.

Editing existing products in bulk

If you have a significant volume of products, preparing them for the uShip app in bulk may be a better option. Please note that when uploading the bulk .csv file, the column headers cannot be changed.

To edit product values in bulk:

1. Click Apps > uShip from your store page.
2. Click Export CSV. Open the downloaded .csv file. From here, you can make edits to the title and dimensions of your existing product catalog.
3. Save the .csv when completed.
4. Upload your edited .csv file from the same page with the *_Import CSV *_button.

You will receive a success message detailing the number of successfully updated products. If errors are present on some lines, the lines without errors will still be updated.

When doing bulk upload, the .csv file supports values for multiple boxes in the event that your shipment may be split into several packages to be assembled later. Each product can only have up to 20 boxes.

Adjusting uShip Settings

The settings for the uShip app can be configured by clicking Apps > uShip > Settings.