Try our new AI assistant by clicking the chat icon in the lower right corner.
With the release of Miva version 10.09, there is a new UPS Shipping module that has been created to replace the old UPS Developer Kit, which is being deprecated by UPS. The old API is scheduled for end of life at the end of July 2024.
This new module does not include any freight functionality, because UPS spun off their freight division to TForce Freight. There is a separate TForce Freight module that was also released with Miva version 10.09. For information, visit the TForce Freight module documentation.
Because of the spin off, only settings for non-freight shipping methods are transferred to the new UPS module.
To install the module, navigate to Settings>Modules and select the UPS Shipping module.
Select the configuration type you are creating. If this is for your production website, select Production. If it’s a test, select Test. After you’ve made your selection, click Continue.
If your web broswer has a pop up blocker, it will block the opening of the box in the next step. Simply disabling the pop up blocker, and reopening the popup window from the blocked warning, will not work. You will have to start the process over completely.
In the box that opens, enter your log in information for your UPS account.
After that, you are given the option to migrate your Legacy data from the UPS Developer Kit module. To use the migration option, click the Migrate button in the box. If not, click Skip and configure the module as a new installation, as explained below.
Migration does NOT automatically update any Price Groups that offer UPS Shipping discounts. Those shipping discounts will need to be updated manually.
The module was designed to basically be a one-to-one conversion from the old module to the new, and once the migration is complete, you should see all of your old information in the new module. At the same time, the migration process disables the old module to avoid duplication.
In order to remove the old UPS Developer Kit module, you would have to either go into the Miva admin and archive any orders that used a shipping method through that module, or you can deactivate the old module at the domain level.
If you are not migrating from the old UPS Developer Kit to the new UPS Shipping Module, you will need to complete the configuration for the module.
Mode: Choose between Production or Test mode. Production mode makes the module fully active, with real-time shipping rates and actual shipping labels that are billed to your UPS account. Test mode allows you to see real-time rates, but the labels are free test labels and cannot be used for shipping.
Account Number: This is where your UPS Account number is entered/populated. Without a valid account number, you won’t be able to print shipping labels but you can view real-time shipping rates.
Account Type: Choose the type of account you created with UPS.
Billing Method: If you select Credit Card, the Miva admin will prompt for a credit card every time you print a label. Otherwise select Bill Configured UPS Account.
Use Negotiated Rates checkbox: UPS has three “standard" rates, depending on how frequently you ship: Daily Pickup, Occasional Pickup, and Suggested Retail Rate (this is set in the Account Type dropdown explained above). However, you can negotiate rates with UPS if you are an even more frequent shipper. This is known as the “Negotiated Rate.” If you check this box, your store will display the negotiated rate, rather than any of the three rates noted above.
Use Zebra Thermal Printing checkbox: This allows you to use a Zebra or Zebra-compatible printer to print adhesive backed labels. For additional information on requirements and set up for thermal printers, visit: https://www.ups.com/us/en/support/shipping-support/print-shipping-labels/thermal-printing-of-labels.page.
Ship From: This is the address where you send packages from. It, along with the customer’s address, are used to calculate shipping charges.
Default Delivery Confirmation: The value selected here serves as the default for every product shipped with UPS. This setting can be overridden at the product level.
The most restrictive delivery confirmation method for any item in the order sets precedence for the entire order.
Specify Declared Value Equal to Basket Subtotal checkbox: The “Declared Value” is the order total. If this box is checked, that order total is sent to UPS and UPS automatically insures the order based on that value. The shipping charge WILL increase because it includes the cost of insurance. If you don’t select this, the order total is not sent to UPS and insurance isn’t automatically added. This field CANNOT be overridden at the product level.
Declared Value Currency: Select the currency used with the order total.
Default H.S. Tarriff Classification: The HS Tarriff code must be added at the global and product level, and should be uses if labels are being generated by the Miva admin for international shipping. The code can be up to 15 characters long. To configure this code at the product level, from the product’s main page in the Miva admin, scroll to the UPS options section and enter the code in the field.
Default Country of Origin: This sets the default country of origin for international shipping.
Worldwide Economy Duties Paid checkbox: Checking this box figures in the cost of duties into the shipping cost. To offer shipping without including the duty costs, leave the box unchecked.
Available Services: Select the UPS shipping options customers will see during checkout. Note that shipping methods can also be restricted at the product level.
If your store is approved for UPS Ground Saver shipping, you are able to offer lower shipping rates on residential, lightweight orders. This helps your store save money and ensure that your packages arrive safely.
Your store must be approved to participate before Group Saver is a shipping option available in your store.
Once approved to offer UPS Ground Saver shipping, when a shopper chooses a UPS Ground Saver shipping method, they are presented with lower rates than with other UPS methods because the Miva admin does the work of providing the better rate behind the scenes.
In order for you to convey to your customers that they are receiving the Ground Saver rate, you will need to use the Display As functionality for the corresponding shipping rate. For example, from the admin home page, go to Settings>Shipping Settings and click on the UPS SurePost 1 lb Or Greater rate.
In the box that opens, in the Display As Field, enter UPS Ground Saver Shipping 1 lb Or Greater. Then Click Save.
When a customer is checking out, and choosing their shipping method, they will be given the Ground Saver rate, and in the shipping options they will see “UPS Ground Saver Shipping 1 lb Or Greater.”
You should "map" the name of the actual Ground Saver shipping options to their corresponding exisiting shipping option by using the Display As functionality as explained above. You should do this for each Ground Saver option you provide.