The UPS Shipping module integrates your store with UPS to provide real-time shipping rates, shipping label generation, negotiated UPS rates, and configurable shipping services during checkout.
Merchants can configure multiple UPS shipper accounts within a single store and assign specific shipping methods to different accounts for greater flexibility when managing negotiated UPS rates across delivery services.
Migration from Legacy UPS Developer Kit
The UPS Shipping module supports migration from the Legacy UPS Developer Kit (Discontinued) module.
Existing UPS shipping settings can be migrated during setup without deleting orders associated with the legacy module.
On This Page
- Installation
- Migration from Legacy UPS Developer Kit
- Configuration
- Multiple UPS Accounts
- UPS Ground Saver
Installation
To install the module, navigate to Path: Settings > Modules
Select the UPS Shipping module.
Select the environment for the module and click Continue.
- Select Production for your live store
- Select Test for testing and development
NOTE: If your browser has a pop-up blocker enabled, the UPS login window in the next step may not open correctly.
Disabling the pop-up blocker after the window has already been blocked will not work. If this happens, you will need to restart the installation process after allowing pop-ups for your store domain.
When the UPS login window opens, enter your UPS account login credentials.
Migration from Legacy UPS Developer Kit
During setup, you can migrate settings from the Legacy UPS Developer Kit (Discontinued) module.
To migrate your existing configuration:
- Click Migrate in the migration prompt
- Click Skip to configure the UPS Shipping module as a new installation
After migration, existing UPS settings appear in the new module. Migration also disables the legacy module to prevent duplicate shipping configurations.
Note: Migration does not automatically update any Price Groups that offer UPS shipping discounts. Existing shipping discounts must be updated manually after migration.
Warning:
To fully remove the Legacy UPS Developer Kit (Discontinued) module, you must either:
- Archive orders that used shipping methods from the legacy module
- Deactivate the legacy module at the domain level
Configuration
If you are configuring the UPS Shipping module as a new installation, review and complete the following settings.
1. Mode: Choose the environment for the module:
- Production enables live UPS shipping rates and shipping labels billed to your UPS account
- Test displays real-time shipping rates using UPS test labels that cannot be used for shipping
2. Account Number: Enter your UPS account number. A valid account number is required to generate shipping labels. Real-time shipping rates can still be displayed without one.
3. Account Type: Select the UPS account type associated with your UPS account.
4. Billing Method: Select how shipping labels are billed:
- Credit Card prompts for a credit card each time a label is generated
- Bill Configured UPS Account bills labels directly to the configured UPS account
5. Use Negotiated Rates: Merchants with negotiated UPS pricing can enable this setting to display negotiated UPS rates during checkout instead of standard UPS rates.
UPS provides several standard shipping rate types based on shipping frequency:
- Daily Pickup
- Occasional Pickup
- Suggested Retail Rate
6. Use Zebra Thermal Printing: Enable this setting to print adhesive-backed shipping labels using a Zebra or Zebra-compatible thermal printer.
Visit UPS Thermal Printing documentation for additional requirements and printer configuration.
7. Ship From: Enter the address packages are shipped from. UPS uses this address and the customer’s shipping address to calculate shipping rates.
8. Default Delivery Confirmation: Select the default delivery confirmation method for UPS shipments. Delivery confirmation settings can be overridden at the product level.
Note: The most restrictive delivery confirmation method assigned to any product in the order applies to the entire shipment.
9. Specify Declared Value Equal to Basket Subtotal checkbox: The “Declared Value” is the order total. Enable this setting to automatically send the order subtotal to UPS as the shipment’s declared value.
UPS uses the declared value to calculate shipping insurance costs. Shipping charges may increase when insurance is applied.
If disabled, Miva does not send the order subtotal to UPS and shipping insurance is not automatically included. This field CANNOT be overridden at the product level.
10. Declared Value Currency: Select the currency used for the shipment’s declared value.
11. Default H.S. Tariff Classification: Enter the default H.S. Tariff code for international shipments generated through the Miva admin.
The H.S. Tariff code:
- Can contain up to 15 characters
- Must be configured globally and at the product level when generating international shipping labels
To configure the tariff code for a product:
- Open the product in the Miva admin
- Scroll to the UPS options section
- Enter the tariff code in the H.S. Tariff Classification field
12. Default Country of Origin: Select the default country of origin used for international shipments.
13. Worldwide Economy Duties Paid:
- Enable this setting to include duties and taxes in shipping costs for UPS Worldwide Economy shipments.
Disable this setting if duties should not be included in shipping costs.
14. Available Services: Select the UPS shipping methods available to customers during checkout. Shipping methods can also be restricted at the product level.
Multiple UPS Accounts
Assign UPS Services to Different Account Numbers
Merchants who use multiple UPS shipper accounts can assign specific UPS shipping services to different UPS account numbers.
This allows a single Miva store to use negotiated UPS rates from multiple UPS accounts simultaneously. Each UPS shipping service can be configured to use either the primary UPS account or a different UPS account number.
Common use cases include:
- Using separate UPS accounts for domestic and international shipping services
- Managing UPS services that cannot share the same negotiated rate card
- Applying different negotiated rates to specific UPS delivery services
During checkout, Miva automatically requests rates using the UPS account assigned to each shipping service and presents the available shipping options to the shopper.
Primary UPS Account
The UPS account number configured on the UPS Shipping: Options tab serves as the store's primary UPS account.
Any shipping service that does not have a specific account number assigned automatically uses the primary UPS account.
Configuring Account Numbers by Shipping Service
Navigate to PATH: Settings > Shipping Settings > UPS Shipping: Services
The UPS Shipping: Services tab allows you to:
- Enable or disable UPS shipping services
- Assign UPS account numbers to one or more shipping services
- View which UPS account is associated with each service
To assign an account number:
- Select one or more UPS shipping services.
- Enter the UPS account number in the Account Number field.
- Click Save Changes.
Services that do not have an assigned account number display <Primary> and use the primary UPS account configured on the UPS Shipping: Options tab.
Account Number Column in UPS Shipping: Services
The Account Number column displays the UPS account number assigned to each shipping service.
- <Primary> indicates the shipping service uses the primary UPS account configured on the UPS Shipping: Options tab.
- A displayed account number indicates the shipping service uses that UPS account instead of the primary account.
To assign an account number to a shipping service:
- Select one or more shipping services.
- Enter the UPS account number in the Account Number field.
- Click Save Changes.
If no account number is assigned, the service automatically uses the primary UPS account. Example: A merchant maintains two UPS shipper numbers:
- Shipper Number 123ABC receives preferred negotiated rates for domestic shipping services.
- Shipper Number 456DEF receives preferred negotiated rates for international shipping services.
The merchant can assign domestic UPS services, such as UPS Ground and UPS 2nd Day Air, to Shipper Number 123ABC and assign international services, such as UPS Worldwide Express and UPS Worldwide Expedited, to Shipper Number 456DEF.
During checkout, Miva automatically requests rates using the account number assigned to each shipping service, allowing shoppers to receive the appropriate negotiated rates for each available delivery option.
Shipping Labels
When generating UPS shipping labels, Miva uses the UPS account assigned to the selected shipping service. If no account number is assigned to the service, the primary UPS account is used.
Requirements and Limitations with Multiple Accounts
All UPS account numbers assigned to shipping services must be associated with the same UPS User ID.
UPS account selection is determined by the shipping service. Miva cannot automatically select an account based on products, package dimensions, shipment characteristics, warehouse location, or the lowest available rate among multiple UPS accounts.
The following settings are configured globally and apply to all UPS account and shipping service combinations:
- Account Type
- Billing Method
- Use Negotiated Rates
- Ship From Address
- Delivery Confirmation settings
UPS Ground Saver
UPS Ground Saver allows approved merchants to offer lower shipping rates for lightweight residential shipments.
When enabled, shoppers are presented with reduced shipping rates during checkout while Miva automatically applies the appropriate UPS Ground Saver service behind the scenes.
Caution: Your UPS account must be approved for UPS Ground Saver before the service becomes available in your store.
Configuring Display Names
To clearly communicate Ground Saver shipping options to customers, configure the shipping method’s Display As value by navigating to PATH: Settings > Shipping Settings
- Select the applicable UPS shipping method, such as:
UPS SurePost 1 lb or Greater - In the Display As field, enter:
UPS Ground Saver Shipping 1 lb or Greater - Click Save
Customers will then see the configured UPS Ground Saver shipping name during checkout.
Note: Map each UPS Ground Saver shipping option to its corresponding shipping service using the Display As field. Repeat this process for each Ground Saver method you offer.