Shopify / YRC LTL Freight

/Shopify / YRC LTL Freight
Shopify / YRC LTL Freight2018-11-12T11:50:49+00:00

 

LTL Freight Quotes

YRC Freight Edition for Shopify

YRC Freight is a holding of YRC Worldwide Inc. (NASDAQ: YRCW) and is headquartered in Overland Park, Kansas. YRC Worldwide has a comprehensive network in North America, and offers shipping of industrial, commercial and retail goods. If you don’t have a YRC Freight account number, contact them at 800-610-6500.

Basic Plan $15/month

Retrieves your negotiated LTL freight rates.

Supported origins: Canada, United States.

Supported destinations: Canada, United States.

Customize the text used to label quotes displayed to shoppers.

Elect to display the carrier’s transit time with the rate estimate.

Define multiple warehouse locations.

Identify products that drop ship from vendors.

Basic option for residential delivery.

Basic option for lift gate delivery.

Mark up quotes by a dollar amount or percentage.

Assign products and variants a shipping weight, freight class and optionally dimensions.

Access to a built in density calculator.

Dynamic presentation of parcel and LTL freight rates with the installation of compatible apps from Eniture Technology

Standard Plan $20/month

Everything in the Basic Plan, plus…

Automatic detection of residential addresses allows the carrier’s residential delivery fee to be automatically included in quotes.

Option to require lift gate delivery when a residential address is detected.

Allow customers to choose between a standard option for LTL freight and one that includes lift gate delivery.

Do not display rates if a post office box is detected.

Support for products that ship hazardous material.

Advanced Plan $40/month

Everything in the Standard Plan, plus…

Offer options for in-store pick up and local delivery.

Current version: 1.0

Requirements

A Shopify account with the Real-Time Carrier Shipping feature enabled. The feature is standard on the Advanced Shopify subscription package. It can be added to other packages by contacting Shopify customer service.

Your YRC Business ID. Refer to the documenation on how to retrieve this.

Your username and password to YRC.com.

FAQ’S

How do I get this application?

This application can only be installed from the Shopify App Store. Click here to locate the app in the Shopify App Store and then click the GET button to install the app. You must have the Shopify store owner credentials to perform the installation.

How do I get a YRC Freight account number?

Call YRC at 800-610-6500.

Where do I find my YRC username and password?

Follow these links to the Forgot Your Password page, or the New User Registration page

Why are the shipment charges I received on the invoice from YRC Freight different than what was quoted by the plugin?

Common reasons include a difference in the quoted versus billed shipment parameters (weight, dimensions, freight class), or additional services (such as residential delivery) were required. Compare the details of the invoice to the shipping settings on the products included in the shipment. Consider making changes as needed. Remember that the weight of the packing materials is included in the billable weight for the shipment. If you are unable to reconcile the differences call YRC Freight customer service for assistance.

Why do I sometimes get a message that a shipping rate estimate couldn’t be provided?

There are several possibilities:

The most common reason is that one or more of the products in the shopping cart did not have its shipment parameters (weight, dimensions, freight class) adequately populated. Check the settings for the products on the order and make corrections as necessary.

The city entered for the shipping address may not be valid for the postal code entered. A valid City+State+Postal Code combination is required to retrieve a rate estimate and Shopify does not perform this level of address validation. Contact us by phone (404-369-0680) or email (support@eniture.com) to inquire about solutions to this problem.

Your shipment exceeded constraining parameters of YRC Freight’s web service.

The shipment destination isn’t serviced by YRC Freight.

The YRC Freight web service isn’t operational.

Your YRC Freight account has been suspended or cancelled.

There is an issue with the Eniture Technology servers.

Your subscription to the application has expired because payment could not be processed.

There is an issue Shopify’s servers.

How do I determine the freight class for my product(s)?

The easiest thing to do is to contact your YRC Freight representative and ask for assistance. However, the official source is the National Motor Freight Classification (NMFC) directory maintained by the National Motor Freight Transportation Agency (NMFTA.org). You can purchase a hard copy of the directory or obtain an online subscription to it from their web site.

How does the density calculator work?

