UPS Freight Lookup
E-Quantum shipping integration for UPS allows using your own UPS account to calculate
freight on your Qnet site.
Before you begin you must have a UPS account established on ups.com. An access key is
required to link e-Quantum to your UPS account.
Obtaining the Access Key:
From www.ups.com, select Log-in on the top bar. Enter your User ID, click Next. Enter your
Password, click Log In.
Go to Tracking > click on Integrate Tracking APIs.
The following steps illustrate how to obtain the access key. The number
obtained will be required in the shipping carrier setup in e-Quantum. UPS
will send a email with the access key code to the email on file with UPS.
Step 1:
Click on Get
UPS Developer
Kit APIs
Step 2:
Click on Request Access
Key.
Step 3:
The access key is required in the eQuantum setup. Copy the number
from this window or from the
email confirmation that will be
sent from UPS.
1
Ship-From Setup
UPS uses zones to calculate time and cost of your shipment. The default state and zip code is
used when the vendor or the warehouse address information cannot be obtained.
From e-Quantum main menu, navigate to Qnet > Qnet Configuration > Internet Configuration >
Miscellaneous tab.
Enter the Ship-From State, Ship-From Zip Code and the Ship-From Country.
For Non-Stock items, the vendor City/State/zip is used to determine the ship-from zone. The default
vendor for an item is entered on page 3 in Item Maintenance. Right click in the Default Vendor field
to edit the vendor or select a vendor.
Stock items use the City/State/Zip from the item’s warehouse as the UPS ship-from zone.
From the main menu of e-Quantum, select Inventory > Maintenance > Warehouse Setup.
Select the warehouse to be edited.
2
Default Freight Charges
The system default determines what calculation method will be used on Qnet. Set the default to
the use the calculation method that will be used for most of the clients. Client override allows the
options to be changed by client.
The default for freight calculation is in QNet > QNet Maintenance > Internet Configuration >
Defaults > Display Defaults section. Checkboxes determine if the Freight, Tax or Weight will be
displayed on Qnet. The UPS freight charges dropdown determines which method of freight
calculation will be used on Qnet.
The UPS Freight charges dropdown settings:
Use e-Quantum’s freight table – no external lookup will be used, the values entered in
Shipping Charge Setup will be used to calculate freight.
Lookup using total weight – UPS interface will calculate freight based on the combined
weight of the items in the order.
Lookup based on line - UPS interface will calculate each line item independently then
combine the values on the checkout screen.
3
Client Freight Charges Override
The system default can be overridden at the client level if the system default is not applicable
to the client. The options to display Weight, Freight or taxes are on the Display tab, the option
for which calculation method is used is set on the Freight tab.
Client Maintenance > Qnet tab > Qnet configuration > Freight tab> United Parcel Service (UPS)
dropdown.
Select the lookup option for the client.
System Default – the option selected in System Defaults will be used for this client.
Use e-Quantum’s freight tables – no external lookup will be used, the values entered in
Shipping Charge Setup will be used to calculate freight.
Lookup based on total weight – UPS interface will calculate freight based on the
combined weight of the items in the order.
Lookup based on line item – UPS interface will calculate each line item independently
then combine the values on the checkout screen.
Shipping Carrier Set Up
The Shipping Carrier Setup links your UPS account in e-Quantum to your UPS online
account. You will need your UPS Access Key number to complete the setup of this section.
From the main menu of e-Quantum, navigate to O/E > O/E Maintenance > Shipping >
Shipping Carrier Setup. Click on Add, enter UPS as the carrier ID, use the description field
for a longer description of the shipping carrier. These fields are used for internal purposes.
Enter your UPS account number in the Account # field. Enter the e-Quantum vendor ID for
UPS in the Vendor field.
Select UPS In the dropdown field for Carrier Type. Enter your UPS User name in the Service
User field. Enter your password into the Password field. Enter the Access Key from the UPS
site into the Access Key field.
4
Shipping Method Codes
Shipping Method Codes are used to link the type of service to the freight options selected for the
client. You will set up a method for each service you will be offering on Qnet. I.E.: Ground, 3 Day
Select, Next Day Air or 2nd Day Air.
From the main menu of e-Quantum, go to O/E > O/E Maintenance > Shipping > Shipping Method
Codes. Click Add to create a shipping code. Select UPS in the Carrier ID. Use the drop down to
choose the type of Service. Enter a Description; the description field displays on Qnet. Set up
additional records for alternate shipping methods for UPS , such as Next Day Air. Qnet will lookup
the charges based on the service indicated in the Service field.
Selectable in Qnet must
be checked if the shipping
method is to be used for
Qnet.
Shipping Charges
Shipping Charges need to be set up even when using the live freight lookup on line. When
the live look up is used but a rate is not returned, Qnet will use the internal freight tables.
Set up the shipping charges in O/E > O/E Maintenance > Shipping > Shipping Charges
Setup.
Create a table for each of the shipping option displayed on Qnet. Internal freight tables
can be based either on dollars or on weight; when weight is used the weight must be
entered in each item on Page 3 of Item Maintenance.
The Qnet checkout screen can display multiple options for shipping methods. Each
shipping method is assigned to a shipping charges table.
5
Shipping Charge Table Setup
Enter the ID and Description for the table. Select the Basis, when using External Lookup, select
Weight as the basis.
External Lookup options:
No External Lookup – only the Internal Table will be used to calculate freight.
Find Discounted rate – external freight lookup will use your UPS account to calculate
freight.
Find Published rate – external freight lookup will use UPS published rates to calculate
freight.
If the lookup cannot return a value from UPS, the values entered in this table will be used. UPS
lookup will only calculate up to 150 pounds, enter freight amounts to cover over-weight
shipments.
Internal Shipping Charges
Click Add to enter the freight amounts. The Up To column can be based on weight or
dollars. When using the UPS Lookup, if a value cannot be returned from UPS, the
lookup will use e-Quantum’s internal table. UPS cannot calculate freight for shipments
totaling over 150 pounds or where ground or air service are not available.
A freight table should always be
entered in the shipping charge
setup. The UPS lookup function
uses the table as a backup if a
value cannot be returned from
UPS.
The Shipping Charge field is the dollar amount that will be charged for the freight on a Qnet
order. The Basis determines if the freight option the table is using is based on weight or dollar
amount of the order.
6
Client set up
The Freight tab in Client Maintenance links the freight charge table to the selected ship via.
Note: If a Freight ID is not entered for a Ship Via, the default Ship Charge ID will be used.
The shipping options to display on Qnet are selected in the Ship Via Restrictions tab.
Click on the Ship Via Restrictions tab, select the shipping options to display on Qnet. Only
freight options that have been marked as Selectable on Qnet in Shipping Method Codes will
be displayed in the window.
Select the options
to display on Qnet
Selected Ship Via Restrictions display on Qnet; assigning a shipping charge to the option displays
the shipping charge. If a shipping option does not have a Freight ID in the Shipping Charge
Override, the Default Ship Charge ID will be used for that freight option.
To assign a shipping charge table to a shipping option, double click on the Ship Via Option. Right
click in the Freight ID field, choose Display Scan. Select the corresponding shipping charge from
the list of freight tables.
7
Default Ship Via
Assigning a default ship via is recommended when displaying freight on Qnet. Setting a default
will populate the ship via field automatically on Qnet. Select only an option that has been
allowed in Ship Via Restrictions on the Freight tab. The default is entered in Client Maintenance
> Setup > Def. Ship Via.
The Ship Via dropdown on the checkout screen can be a required field. In Client Maintenance
> Qnet tab > Qnet Field Setup, set the option to Required.
Item Weight
The weight of each item is entered on Page 3 of Item Maintenance in the Default Weight field. An
additional amount can be added by adding a dollar amount in the Extra Freight Field.
Additional freight
can be added to
the item. The
dollar amount is
based on the unit
of measure.
The extra freight will display on the view cart screen unless suppressed. The option to suppress
is in Distributor Setup > Site Appearance > Suppress extra freight on ViewCart. The extra freight
line will be suppressed from displaying on the view cart screen, the value will be added into the
total freight amount on the checkout screen.
8
On Qnet the weight shows up on the overview tab in item details.
To suppress the weight
from displaying on Qnet, go
to Client Maintenance >
Qnet tab > Qnet
Configuration > Display tab.
In the dropdown field for
Show weight on Qnet,
change the option to: Do
not show weight.
The checkout screen displays the charges in a dropdown field. The calculated shipping price
displays next to the option. The default ship via will display; the user is allowed to select
from the other shipping options
9