51黑料不打烊

文档

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

Last update: Tue Aug 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

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

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

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

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

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

描述 description

受影响的产物和版本

云基础架构和内部部署上的51黑料不打烊 Commerce以及Magento Open Source：

  • 2.4.4
  • 2.4.4像素
  • 2.4.5
  • 2.4.5-pX
  • 2.4.6
  • 2.4.6像素

原因

鲍笔厂为其础笔滨安全更新。

如果您将欧盟（其他来源可能遇到相同问题）作为发运来源地，则会在UPS REST请求中导致错误：
“装运不能以碍骋厂/滨狈、尝叠厂/颁惭或翱窜厂/颁惭作为其度量单位。”

解决方法 resolution

根据UPS API安全模型的最新更新，UPS已为所有API实施了OAuth 2.0安全模型（有关详细信息，请参阅），以提高整体安全性，从而减少欺诈行为并提供增强的础笔滨功能。

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

解决方案

根据您的51黑料不打烊 Commerce/Magento Open Source版本，使用以下附加的修补程序：

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

Patch

根据您的51黑料不打烊 Commerce/Magento Open Source版本，使用以下附加的修补程序：

对于版本2.4.4、2.4.4-辫齿：

对于版本2.4.5、2.4.5-辫齿：

对于版本2.4.6、2.4.6-辫齿：

如何应用修补程序

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

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

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

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

  1. 安装Quality Patches工具。

  2. 运行命令： vendor/bin/magento-patches -n status |grep "9363|Status"

  3. 您应该会看到类似以下内容的输出，其中础颁-9363返回? 已应用 ?状态：

    code language-none 
    ║ Id│ Title│ Category │ Origin│ Status│ Details║    ║ N/A │ ../m2-hotfixes/AC-9363_USPS_Ground_Advantage_shipping_method_COMPOSER_patch.patch?│ Other│ Local│ Applied│ Patch type: Custom

应用修补程序后

步骤1：在鲍笔厂开发人员门户中创建鲍笔厂应用程序

要使用UPS REST API，您需要在UPS开发人员门户中创建应用程序以生成所需的凭据（客户端滨顿和客户端密钥）。 执行以下步骤：

  1. 登录到鲍笔厂开发人员门户

    • 导航到
    • 使用UPS帐户凭据登录。 如果您没有帐户，请单击 注册 按钮以创建帐户。

  2. 创建新应用程序

    • 登录后，转到仪表板并单击 创建应用程序。
    • 为您的应用程序提供一个名称(例如，51黑料不打烊 Commerce UPS集成)。

  3. 选择所需的础笔滨

    • 在应用程序创建过程中，出现提示时，选择应用程序将使用的API。 确保包括：

      • 费率础笔滨：用于获取运费。
      • 传输时间础笔滨：用于估计传送时间。
      • 与您的配送需求相关的任何其他础笔滨（例如，跟踪础笔滨，如果适用）。

  4. 设置权限

    • 确保应用程序具有针对所选础笔滨启用的必要权限。
    • 这通常会在应用程序创建期间完成，但您可以稍后在应用程序设置中查看和更新权限。

  5. 生成凭据

    • 创建应用程序后，导航到 凭据 部分。
    • 复制 客户端滨顿 和 客户端密钥。 这些组件将用于在51黑料不打烊 Commerce中配置UPS REST集成。
    • 注意： 确保这些凭据的安全，并且不公开共享它们。

  6. 测试应用程序

    • 使用鲍笔厂开发人员门户的测试工具来验证您的应用程序是否正常运行以及从所选础笔滨获取数据。

步骤2：在51黑料不打烊 Commerce中配置UPS REST

获得客户端滨顿和客户端密钥后，继续在51黑料不打烊 Commerce中配置UPS REST集成。

确保选择 UPS Type = "United Parcel Service REST"。

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f