UPS OnLine Tools Setup

Contents of this Topic: Show

Overview

Configure Stone Edge to Use the UPS Online® Tools Integration

  1. Go to Main Menu > Settings > System Functions > Set System Parameters.

  2. Set the following system parameters:

UnitOfMeasureDimensions - set this to the unit of measure used for dimensions

UnitOfMeasureWeight - set this to the unit of measure used for weights

  1. Go to Main Menu > Settings > System Functions > Store Setup Wizard and select the Shipping  section.

  1. Select UPS in Choose a shipper: and then select Order Manager in Then choose a shipping system:.

  2. Go to Page 3 of the Shipping section and click UPS in Show shipping methods for:.  

  3. Click Select All to enable all of the pre-defined UPS shipping methods. To disable one of the methods, clear its Use This Method check box.

  4. Click Set All to be able to use the Rate Shopping feature with all UPS shipping methods.

  5. Return to Page 1 of the Shipping section and click UPS OnLine® Tools Setup Wizard.

  6. The UPS Online® Tools Setup walks you thru entering your UPS account information and preferences. Many of the settings entered on the UPS Online Tools Setup screens set parameters in the UPS Parameter Group.

UPS OnLine® Tools Registration

Screen 1 - Welcome

  1. Enter your 6-character UPS Account Number for your Daily Pickup Account in UPS Account Number.

  1. Click Next.

Screen 2 - License Agreement

  1. Select Yes, I agree to the terms of use to the question Do you agree to the terms of this agreement?. If you do not agree with the terms, click Cancel to exit the wizard.  To use the UPS OnLine Tools system you must accept the UPS Licensing Agreement (agreement). If you do not accept the agreement, you may click on the Cancel button to exit the wizard.

  2. Optional: To obtain a hard-copy of the agreement, click Print Agreement to open the agreement in Notepad where you can print or save the agreement to file.

  3. Make a selection in I would like a UPS Sales Representative to contact me about opening a UPS Shipping account or to answer questions about UPS Services. The default response is Yes.

  1. Click Next.

Screen 3 - Company Information

  1. The company information entered here must match your company's "shipper information" already on file with UPS. An alternate "ship from" address can be entered at Screen 5.

  2. Enter your Company Name.

  3. If you will be shipping internationally, enter your company's tax identification number in Tax ID.

  4. Enter your company's Street Address.

  5. Optional: Enter Address 2 information - Suite, Floor Number, etc. in Building, Room, Floor.

  6. Optional: Enter the name of the department to receive the package in Department.

  7. Enter your company's City.

  8. Enter your company's State/Province.

  9. Enter your company's Postal Code.

  10. Enter the Country where your company is located.

  1. Click Next.

Screen 4 - Contact Information

  1. Enter the Name of the contact person at your company who can answer inquiries regarding UPS shipments - required for international shipments.

  2. Optional: Enter the Title of the contact person.

  3. Optional: Enter the Email Address of the contact person.

  4. Enter the Phone Number of your company contact's phone number - required for international shipments.

  5. Optional: Enter the Fax Number of the contact person.

  6. Optional: Enter the Company URL.

  1. Click Next.

Screen 5 - Use Alternate Ship From Address for UPS

  1. If you are only shipping from the address entered in Screen 3 click Next to proceed to skip this page.

  2. If you will be shipping from a location that is different than the location specified on Screen 3 (Shipper Information screen), select the check box at the top of the screen labeled Use Alternate Ship From Address for UPS.

  3. Enter your Company Name at the alternate location..

  4. If you will be shipping internationally, enter your company's tax identification number in Tax ID.

  5. Enter your company's Street Address at the alternate location.

  6. Optional: Enter Address 2 information - Suite, Floor Number, etc. in Building, Room, Floor at the alternate location..

  7. Optional: Enter the name of the department to receive the package in Department at the alternate location..

  8. Enter your company's City at the alternate location..

  9. Enter your company's State/Province at the alternate location..

  10. Enter your company's Postal Code at the alternate location..

  11. Enter the Country where your alternate site is located.

  1. Click Next.

Screen 6 - UPS Payment Options

