Skip to content

UPS

Show live UPS rates at checkout and buy UPS labels from your orders with your own UPS account

Updated View as Markdown

Connect your UPS account to show live UPS rates at checkout and buy UPS labels from your orders. Rates come from your own account, and labels are billed to it.


Features

Feature Description
Live rates at checkout Your UPS account rates for each package, on the services that package may use
Shipping labels Buy, print and void UPS labels from an order, with optional declared value
Firearm rules built in Handguns get air services only, ammunition gets UPS Ground, and firearm labels are bought with an adult signature

Before You Start

You need:

  • A UPS account number
  • UPS’s approval to ship firearms. UPS only accepts firearms from licensed shippers under a UPS firearms agreement, so ask your UPS account representative.
  • An app on the UPS Developer Portal for your Client ID and Client Secret

Creating Your App

  1. Sign in to the UPS Developer Portal with the UPS.com login that your account number is linked to
  2. Create an app, link your UPS account number to it, and add the Rating and Shipping APIs
  3. Copy the app’s Client ID and Client Secret

Setting Up

  1. Go to Plugins > Marketplace and find UPS
  2. Click Activate
  3. Enter your Client ID, Client Secret and Account Number
  4. Leave Enable Sandbox Mode off to use your live account. Turn it on only to try things out in UPS’s test environment, where labels are free and can’t be shipped.
  5. Click Activate Plugin

FirearmCart checks your Client ID and Client Secret with UPS when you click Activate Plugin, and doesn’t save them if UPS turns them down. The check doesn’t cover your account number, which UPS only sees when you get rates or buy a label. To change your credentials later, click Configure on UPS under Plugins > Marketplace. Save checks them the same way.

The first time you activate the plugin, its ship-from address is copied from your store address under Settings > General.


Settings

Open Plugins > UPS, make your changes and click Save settings.

Setting What it does
Show UPS rates at checkout Quotes live UPS rates for any cart UPS can ship, in place of your paid zone rates. Off by default.
Rate display at checkout Combined shows one shipping price for the whole order, named for the services its packages use, such as UPS 2nd Day Air + UPS Ground for a handgun and ammunition. Per package shows a separate rate for each package that has to ship on its own.
Rate buffer Adds a flat amount, a percentage, or both to each live rate. See Real-Time Rate Buffer.
I have an active UPS Firearms Agreement Confirms your UPS account is approved to ship firearms. Until it’s on, FirearmCart won’t buy a UPS label for a handgun or long gun, and leaves UPS out of firearm rates when you buy a label.
Services shown at checkout The UPS services customers can choose from. All are selected by default. The rates you see when you buy a label follow this list too.
Max box weight (lb) The heaviest box you ship, from 1 to 150 lb. A heavier order is split into several boxes, each with its own label. Leave it blank to use UPS’s 150 lb limit.
Ship-from address Where your packages ship from. UPS can’t quote a rate until it has a ZIP code.

Rate display at checkout, Rate buffer and Services shown at checkout appear once Show UPS rates at checkout is on. Firearm and ammunition rules still win over your service choices: ammunition always keeps UPS Ground and handguns always keep an air service, even if you untick them.

Shipping explains how live rates sit alongside your zone rates at checkout. Keep a paid zone rate as a backup: checkout shows it when UPS can’t quote, and without one customers can’t check out then.


What UPS Can Ship

FirearmCart offers each item only the UPS services it may use:

Item UPS services
Handguns UPS Next Day Air Early, UPS Next Day Air, UPS Next Day Air Saver, UPS 2nd Day Air
Long guns Any service
Ammunition UPS Ground
Accessories Any service
  • Handguns. UPS’s published policy allows handguns only on its Next Day Air services. UPS 2nd Day Air needs a firearms agreement that allows it, so untick it under Services shown at checkout if yours doesn’t.
  • Ammunition. Ammunition ships by UPS Ground in its own package.
  • Handing packages over. UPS accepts firearm packages only through a scheduled pickup or an On-Call Pickup, never at a drop box, The UPS Store, another retailer or a UPS Access Point. Nothing on the box should show what’s inside.
  • Adult signature. Every handgun and long gun label is bought with UPS Adult Signature Required, and live rates include it.

See Shipping Firearms for how a cart is split into packages.


Buying Labels

Buy labels from the order page: open the fulfillment’s menu and choose Buy & print label. Enter an amount in Insure for ($) to declare a value above UPS’s default coverage. UPS labels open as 4x6 images for your label printer. See Shipping Orders.


Troubleshooting

UPS Authentication Failed

A message starting UPS authentication failed means UPS turned down your Client ID or Client Secret. It shows under Client ID when you activate the plugin or save it with Configure, and on Plugins > UPS after Test connection. Copy them again from your app on the UPS Developer Portal, and check that Enable Sandbox Mode is off for your live account.

UPS Is Rejecting Your Credentials

If UPS turns down your Client ID and Client Secret at checkout or when you buy a label, Plugins > UPS shows UPS is rejecting your credentials, and everyone on your team gets the Tax or shipping connection rejected alert. See Notifications. Until it’s fixed, checkout shows your paid zone rates instead of live UPS rates, and UPS labels can’t be bought.

Click Configure on the UPS card under Plugins > Marketplace and enter the Client ID and Client Secret again, then click Test connection on Plugins > UPS. The warning clears as soon as UPS accepts them.

Sandbox Labels Fail for Some Addresses

UPS’s test environment only knows some ZIP code combinations, so a sandbox quote can fail for a real address. This doesn’t happen with your live account.

No UPS Rates When Buying a Firearm Label

Turn on I have an active UPS Firearms Agreement on Plugins > UPS and click Save settings. UPS firearm rates and labels stay unavailable until it’s on.

No UPS Rates at Checkout

  • Show UPS rates at checkout is off
  • UPS is rejecting your credentials
  • The ship-from address has no ZIP code
  • The UPS account number isn’t linked to the UPS.com login you created the app with
  • An item is heavier than your Max box weight, or 150 lb, and can’t be split across boxes

Navigation

Type to search…

↑↓ navigate↵ selectEsc close