The density calculator will calculate a freight class by performing a calculation using the product weight and dimensions as inputs. In most cases the returned freight class will match the product’s (commodity’s) freight class as recorded in the National Motor Freight Classification (NMFC) directory. However, this is not always true and in the event there are differences, the freight class recorded in the National Motor Freight Classification (NMFC) directory takes precedence. An incorrectly identified freight class can result in unexpected shipping charges and even fees. You are solely responsible for accurately identifying the correct freight class for your products. If you need help doing this, contact your YRC Freight representative for assistance.

 

User’s Guide

To use these instructions you must be logged into Shopify as the store’s administrator, or with a login that has administrative privileges.

Setting up the application to display LTL freight quotes consists of five steps:

Other information contained in this guide:

 

1. Prepare Shopify to use the application.

Return to top.

You must have the Real-Time Carrier Shipping feature on your Shopify plan to have live carrier quotes displayed in the checkout process. It is standard on the Shopify Advanced plan and can be added to other Shopify plans by calling Shopify Customer Service.

Navigate to the Settings>Shipping page. Scroll down to the Zones and rates section. If you don’t have a domestic shipping zone defined, click on the Add shipping zone link and then enter a zone name (i.e. “Domestic”).

add-shipping-zone

If you already have a domestic zone defined, click the Edit link to the right of the zone name.

Scroll down to the Carrier-calculated rates section. Click the Add rate button. Choose the carrier from the Select a carrier drop down. Click the Done button.

add-carrier-rate

You may see a message underneath the app name in the Carrier-calculated rates section afterwards, informing you that there are no available services for the countries you’ve selected. Don’t be concerned. You’ll set this up in the app preferences.

The app supports shipments to Canada. If you plan to ship orders to Canada, define a separate shipping zone for Canada and add the app to it using the same steps described above.

 

2. Obtain a YRC business ID.

Return to top.

To successfully connect the app to YRC Freight you need a YRC Business ID. If you don’t have one, sign into YRC.com, click on for Resources and then click on the link for Application Programming Interface (API).

You’ll be delivered to the Application Programming Interface (API) page. Scroll down until you see the list of YRC Freight APIs and click on the entry for Rate Quote API

The page will expand to display instructions. Click on the link in the second paragraph with the text Complete and fax a non-disclosure agreement

At the top of the non-disclosure agreement, check the Other box and underneath it write in Implement Rate Quote API. Enter the date into the appropriate space in the first paragraph.

Complete the section at the bottom of the non-disclosure agreement. Write in your storefront URL for the website that will host the API. Write in Rate Quote API as the requested API. The remainder of the form should be self evident.

Fax the completed non-disclosure agreement to the number listed at the top of the agreement. Within a week you should receive an email from YRC that contains an abundance of information, including your Business ID. (It may appear in the email as “BusID”.) Record the number and keep it handy. You will use it in the next step.

3. Choose the desired plan.

Return to top.

Begin by selecting Apps from the Shopify menu. Locate the entry for the YRC LTL Freight Quotes app and click on the app name to access the app preferences.

The Plans page is used to confirm the plan you are currently subscribed to, see the features offered on each plan, and to perform upgrades or downgrades according to your needs. The plan you’re currently subscribed to will have This is your current plan above the monthly subscription rate. To change plans, click on the desired plan’s monthly subscription rate. You must be signed into Shopify with the Store Owner credentials to change plans.

 

4. Connect the application to the YRC Rating API.

Return to top.

The Connection Settings page is used to establish the app’s connection to YRC’s web services. Enter the information prompted for, then click Save Settings. After the settings have been saved, click the Test Connection button. You will see a success message if your credentials validated. If not, correct them and try again.

Business Id Enter the Business ID you retrieved in Step 2 here.
Username The username you use to sign into YRC.com.
Password The password you use to sign into YRC.com
YRC rates my freight based on weight and… Choose freight class (default) or dimensions according to how YRC rates your LTL freight.

 

5. Identify your warehouse and drop ship locations.

Return to top.

The app supports warehouse and drop ship locations in the United States and Canada. Be advised that YRC typically doesn’t offer Canadian intra-provincial service (i.e. from Quebec to Quebec). If you anticipate the need for intra-provincial service, contact YRC customer service or your YRC sales representative and ask if intra-provincial rates can be added to your account.

Click the Add button in the appropriate sections to add warehouse and drop ship locations. Warehouses should have a complete inventory of all products not otherwise identified as drop shipped items. If you have more than one warehouse defined, the warehouse closest to the shopper will be used to retrieve shipping rate estimates.