This screen allows you to set the default payment information for a shipment. The program assumes the shipper is the payor, however, you can assign different information on this screen, if needed.

  1. Select the level of payment detail you want to provide from the Payment Detail drop-down list. Options include "Basic" (domestic and international shipments) or "Itemized" (international shipments only).

    1. Basic (domestic and international shipments) - allows you to specify the payor is responsible for all charges for the shipment. The Duty and Taxes section is disabled if this option is selected.

    2. Itemized (international shipments only) - allows you to specify separate payors for shipment fees and duty fees. This option enables the Duty and Taxes section. This choice enables a field called Split Vat. If selected, the party responsible for shipping fees and the party responsible for duty and taxes split the payment of any Value Added Taxes (VAT) applied to the shipment.

  2. In the Shipping Charges section and, if enabled, the Duty and Taxes section, make selections in the following fields:

    1. Payor select Shipper, Receiver, Third Party, or Consignee.

      1. If Shipper is selected, you can choose a Payment Method of UPS Account Number or Credit Card.

        1. If UPS Account Number is selected, enter it in UPS#.

    1. If Credit Card is selected then enter the following data:

Acct # - enter the credit card number without dashes or spaces

Pay Zip - enter the Zip Code of the card holder

Country - select the Country of residence of the card holder

Expiration -- enter the card’s expiration date in "mmyy" format

CVV2 -- enter the card’s 3 or 4 digit security code

Street 1 -- enter the card holder’s street address

Street 2 -- enter any additional address information for the card holder

Street 3 -- enter any additional address information for the card holder

City/State -- enter the city and select the state of residence of the card holder

 

      1. If Receiver is selected from the Payor drop-down list then the only payment option is by UPS Account. Enter the Receiver’s UPS Account Number in the UPS# field and their Zip Code in the Pay Zip field.

 

      1. If Third Party is selected from the Payor drop-down list then the only payment option is by UPS Account. Select the type of party the third party represents from the Party Type drop-down list. Enter the Third Party’s UPS Account Number in the UPS# field, their Zip Code in the Pay Zip field and select their country of residence from the Country drop-down list.

 

    1. If Consignee is selected from the Payor drop-down list, no other data points are required.

  1. Click Next.

Screen 7 - UPS Default Settings

The settings specified here can be overridden on individual shipments when shipping labels are printed from one of the locations that displays the UPS OnLine Tools Shipping screen.

 

  1. UPS Account Type -- Select Daily Pickup

  2. Default Delivery Confirmation Type -- Select from one of the following options, some of which may incur additional fees:

    1. No Confirmation -- No delivery confirmation requested on the shipment

    2. Confirmation with No Signature -- Delivery Confirmation request sent with shipment specifying no signature required

    3. Signature Required - Delivery Confirmation request sent with shipment specifying that a signature is required

    4. Adult Signature Required - Delivery Confirmation request sent with shipment specifying that an adult signature is required

  3. Amount for Signature Required --

    1. If you have chosen the No Confirmation or Confirmation with No Signature option from the Default Delivery Confirmation Type drop-down list, you can have the program change the confirmation type to Signature Required when the Insured Value of the order meets or exceeds the dollar amount entered in this field.

    2. If you have chosen the No Confirmation, Confirmation with No Signature, or Signature Required option from the Default Delivery Confirmation Type drop-down list, you can have the program change the confirmation type to Adult Signature Required when the Insured Value of the order meets or exceeds the dollar amount entered in this field.

  4. Default Return Service -- Allows you to define the default return service (if any) to apply to a shipment. Select from one of the following options:

    1. None -- No return shipment is processed

    2. Print Return Label -- Return Label printed with the shipping label

    3. Print and Mail -- Return Label is printed at UPS and mailed to the customer

    4. Electronic Return Label -- Return Label is emailed to the customer by UPS

    5. Return Service 1 Attempt -- Return Label printed by UPS, given to driver who attempts to pick up package. If the attempt fails, the driver leaves the label for the customer

    6. Return Service 3 Attempts -- Return Label printed by UPS and given to the driver who will attempt to pick up package three times. Label is not left with customer if attempts fail.

  5. Default to Residential -- This option controls the Residential flag on the shipment. Select from one of the following options:

    1. No -- Residential flag is set to false (unchecked)

    2. Yes -- Residential flag is set to True (checked)

    3. YesIfNoCompanyName -- This option will set the Residential flag to True if the shipping party does not have a company name present in their information. Leaves the Residential flag set to false otherwise.

  6. Default COD Type -- If the order shows a balance due at the time the shipment is being processed, the program can set the COD flag to the default option selected here. Choose from one of the following:

    1. Check -- Cashier’s Check -- Money Order -- The three stated forms of payment are accepted

    2. Cashier’s Check -- Money Order -- The two stated forms of payment are accepted

    3. Cash (EU Origins Only) -- Cash accepted -- this only pertains to shipments originating within the European Union

    4. Check -- Money Order -- No Cash (EU Origins Only) -- Only check and money order allowed. No cash accepted -- this option only pertains to shipments originating within the European Union.

  7. Default Package Type -- This option sets the default package type for the shipment. Select from one of the following options:

    1. Customer Packaging

    2. UPS Express Envelope

    3. UPS Express Tube

    4. UPS Express Pak

    5. UPS Express Box - Small

    6. UPS Express Box - Medium

    7. UPS Express Box - Large

    8. UPS 25 Kg Box

    9. UPS 10Kg Box

  8. Package Length, Package Width, Package Height -- If you selected the Customer Packaging option from the Default Packaging Type drop-down list, you can enter the default package dimensions into these three fields. Package Length must contain the largest of the three values. Values are to be entered in inches/centimeters and are used to calculate Dimensional Weight of the package. These fields do accept decimal values.

  9. Paperless Commercial Invoice for International Shipments -- You must contact UPS to set up your account to use Paperless Commercial Invoices with the internal UPS system. By selecting this option, OMS will assume the merchant is set up to use the paperless commercial invoice feature with UPS and will flag any shipments that may require additional documents (NAFTA, SED, etc.).

  10. Verify Addresses in Shipping Request -- Check this option if you want UPS to perform address validation on the shipping address prior to processing the shipment.

  11. Default Insure Shipment -- This option sets the default value of the Insure check box. If checked, the shipment will include an insurance request.

  12. Minimum Value before applying insurance --  Enter the minimum shipment value required to apply insurance. If shipment value is below this threshold, value is set to 0 so insurance is not applied to shipment. This setting is ignored if the parameter UPSDefaultUseInsurance is FALSE.

  13. Insured Value Source -- If the Default Insure Shipment check box is selected, this option becomes available. This allows you to define how the Declared Value is reported for shipping insurance. Select from one of the following options:

    1. Product Total -- Value is set to the total retail value of shippable items on the order

    2. Grand Total- Value is set to the final grand total on the order

    3. Product Cost -- Value is set to the Cost of shippable goods on the order

    4. Product Total to Max Amount- Value is set to the retail value of shippable items on the order up to the maximum amount entered into the Amount field.

    5. Grand Total to Max Amount- Value is set to the final grand total on the order up to the maximum amount entered into the Amount field.

    6. Product Cost to Max Amount- Value is set to the cost of goods of shippable items on the order up to the maximum amount entered into the Amount field.

    7. Flat Amount -- Value is set to the dollar amount entered into the Amount field

  14. Amount -- If you selected one of the options for Insured Value Source that contain the word "amount", this field is be enabled to accept a dollar amount that acts as the declared value (Flat Amount) or "ceiling" (Max Amount) for declared value for shipping insurance.

  15. Click Next.

