In this guide, we will discuss the setup of the UPS integration, along with how to use the integration and what to do if you run into any problems. This guide will not cover Order Fulfillment. Please review the associated fulfillment guide.

TABLE OF CONTENTS

• Setup
• Creating UPS Orders
• FAQ's
  • Is it possible to deliver wine shipments to a licensed UPS location at the customer's request?
  • Why did I get an Invalid Zip code or Address Error
  • On the checkout screen in the POS, when I select "Ship", no shipping options appear. Why would this happen? 
  • UPS Error 2500002
  • "Wine Shipping Restricted Due to State Laws" Error

Setup

Go to the Shipping module in OrderPort Admin under the settings tab. In the Shippers tab, it must be enabled in the Carriers section. Once enabled, click "save. It will now appear as a separate tab in the module. 

The instructions below are for the New OAuth API integrations. Starting on 06/03/2024 UPS will no longer support Access Key API integration. All clients using UPS must use this as the hard deadline. See the Steps below. For more information, click here.

*It can take up to 24 hours to see rates. OrderPort suggests doing this on a day you are not going to ship any products.

1. Login to your UPS account from this link. https://developer.ups.com/?loc=en_US
2. Click Create an Application. Create an Application for OrderPort. Then select Add Apps.
3. On the Next step, select: 'I need API credentials because: “I want to integrate with UPS technology to represent many users”' 
4. Choose an account to associate with these credentials (select your account #). 
5. In the next step provide your information 
6. For this step, make sure to select at least the following products: This is very Important! If you do not select all of these, the integration will not work.

• Rating
• Pickup
• Address Validation
• Authorization (OAuth)
• Tracking
• Shipping
• Time In Transit

Callback URL to use if required: https://administration.orderport.net/shipping/carriers/ups

Entering credentials into OrderPort

Once you’re done, take the ClientId and the Client Secret and put them in OrderPort Admin > Shipping > UPS, then save changes. This can take up to 24hrs before you will see rates displayed in OrderPort. Select OAuth Client Credentials under Authentication Mode. Input your Client ID and Client Secret. Save Changes. For information about Shipper Numbers, see this: https://learningcenter-ihub.ups.com/Support/KB/add-shipper-accounts-to-ups-user-account

When you have completed the setup, proceed to Enter Orders and try creating a test order. On the first screen, indicate that the order “needs shipping”. When you arrive on the check-out screen, you should see UPS prices. If you see this, then the integration is set up correctly. If you receive an error message, contact helpdesk@orderport.net.

Additional Feilds 

Pickup Type

Packaging Type

Customer Classification

Shipping Label Format

Residential Delivery

Negotiated Rates Enabled

Declared Value

Carrier Email Notifications and Recipients

After you have setup, your account will have the option to send automated emails to customers from UPS when certain events occur. Please review the options and decide if you want to send these emails to the customer's billing or shipping address. If nessisary you can also cc someone at the winery. 

Customizations

If you want to display your client's customer class on their shipping lable you can decide to enable that from here. 

Secondary Accounts

In some instances, a winery may have multiple UPS accounts. If you need to add a secondary account, please click Add Secondary Account and go through the account setup again. When setting up a secondary shipping account, there will be a new field available titled Locations.

The only way that OrderPort can determine which UPS account should be used is based on the ship-from location. You will need to attach this account to a specific warehouse or tasting room. All FedEx shipping orders generated with that location as the ship-from warehouse will use the secondary account. All other locations will use the primary account.

Creating UPS Orders

Once the UPS  integration is enabled, you will see UPS rates populate on all of our order-taking platforms. This includes Point of Sale, Webstore, Enter Orders, and Wine Club. Based on the services available with your UPS account, those options will populate on your orders with the associated rates.

If you would like any of these rates hidden, please reach out to the helpdesk. If you do not see any rates applying, please check that all of the items in the cart have a weight associated with them in the Catalog Manager. The way OrderPort and UPS communicate is based on the weight of the items and the address to determine the shipping rates.

FAQ's

Is it possible to deliver wine shipments to a licensed UPS location at the customer's request?

Wine shipments can, at the request of the customer, be delivered to licensed USP stores. This doesn’t require any change to the status of a business’s shipping account. The winery will enter the address for a UPS location selected by the customer and specify HOLD AT LOCATION in the Company Name. The person entering the information will then have to make sure to select UPS as customer's preferred shipper in the shipping address window for the specified club. 

The package will be held for 5-7 business days, depending on the location. If the customer doesn't come pick it up during that allotted, it will be returned to the winery.

Why did I get an Invalid Zip code or Address Error

When you get an "Invalid Address" error make sure your address is correct first using the Zip code lookup tool https://tools.usps.com/go/ZipLookupAction_input. When you get this error message, it usually means that the billing address does not match the same one used on the credit card. To fix this you must change the card on file address by going into the Customer module and searching up the customer. After this you can release the order.

On the checkout screen in the POS, when I select "Ship", no shipping options appear. Why would this happen? 

There are two reasons why this could be happening:

1. The zip code of the address you are trying to ship to could be incorrect.

2. You just added a new item to your Catalog Manager and you forgot to add weight to your product. Go into Catalog Manager > Go to your item > Add a non-zero weight

UPS Error 2500002

 If you get the error UPS: 2500002 please make sure you added the correct products shown on #6 and the Callback URL shown on #7 has been entered. This error means the integration hasn't been set up properly.

"Wine Shipping Restricted Due to State Laws" Error

In OrderPort Administration:

This means that you do not have a valid shipping license for the address in question. To fix this, go to Sales Tax & Licenses > State Licenses and ensure that you have a valid license for each state that you are willing and able to ship to.