Drop ship locations usually represent vendors that supply items that you don’t inventory. These items are shipped directly to your customer on your behalf. When an order includes drop shipped items, the shopping cart will display a single figure for the shipping rate estimate that is equal to the sum of the cheapest option for each shipment required to fulfill the order.

5a. In-store pick up settings

Return to top.

The Advanced Plan is required to use this feature. If you aren’t on the Advanced Plan the words Advanced plan required will appear adjacent to the settings header, and the fields associated with the feature will be inaccessible.

Click on the text Advanced plan required to upgrade your plan and gain access to the feature. You must be signed into Shopify with the Store Owner credentials to perform the upgrade.

In-store pick up can be offered as an option in the checkout process based the shopper’s postal code or proximity. It will only be offered if the feature is enabled and only one stocking location (warehouse or drop ship location) is involved in providing a quote. The settings for In-store pick up are visible on the page used to add or edit a warehouse or drop ship location.

Enable in-store pick up Check the box to enable the in-store pick up feature.
Offer if address is within (miles) The distance in miles within which you’d like to offer in-store pick up. The distance is route miles (driving distance). Leave blank if you don’t want to use distance to determine if in-store pick up should be offered. If both distance and postal codes are used as evaluation criteria, in-store pick up will display if either is satisfied.
Offer if postal code matches The postal codes to which you’d like to offer in-store pick up. Enter only the five digit ZIP Code for US addresses. Leave blank if you don’t want to use postal codes to determine if in-store pick up should be offered. If both distance and postal codes are used as evaluation criteria, in-store pick up will display if either is satisfied.
Checkout description The description to use to identify the option in the checkout process. The most obvious candidate is In-store pick up, but you can make it anything you’d like.

5b. Local delivery settings

Return to top.

The Advanced Plan is required to use this feature. If you aren’t on the Advanced Plan the words Advanced plan required will appear adjacent to the settings header, and the fields associated with the feature will be inaccessible.

Click on the text Advanced plan required to upgrade your plan and gain access to the feature. You must be signed into Shopify with the Store Owner credentials to perform the upgrade.

Local delivery can be offered as an option in the checkout process based the shopper’s postal code or proximity. It will only be offered if the feature is enabled and only one stocking location (warehouse or drop ship location) is involved in providing a quote. Local delivery can display as a free option or have a charge associated with it. Other shipping options provided by the app can be suppressed when local delivery is to be offered. The settings for Local delivery are visible on the page used to add or edit a warehouse or drop ship location.

Enable local delivery Check the box to enable the local delivery feature.
Offer if address is within (miles) The distance in miles within which you’d like to offer local delivery. The distance is route miles (driving distance). Leave blank if you don’t want to use distance to determine if local delivery should be offered. If both distance and postal codes are used as evaluation criteria, local delivery will display if either is satisfied.
Offer if postal code matches The postal codes to which you’d like to offer local delivery. Enter only the five digit ZIP Code for US addresses. Leave blank if you don’t want to use postal codes to determine if local delivery should be offered. If both distance and postal codes are used as evaluation criteria, local delivery will display if either is satisfied.
Checkout description The description to use to identify the option in the checkout process. The most obvious candidate is Local delivery, but you can make it anything you’d like.
Local delivery fee Enter the amount to charge for local delivery. Leave blank to offer local delivery for free.
Suppress other rates Check the box to show only the option for local delivery when the criteria for doing so (distance or postal code) is met. Leave unchecked to have local delivery offered in addition to the shipping options normally displayed by the app.

 

7. Choose the desired quote settings.

Return to top.

On this page you will choose the settings that will affect every LTL freight quote your shopper sees. Enter the information prompted for, and then click on the Save Settings button at the bottom of the page. This will conclude the application setup.

Label As Identify how you want the quote labeled in the checkout process. A common choice for this field is “LTL Freight” or “YRC Freight”. If left blank quotes will be labeled “Freight”
Show Delivery Estimate When checked, the carrier’s estimated transit time will be displayed.
Always Quote Residential Delivery When checked, the quote will always include the carrier’s residential delivery fee.
Automatically Detect and Quote Residential Delivery The Standard Plan or higher is required to use this feature. If you aren’t on the Standard Plan or higher the words Standard plan required will be displayed. Click on the Standard plan required text to upgrade your plan and gain access to the feature. You must be signed into Shopify with the Store Owner credentials to perform the upgrade.