Screen 8 - UPS Quantum View Email Settings

This screen allows you to define the Quantum View Notification (QVN) options for the order.

  1. Default Quantum View Option - Select from one of the following notification options:

    1. None -- No QVN notifications will be sent for shipments

    2. QVN Ship Notification -- Notification of shipment is emailed

    3. QVN Exception Notification -- Notification of exceptions is emailed

    4. QVN Delivery Notification -- Notification of shipment delivery is emailed

  2. Undeliverable Email Address -- Enter an email address that is to receive any QVN emails that could not be delivered.

  3. CC Email Address 1 - 4 -- Enter up to four additional addresses that will also receive QVN notification emails.

  4. Text to Include in the UPS Email -- You can enter up to 150 characters to be added to the bottom of the QVN Notification email.

  5. Click Next.

Screen 9 - Additional Parameter Settings

This screen allows you to set some optional parameters and your printer settings. Select from the following options:

  1. Markup Type, Markup Amount, Markup Minimum -- If you wish to add additional surcharges (shipping markup) on the rates charged/quoted by UPS, you can set this field to FlatAmount or Percent.

    1. If you select FlatAmount then enter the dollar amount to add in the Markup Amount field.

    2. If you select Percent, then enter the percentage to add in the Markup Amount field. You can also set a minimum dollar amount to charge in the Markup Minimum field. Should the calculated markup be less than the minimum, the minimum will be applied.

    3. If you do not wish to add surcharges then set this field to None.

  2. Track Package View Method -- Choose from the following options:

    1. Order Manager -- When you click Track Package at the Shipping tab of the Process Orders screen, the program polls UPS for tracking details and then displays the results in a screen within OMS .

    2. Browser -- When you click the Track Package at the Shipping tab of the Process Orders screen, the program opens a web browser screen at the UPS website and enters the tracking number automatically.

  3. Tracking Agreement -- If you set the Track Package View Method option to Order Manager then you must read and accept the UPS Tracking License Agreement before completing the wizard.

  4. Lock Shipper Info on UPS Shipping Form -- Selecting this option prevents users from changing the "shipper" and "ship from" fields on the UPS Shipping Form when they are processing shipments.

  5. Show all rates on Ship Rate Shop form -- If this option is TRUE, OMS displays rates for all UPS shipping methods available between the Origin and Destination addresses. If this option is FALSE, OMS only displays rates for UPS Shipping Methods available between the Origin and Destination Addresses that have been associated with your shipping methods in OMS

  6. Do Not Use Printer Menu -- If you have the system parameter UsePrinterMenu set to TRUE and you do not want the UPS Shipping System to use the Printer Menu prompt, select this option.

  7. Run UPS Shipping in Test Mode --Selecting this option allows the user to print shipping labels without being charged. The labels are actually produced by a UPS production server but voided after the label is received.

  8. Label Printer -- This option allows you to specify the type of label printed. Choose from one of the following options:

    1. Thermal -- EPL -- Used for printing 4" x 6" labels on a thermal label printer that supports the Epson Printer Language (EPL).

    2. Thermal -- SPL - Used for printing 4" x 6" labels on a thermal label printer that supports the Samsung Printer Language (SPL).

    3. Thermal -- ZPL - Used for newer Zebra printers that are distributed by UPS and require the Zebra Printer Language (ZPL)  instead of EPL. Used for printing 4" x 6" labels.

    4. Laser -- GIF -- This option is used to print a combination label and packing slip on 8-1/2" x 11" paper. This requires the use of special stock.

 

