Upcoming Changes to UPS API
UPS recently announced an upcoming change to their API. We use this API to allow you to return UPS shipping rates on your shipping methods.
Don’t worry! We are aware of this change and working to update our integration with the new UPS API prior to the June 3rd 2024 sunset of the current API.
What do I need to do?
- If you currently use UPS rates and have API keys – please do not disable any existing Access keys that are being used, as you may not be able to get a new legacy access key.
- Prior to June 3, 2024 – you will need to update your site to use the new UPS API. We will provide information on how to do so once our integration has been updated.
If you have any immediate questions or concerns, please submit a task for our Support Team.
Update 9/25/2023
Sites on the new core versioning (versions 202 and later)[Internal versions 3.x and 4.x] can now request an update to release 2023.09 or later to be able to update to the new credentials. Information below on getting new credentials. These credentials should work with standard package rating, Shipping Address validation (for those sites with this in scope), and UPS Freight (for those sites with this in scope).
For sites on our classic versions (not the core versions mentioned above) we understand it may not be possible to complete migration projects in time to be on core versions when the UPS stops allowing the existing “old” connection method and we are working on a way to handle the new credentials on these sites. We expect to have something on this by the end of the year.
Getting new UPS 0Auth credentials
To obtain the new credentials for UPS you can follow the information from UPS as noted here – https://developer.ups.com/get-started?loc=en_US
On this page select option 5 – Obtain your OAuth Credentials
After following this process you it will generate a Client ID and Client Secret. These are what you will add to the CIMcloud platform to return rates. It is recommended that you copy these and store them securely somewhere like a password manager for future reference if needed.
Once you have these credentials they can be added to the CIMcloud platform.
Adding UPS Credentials to Core Versioned Sites (Release 2923.09 and greater)
Once you have the above credentials you can add them to the site in Application Settings > Shipping
Choose the option Use UPS Integration? [Not he option that says (Legacy)]
Enter the Client ID, Client Secret, Shipper Number (If you want Client Specific rates), and then select the type rates (Negotiated Rates, Daily Published Rates, Retail Rates, General List Rates, Standard List Rates).
You can validate the credentials with the Test Credentials button.
Save the new credentials.
Go to the sitefront and test some orders to validate the shipping return.
Once populated these are the rates that should be used. You can leave any legacy setting in place if you need to switch back for any reason. To switch back just remove the new settings and save.