Each order’s shipping address is referenced against a USPS database to determine if it is a residential address. If it is, the freight quote will automatically include the carrier’s residential delivery fee.

Always quote lift gate delivery When checked, every quote will include the carrier’s lift gate delivery fee.
Offer lift gate delivery as an option The Standard Plan or higher is required to use this feature. If you aren’t on the Standard Plan or higher the words Standard plan required will be displayed. Click on the Standard plan required text to upgrade your plan and gain access to the feature. You must be signed into Shopify with the Store Owner credentials to perform the upgrade.

When checked, an additional option will be presented to the shopper that will include the lift gate delivery fee. The shopper will be able to choose between options that exclude or include lift gate delivery.

Include lift gate delivery when residential delivery is detected The Standard Plan or higher is required to use this feature. If you aren’t on the Standard Plan or higher the words Standard plan required will be displayed. Click on the Standard plan required text to upgrade your plan and gain access to the feature. You must be signed into Shopify with the Store Owner credentials to perform the upgrade.

When checked, if a residential delivery address is detected the lift gate delivery fee will be included in the shipping rate estimate. In such cases, the option to Offer lift gate delivery as an option will be suppressed, even if enabled. Enabling both the Offer lift gate delivery as an option setting and the Include lift gate delivery when residential delivery is detected setting allows commercial customers to choose whether or not lift gate service is needed while always requiring it for residential customers.

Handling Fee / Mark Up Increases the amount of the quote by a specified amount prior to displaying it in the shopping cart. The number entered will be interpreted as dollars and cents unless it is followed by a % sign. For example, entering 5.00 will cause $5.00 to be added to the quote. Entering 5.00% will cause each quote to be multiplied by 1.05 (= 1 + 5%).
Do not return rates if the ship to address appears to be a post office box The Standard Plan or higher is required to use this feature. If you aren’t on the Standard Plan or higher the words Standard plan required will be displayed. Click on the Standard plan required text to upgrade your plan and gain access to the feature. You must be signed into Shopify with the Store Owner credentials to perform the upgrade.

When enabled the app will not return quotes when it detects that the address is a post office box. The identification of a post office box is performed by text string matches to “PO Box”, “P.O. Box” and a number of other probable representations. This method is not infallible or guaranteed. It will not interfere with the presentation of shipping methods by other apps.

 

7. Enter the product shipping parameters.

Return to top.

Now that the application settings have been established, it’s time enter the product settings. Repeat these instructions for every product that you want to ship LTL freight.

Select Products from the Shopify menu. Locate the product on the list and choose it by clicking on it. You will be delivered to the product’s details page. Click the More actions button at the top of the page to reveal the installed apps and select the app from the list.

You’ll be delivered to a page on which you will enter the product’s freight class, weight and dimensions. Enter the information prompted for, and then click the Save & Return button at the bottom of the page to return to the product’s Shopify product details page.

Quote as an LTL shipment Check this checkbox if you want LTL freight quoted when this product is in the shopping cart.
Freight Class Select the product’s freight class from the drop down list. You may also select Density Based from the list, which will calculate freight class on the fly using the product’s weight and dimensions. The density based calculation will return the correct freight class in most, but not all cases. You are solely responsible to identify the correct freight class of your product(s). If you need assistance, contact your UPS Freight representative or refer to the National Motor Freight Classification (NMFC) directory published by the National Motor Freight Transportation Agency (NMFTA.org).
Weight Enter the weight of the product in pounds. Fractions should be rounded up to the next whole number. It should include the weight of any packaging materials that may be required to ship the product, such as cardboard, pallets and shrink wrap.
Length Enter the length of the product in inches. Fractions should be rounded up to the next whole number. It should include any incremental inches added by packaging materials that may be required to ship the product.
Width Enter the width of the product in inches. Fractions should be rounded up to the next whole number. It should include any incremental inches added by packaging materials that may be required to ship the product.
Height Enter the height of the product in inches. Fractions should be rounded up to the next whole number. It should include any incremental inches added by packaging materials that may be required to ship the product.
Boxing Properties You may see a group of settings enclosed in a box labeled Boxing Properties. These settings are used by Eniture Technology’s Small Package Quotes apps for FedEx, Purolator, Unishippers, UPS and Worldwide Express. These apps are engineered to work in concert with the LTL Freight Quotes apps to ensure that the correct type of rates (parcel and/or LTL freight) are offered to shoppers. You can ignore these settings when provisioning the LTL Freight Quotes app. If you’d like to explore the Small Package Quotes apps, click this link.
Hazardous Material The Standard Plan or higher is required to use this feature. If you aren’t on the Standard Plan or higher the words Standard plan required will be displayed. Click on the Standard plan required text to upgrade your plan and gain access to the feature. You must be signed into Shopify with the Store Owner credentials to perform the upgrade.