Note: If the customer has a Zebra Printer and the print is accessible through the network, but they are still not able to print labels from the integrated UPS Online Tools to that printer using the Thermal -- EPL setting, try changing the setting it to Thermal -- ZPL. If the customer does not see Thermal -- ZPL as an option and they have a newer Thermal printer, they should upgrade OMS to the latest version.

 OMS 's integrated UPS OnLine Tools shipping software does not support the use of STAR printers.

 

  1. Printer Location -- If you selected the Laser -- GIF option from the Label Printer drop-down list, leave this option blank. If you chose one of the thermal label options then you must enter the printer’s location. This is done in one of two ways:

    1. If the printer is connected to the shipping PC using a serial port (COM) or printer port (LPT) then enter the port’s name into this field (i.e. COM1 or LPT1)

    2. If the printer is connected to the shipping PC using a USB port or the printer is connected to another PC on the network, you must set up the printer to be "shared" on the network. Enter the UNC (Universal Naming Convention) path to the shared printer
      (i.e. \\ComputerName\PrinterShareName). This setting can also be established per workstation in the PC & Cart Based System Parameters so each shipping PC on your network can be set up with a different printer if needed.

  2. Don’t print invoices for UPS orders -- If you selected the Laser -- GIF option from the Printer Location drop-down list, you can select this option to tell OMS to not produce an invoice for the order since the shipping label will already have the packing slip.

  3. Don’t print packing slips for UPS orders -- If you selected the Laser -- GIF option from the Printer Location drop-down list, you can select this option to tell OMS to not produce a packing slip for the order since the shipping label will already have the packing slip.

  4. Click Finish to send your registration information to UPS. Please be patient as this can take up to 30 seconds to complete the exchange. If your information is accepted Screen 10 is displayed, otherwise you’ll receive an error and will have to correct your information.

Screen 10 - Additional Parameter Settings

  1. Use Negotiated Rates -- If your UPS account is set up to receive negotiated rates, select this option to have the program request negotiated rates for when doing rate lookups or processing shipments. Refer to UPS Negotiated Rates for additional requirements prior to being able to use negotiated rates with OMS . Otherwise, simply click Next.

  2. Click Next.

Screen 11 - System Test - Ship To Information

 

  1. Optional: If you want to test the printer, you can enter a shipping destination in the System Test - Ship To Information screen, or just click Print Test Label. The fields are populated with the old Stone Edge office address by default. If your setup is correct a label is produced. The system may throw an error depending on the defaults selected in the wizard, since not all defaults are acceptable for a test shipment. (For example, the default "Print Return Label" is known to cause an error from the UPS side when printing a test label.)  If you receive an error, please test on a normal shipment before contacting Stone Edge Tech Support.
  2. Click Close.
  3. Click Save and Exit on the Store Setup Wizard screen.

Additional Information

Printing Shipping Labels

Printing Integrated UPS Shipping Labels

UPS Negotiated Rates

 

Created:

Revised: 12/3/14

Published: 04/14/16