UPS Authentication and API Changes


Userlevel 6
Badge

⚠️ Update Dec 11, 2023: The OAuth 2.0 and new API changes have been rolled out to Acumatica starting with 2023 R1 Update 13 and 2023 R2 Update 4. Configuration steps for using the new API and OAuth 2.0 will be available in the Acumatica help files soon. In the meantime, follow this link to the UPS Rest Configuration guide.

 

UPS recently published an announcement and how connection is established to their API. Partners or customer may have received the following notification. Acumatica is aware of this. Development work to address this change is being prioritized to address it in second-half of 2023.

The changes impact the Acumatica direct UPS integration in 2 ways:

  • New OAuth 2.0 for authentication. Since UPS is not issuing API access keys beginning June 5, 2023, which is how Acumatica performs authentication today, new customers or those in the process of implementation are immediately affected. The current workaround is to use our carrier aggregator integrations such as EasyPost or ShipEngine.
  • Acumatica’s integration was built on what UPS now refers to as “Legacy SOAP API” and needs to be upgraded to the new “RESTful API”. All existing customers who are already using the integration will be affected. However, they can continue to use the current integration until June 3, 2024.

Since the version of the API that is currently being used does not support OAuth 2.0, Acumatica will need to address both of these changes in the context of the same update. As in, we plan to switch to OAuth 2.0 for authentication as well as upgrade the integration to use the new RESTful API. We are hoping to roll these changes out to a minor update to some of the earlier Acumatica versions but this is TBD.


47 replies

Userlevel 6
Badge

​@donnadeskins55 are you still experiencing this? If so, please create a case with our support team so we can investigate further.

Userlevel 5
Badge +1

Hi @Irina 

I’m having the same issue with not seeing the UPS REST selection in the dropdown when I try to create the new carrier.

I followed the instructions in your article and updated the license on the ACTIVATE LICENSE screen. However, when I go to the Enable/Disable screen, I don’t see the list of different carriers. This is what I see:

 

 

This is the version of Acumatica the customer is on:

 

 

Thanks so much for all of the information shared here, it has been so helpful!

Userlevel 3
Badge

Hi @caseyh35,

It is likely due to a needed license upgrade, see post below.

We went through the same thing, it was surprise to us as well.

 

@cdelacruz Interesting, I will look into that. I am currently on 22R2 though and we have no issue. It looks like we shouldn’t have this function working currently if that is the case. Thanks for sharing

Userlevel 2
Badge

Hi @caseyh35,

It is likely due to a needed license upgrade, see post below.

We went through the same thing, it was surprise to us as well.

 

Userlevel 3
Badge

Hello @Omar Ghazi and others,

I am trying to complete step 5 from your UPS Rest Configuration guide in my upgrade sandbox (23 R2) but I am not able to see any plug-in types at all. Any idea what is causing this? I already have the legacy UPS type in use in my live environment, but neither provide the option for the rest connection (or any others for that matter). Any insight would be appreciated.

Our upgrade build is 23.212.0024, and I have the ‘Shipping Carrier Integration’ feature enabled as well.

 

 

Userlevel 2
Badge

@debbiereed72 

Thank you.

Userlevel 2
Badge

@cdelacruz - Omar updated the document with the production endpoints:

https://acumatica-builds.s3.amazonaws.com/builds/zip/software/addon/ups/UPS+Rest+Configuration.pdf

Userlevel 2
Badge

Would someone please confirm the UPS production endpoints, I can’t seem to find them.

Thanks in advance.

Userlevel 2
Badge

THANK YOU, @Omar Ghazi 

Userlevel 6
Badge

@debbiereed72 thank you for bringing this issue up and sorry you had to go through the hunt to find the production URLs. We have updated the configuration guide to include this information. 

Userlevel 7
Badge

Thank you for sharing your solution with the community @debbiereed72!

Userlevel 2
Badge

In case anyone else struggles like I did (The UPS Developer site is written for developers, which I am not) -API Documents | UPS - United States

I finally found on the right-hand side you can select Try It, then click on the box under Target Server and see the URL’s.

I hope this is correct - it seems to pass the test in the Carrier Integration screen in Acumatica.

I hope this saves someone else the frustration.

 

 

Userlevel 2
Badge

@Omar Ghazi - I have followed all the documentation and trying to understand how to read the API developer information in UPS.  How do I get the Endpoints for production?  I am lost here.  Thank you

Userlevel 2
Badge

Can anyone advise what goes in the callback URL field on the UPS end of this? I noticed someone else posted this screenshot and it was not populated. We have a client setting this up right now and are wondering what to enter here.

 

You dont need anything in there

Just make sure you have the products setup

 

Can anyone advise what goes in the callback URL field on the UPS end of this? I noticed someone else posted this screenshot and it was not populated. We have a client setting this up right now and are wondering what to enter here.

 

Userlevel 6
Badge

@alanconroynaw please create a support ticket with us for this bug that you found in 2023 R1 version. 

Userlevel 2
Badge

@MattWSM - we found this bug for some users and pushed a fix with 2023 R2 Update 10 (23.210).

@Omar Ghazi 

I have the same bug in 23.114  has there been a fix published for 2023R1?

Userlevel 6
Badge

@debbiereed72 Good question! UPS switched to REST-based so please use the PX.UpsRestCarrier.UpsRestCarrier. This is also in the configuration guide (linked with the original post) and the help files will have this information as well.

 

The PX.UpsCarrier.UpsCarrier as of now will not work any longer and will be removed as an option in a future Acumatica release.

Userlevel 1

Debbie,

You will want to use the UPSRestCarrier, and if you will be shopping for rates, you will want to update Acumatica to at least build 210 or you will not get rates if you have a package greater than 50 lbs.

Userlevel 2
Badge

Hi all -- appreciate all the information here, but I am just confused.  2023R2 - 23.207.0025.

Which Plug-In is supposed to be used? And, how do we decide which is correct?

 

 

Badge

@Omar Ghazi - Thank you for the update.  We will discuss getting the update from our VAR.

 

Userlevel 6
Badge

@MattWSM - we found this bug for some users and pushed a fix with 2023 R2 Update 10 (23.210).

Badge

@Omar Ghazi   Thanks for the quick reply.

We are on Build 23.204.0031

 

 

Userlevel 6
Badge

@MattWSM which Acumatica version are you working on?

Badge

We have implemented the UPS Integration and when I test the connection from the Carriers Screen I get a “Sucessful” message.  However on the shipments screen I am receving the folowing error when “shopping” for rates:

Can anyone shed some light on what might be driving this error?

Reply


About Acumatica ERP system
Acumatica Cloud ERP provides the best business management solution for transforming your company to thrive in the new digital economy. Built on a future-proof platform with open architecture for rapid integrations, scalability, and ease of use, Acumatica delivers unparalleled value to small and midmarket organizations. Connected Business. Delivered.
© 2008 — 2024  Acumatica, Inc. All rights reserved