UPS配送方式集成从SOAP迁移到RESTful API

注意： 如果您在2024年6月6日之前上载了本文中的三个修补程序中的任何一个：如果您因未使用度量系统/SI测量（千克和厘米）而遇到此问题，则应再次为您的Adobe Commerce/Magento Open Source 2.4.4+/2.4.5+/2.4.6+版本重新应用本文中发布的这些新的更新修补程序之一，因为否则您将无法选择 千克 和以下的Metric System/SI测量 厘米 （在 管理员配置 的UPS配送方式中）。 这些新修补程序与以前发布的修补程序兼容。 此问题将在计划于 2024年6月11日 发行的即将发布的Adobe Commerce版本2.4.7-p1的范围内永久修复。

注意： 如果您在2023年10月10日 之前上载了本文中的三个修补程序中的任意一个，则应再次为您的Adobe Commerce/Magento Open Source 2.4.4+/2.4.5+/2.4.6+版本应用本文中现在发布的这些修补程序之一，因为否则，您将无法在 管理员配置 中选择和配置特定的UPS配送方式，并且必须启用所有这些方法。 这些新修补程序与以前发布的修补程序兼容。

本文提供了一个补丁，用于解决 Adobe Commerce 2.4.4 - 2.4.6-pX 的 United Parcel Service (UPS) 发货方式集成从 SOAP 迁移到 RESTful API 这一问题。

根据UPS API安全模型的最新更新，UPS已为所有API实施了OAuth 2.0安全模型（有关详细信息，请参阅UPS开发人员门户访问密钥迁移指南），以提高整体安全性，从而减少欺诈行为并提供增强的API功能。

此更改会影响我们当前在Adobe Commerce中实施的UPS配送方式，并要求我们修复当前的实施并从SOAP API迁移到RESTful API，以便能够支持OAuth 2.0身份验证协议。

从2024年6月开始，Adobe Commerce商家将无法使用我们当前的UPS集成进行交易，因此我们将发布此修补程序，以便让Adobe Commerce 2.4.4+/2.4.5+/2.4.6+商家迁移到最新的UPS REST API。

此问题将在Adobe Commerce/Magento Open Source版本2.4.7中修复，此修复还将包含在2023年10月的2.4.7-beta2版本中。

描述 description

受影响的产品和版本

云基础架构和内部部署上的Adobe Commerce以及Magento Open Source：

原因

UPS为其API发布了安全更新。

如果您将欧盟（其他来源可能遇到相同问题）作为发运来源地，则会在UPS REST请求中导致错误：
“装运不能以KGS/IN、LBS/CM或OZS/CM作为其度量单位。”

解决方法 resolution

解决方案

根据您的Adobe Commerce/Magento Open Source版本，使用以下附加的修补程序：

要解决2.4.4+、2.4.5+和2.4.6+版本中的问题，必须将相应的修补程序应用于下面的Adobe Commerce/Magento Open Source版本。

Patch

根据您的Adobe Commerce/Magento Open Source版本，使用以下附加的修补程序：

对于版本2.4.4、2.4.4-pX：

对于版本2.4.5、2.4.5-pX：

对于版本2.4.6、2.4.6-pX：

如何应用修补程序

解压缩文件，并在我们的支持知识库中参阅如何应用Adobe提供的编辑器修补程序获取相关说明。

如何判断是否已应用修补程序

考虑到无法轻松检查问题是否已修补，您可能需要检查修补程序是否已成功应用。 它使用（例如：AC-9363）作为要检查的修补程序。

您可以通过以下步骤执行此操作：