UPS

Sana Commerce 9.3
Your connector

Configure UPS

When the UPS shipping provider is installed, it should be configured in Sana Admin.

Before configuring UPS you should create a UPS merchant account and register for the UPS Web Services Access to receive the Username, Password and Access Token from UPS:

  • Register for a test account

  •  NOTE

    The UPS test environment does not return the actual calculated shipping costs. When you test delivery via UPS using the test account, UPS returns the predefined rate. Only the UPS production environment will return the actual negotiated rate.

  • Request a production access

When you have all the necessary information from UPS, you can start configuring the UPS shipping provider in Sana Admin.

Step 1: In Sana Admin click: Apps > Add-ons. When the UPS add-on is installed, you can configure it from any tab on the "Add-ons" page by clicking on the Configure button .

Step 2: Configure the UPS connection settings. Enter the following information provided by UPS:

  • Service URL
  • Access token
  • Username
  • Password

Step 3: In the Package type dropdown, select the type of packages to be delivered to UPS.

Package type Description
UPS Letter Select for Next Day Air Early AM, Next Day Air, Next Day Air Saver, 2nd Day Air AM, 2nd Day Air, Worldwide Express, and Worldwide Express Plus services.
Package Select for packages delivered in boxes, cartons, or any other non-letter enclosure.
Tube Select for protecting documents that must be rolled rather than folded. Its dimensions are 38" x 6" x 6" (or local equivalent). Use the tube for single-piece shipments for Next Day Air Early AM, Next Day Air, Next Day Air Saver, Worldwide Express, and Worldwide Express Plus services.
Pak Select for protecting shipments that need a 16" x 13" x 1" (or local equivalent) container of tear-resistant material. Use for Next Day Air, 2nd Day Air, Worldwide Express, and Worldwide Expedited services.
25KG Box Select for shipments weighing up to 25 KG (55 pounds). The box's dimensions are 19" x 17" x 14" (or local equivalent). Use the box for prepaid shipments from the United States and Puerto Rico for Worldwide Express and Worldwide Express Plus services.
10KG Box Select for shipments weighing up to 10 KG (22 pounds). The box's dimensions are 17" x 13" x 11" (or local equivalent).  Use the box for prepaid shipments from the United States and Puerto Rico for Worldwide Express and Worldwide Express Plus services.
Pallet

Select for palletized shipments. A pallet is a low portable platform of wood, plastic, metal, fiberboard, or combinations thereof, that is elevated enough to allow forklift access. A pallet assists in consolidation and handling of packages and decreases the amount of time it takes to move packages.

    This package type code appears only for United Kingdom (GB) to United Kingdom (GB) and Poland (PL) to Poland (PL) shipments.

Small Express Box Select for smaller shipments, such as books and tapes. The box's dimensions are 13" x 11" x 2". Use the box for Next Day Air Early AM, Next Day Air, Next Day Air Saver, 2nd Day Air, Worldwide Express, and Worldwide Express Plus services.
Medium Express Box Select for smaller shipments, such as books and tapes. The box's dimensions are 15" x 11" x 3".  Use the box for Next Day Air Early AM, Next Day Air, Next Day Air Saver, 2nd Day Air, Worldwide Express, and Worldwide Express Plus services.
Large Express Box Select for shipments weighing up to 30 pounds (or local equivalent). The box's dimensions are 18" x 13" x 3". Use the box for Next Day Air Early AM, Next Day Air, Next Day Air Saver, 2nd Day Air, Worldwide Express, and Worldwide Express Plus services.

Step 4: In the Pickup type dropdown select the method by which the packages are to be delivered to UPS.

Pickup Type Description
Daily Pickup A UPS driver stops at your location once each business day (Monday - Friday) to pick up ground, air, or international shipments. This option is best suited for those who ship every day and want the convenience of an automatic pickup time.
Customer Counter Pay shipping charges and ship packages to a retail location such as The UPS Store™ or UPS Customer Center.
One Time Pickup Arrange by phone for UPS to pick up packages.
Letter Center Drop off a pre-paid package at any location accepting UPS packages.

Step 5: Set up other UPS settings:

Settings Description
Use dimensions This option enables/disables the ability to pass package dimensions (length, width, height) in the UPS shipping rates calculation request.

When the Use dimensions option is enabled:

  • If the total dimensions of the products in the basket exceed the maximum dimensions, then the separate packages will be created in the request to UPS.
  • If the maximum dimensions do not exceed, then a single package will be passed in the request to UPS.
Saturday pickup This option enables/disables Saturday Pickup to allow UPS collect your packages on Saturday at your request. For more information, see 'UPS Saturday Pickup'.
Saturday delivery This option enables/disables Saturday Delivery for time-critical shipments. For more information, see 'UPS Saturday Delivery'.
Log warnings This option enables/disables logging of the UPS API generated warnings.
Shipper number Enter a valid shipper number. It is required to receive the negotiated rates, when the option Negotiated rate is enabled.
Negotiated rate This option enables/disables receiving the negotiated rates. For more information, see 'Account-Specific Negotiated Rates'.

When this option is enabled and the shipper number is authorized for web/promotional discounts, the negotiated rates will be received.

Optimized packaging Enabling this option optimizes shipping rates calculation for large orders, for example, if your customers need to get a shipping rate for up to 1000 packages when they create orders.

If your customers often create large orders, for example, orders containing more than 200 items, we recommend to enable this option. By default, this option is disabled.

Step 6: Configure the webstore shipping origin:

  • If the option Use custom shipping origin is disabled, then the shipping origin will be retrieved from the ERP system. For the shipping cost calculation, the address of the warehouse that you ship from when delivering goods to the customer will be used. In case of anonymous webstore visitor, the warehouse address of the template customer will be used.
  • If the option Use custom shipping origin is enabled, then the shop administrator should manually enter the webstore shipping origin address. All shipping costs will be calculated based on this address.

When UPS is configured, you can create UPS shipping methods.