Updating UPS Refresh Tokens for Ship/FX

Overview

The UPS authentications will refresh each time a request is made to UPS. However, tokens have an expiration time that is typically 60 days from the time it was created. If no requests are made in 60 days, the token will expire. Complete the procedure below if your UPS token has expired to get a new token.

Requirements

You must have the following things to complete this procedure:

1. A web browser connected to the internet.
2. Your UPS credentials to log in to your account on the UPS site.
3. Access to Ship/FX Admin on the server where eFORMz runs. 
4. A password from Minisoft for the online OAuth token registration. Request the password from [e-mail].

Procedure

These steps should be completed in order without long breaks.

1. If you do not yet have a password for the online OAuth token registration, send a message to [e-mail] asking for one.
2. Open your browser and go to:

   1. https://oauth4ups0002.azurewebsites.net/

3. Authenticate with your email address and the password from Minisoft and click Login.
4. Click Authorize Minisoft Ship/FX UPS and you will be transferred to ups.com.
5. On the ups.com page:
   1. Click Log In and log in with your UPS credentials.
   2. Complete the questions, and you will be returned to the token page.
6. Copy all of the XML near the bottom, including <root> and </root>. This is your refresh token.
7. In your browser, start Ship/FX Admin. If you are on the server, you usually can open it as https://localhost:8000/aFORMz/SHIPFXAdmin. 
8. Go to ShipFX Configuration > 000001 > Domestic > USPS2 API:
   1. Click UPS under Carrier.
   2. On the right, click Update Authentication Credentials. 

Assistance

If any further assistance is needed, please contact our Support team.

Related Articles