Check this checkbox if this item must be identified as hazardous material. When checked, the carrier’s hazardous materials fee will be included in the quote if this item is present in the cart.

Drop ship this product Check this box if this item is drop shipped from a location other than your warehouse.
Drop ship location Select the drop ship location from the drop down. These locations are defined on the Warehouses tab in the app settings that was described in step 3.

 

What your customer sees.

Return to top.

Once you’ve completed the preceding steps, your Shopify store is ready to begin quoting LTL freight. Any time one or more products in the shopping cart are flagged as shipping LTL freight, all of the products are assumed to ship LTL freight as this will be more economical than splitting the shipment between two or more shipping methods. In the absence of a freight class, as may be the case for products not set up to ship LTL freight, the application will take advantage of any available information to ensure the return of an LTL freight quote if at all possible. To ensure the best possible outcome, it is highly recommended that the freight class, weight and dimensions be entered for every product you sell, even if they are not defaulted to ship LTL freight.

When LTL rates are displayed, the exact presentation will depend on the options selected in the Quote Settings.

 

What you see.

Return to top.

The app populates shipping related information in the Additional details widget on the Order Details page. The content of the widget falls into two categories: 1) Shipment Origin & Services; and 2) Shipment Content.

Shipment Origin & Services

This information block will identify the shipment origin, the selected carrier service and a list of any additional services (such as residential delivery) associated with the shipment. A separate Shipment Origin & Services information block will appear for each shipping location that will participate in fulfilling the order. This is particularly useful for stores with multiple warehouses and drop ship locations.

Shipment Content

A Shipment Content information block is presented beneath each Shipment Origin & Services information block. It identifies the products that were quoted as shipping from the location.

Updating products with the Import CSV Utility.

Return to top.
You can use the app’s Import CSV utility to enter or update the product shipping parameters. This method can be more time efficient than navigating in and out of the app’s user interface, particularly if you have a lot of products.

(View the 5 minute instructional video)

Navigate to the Import CSV tab in the app preferences.

Click the template link to download the CSV template file and open it in Excel or a similar application. Each row of the spreadsheet represents one of your products or product variants. The first two columns of the spreadsheet contain the Product ID and Variant ID. Do not remove these columns, they are crucial to the import process.

Eniture Technology publishes apps that provide quotes for Small Package (parcel) and LTL Freight. The file contains a column with the heading “Quote Method”. For each row in the file, input an “S” to quote the product as Small Package (parcel) or “L” to quote the product as LTL Freight.

If you have the LTL Freight Quote app installed, populate the Freight Class and Weight fields.

If you have the Small Package Quote app installed, populate the weight. Although populating the dimensions is not required, it’s highly recommended if the billable weight of your parcel shipments is frequently determined by dimensional weight. You should also populate the Freight Class field if you also have the LTL Freight Quote app installed. Doing so will improve quote accuracy when an LTL rate estimate is returned for an order that contains a mix of products.

Delete the rows representing products or product variants you don’t want updated.

Delete the columns you don’t want updated. For example, if you only want to update weights and your downloaded CSV file contains both weight and dimensions, remove the dimension columns to protect them from being affected by the import process.

Importing a blank cell in a column has the same effect as erasing the data that exists there.

Save the file as a CSV or Comma Separated Value file. Navigate back to the Import CSV tab in the app preferences. Click the box to indicate that your file has a header row, and then click the Choose File button. Select the file and click the Next button.

Use the drop down lists on the right to map the column headers in your file to the shipping parameters listed on the left. When the mapping is done, click next to begin the import.

When the import is done you’ll see a list of IDs representing the products that were updated. Beneath it you will see the list of products that didn’t. You can use your CSV file to locate these products and their product names. The removal of a product from Shopify after the CSV file is downloaded is the most common reason for an update failure.