联合包裹服务(UPS)

联合包裹服务(UPS)向220多个国家提供国内和国际陆运和空运服务。

IMPORTANT
从2024年6月开始,Adobe Commerce商户无法再使用当前的UPS集成进行交易。 这是因为本机Adobe Commerce集成使用的United Parcel Service (UPS) API当前不支持所需的OAuth 2.0安全模型。 要了解有关此更改的更多信息,请参阅 开发人员门户访问密钥迁移指南.
商家应该 应用质量补丁程序更新 ,以便从SOAP API迁移到RESTful API,后者支持OAuth 2.0身份验证协议。
NOTE
UPS可以使用 维度权重 以确定一些运费。 但是,Adobe Commerce仅支持基于重量的运输成本计算。

步骤1:打开UPS发运帐户

要向客户提供此配送方式,您必须首先使用UPS开立帐户。

步骤2:为您的存储启用UPS

  1. 管理员侧栏,转到 Stores > Settings>Configuration.

  2. 在左侧的面板中,在 Sales,选择 Delivery Methods.

  3. 展开 扩展选择器 UPS 部分。

  4. 设置 Enabled for CheckoutYes.

  5. 对于UPS REST帐户(默认),请执行以下操作:

    • 输入您的UPS凭据:UPS客户端ID User ID,UPS客户端密钥为 Password

    • 设置 ModeLive 通过安全连接将数据发送到UPS运输系统。 (开发模式不会通过安全连接发送数据。)

    • 验证 Gateway URL 发送请求时所需的属性。 将沙盒URL用于测试模式,将生产URL用于实时请求。

    • 验证 Tracking URL 获取跟踪信息所必需的。 将沙盒URL用于测试模式,将生产URL用于实时请求。

    • 设置 Origin of the Shipment 到发运所在的区域。

    • 如果您对UPS有特殊费率,请设置 Enable Negotiated RatesYes 然后输入六位数字 Shipper Number 由UPS分配给您。

    • 设置 Live Account 更改为以下任一项:

      • Yes — 在生产模式下运行UPS,并将UPS作为配送方式提供给您的客户。
      • No — 在测试模式下运行UPS。
    note note
    NOTE
    标准联合包裹服务类型已计划弃用。 对于新配置,使用默认值 United Parcel Service REST 类型。 还需要使用REST类型生成 配送标签.

    对于2.4.7版本, UPS Type 已删除,因为 UPSUPS XML 已计划弃用和 UPS REST 是默认值。 本机Adobe Commerce集成使用的United Parcel Service (UPS) API暂时被弃用,因为它当前不支持OAuth 2.0安全模型。
    note important
    IMPORTANT
    UPS将停止支持HTTP,它用于当前默认值(系统值)。 清除 Use system value 复选框,并修改URL以使用HTTPS。 示例: https://www.ups.com/using/services/rave/qcostcgi.cgi
  6. 对象 Title,输入此送货选项的名称,以使其在结帐时显示。

    默认情况下,此字段设置为 United Parcel Service.

    启用UPS {width="600" modal="regular"}

步骤3:完成容器说明

  1. 设置 Packages Request Type 更改为以下任一项:

    • Use origin weight (few requests)
    • Divide to equal weight (one request)
  2. 对象 Container,指定用于装运的典型包装类型:

    • Customer Packaging
    • UPS Letter Envelope
    • Customer Supplied Package
    • UPS Tube
    • PAK
    • UPS Express Box
    • UPS Worldwide 25 kilo
    • UPS Worldwide 10 kilo
    • Pallet
    • Small Express Box
    • Medium Express Box
    • Large Express Box
  3. 设置 Weight Unit 用于测量产品重量的系统。

    UPS支持的重量系统因国家/地区而异。 如有疑问,请询问UPS您应该使用哪个配重系统。 选项包括:

    • LBS
    • KGS
  4. 设置 Destination Type 更改为以下任一项:

    • Residential — 您的发货大部分是企业对消费者(B2C)。
    • Commercial — 您的大多数发货都是企业到企业(B2B)。
  5. 输入 Maximum Package Weight 运营商允许。

  6. 设置 Pickup Method 更改为以下任一项:

    • Regular Daily Pickup
    • On Call Air
    • One Time Pickup
    • Letter Center
    • Customer Counter
  7. 输入 Minimum Package Weight 运营商允许。

    容器说明 {width="600" modal="regular"}

第4步:设置手续费

处理费是可选的,显示为额外费用,将添加到UPS运输成本中。 如果要包括手续费,请执行以下操作:

  1. 设置 Calculate Handling Fee 更改为以下方法之一:

    • Fixed
    • Percent
  2. 要确定如何应用手续费,请设置 Handling Applied 更改为以下任一项:

    • Per Order
    • Per Package
  3. 输入 Handling Fee 将被收费。

    要输入百分比,请使用小数格式。 例如,输入 0.25 25%。

    手续费 {width="600" modal="regular"}

步骤5:指定允许的方法和适用的国家/地区

  1. 对象 Allowed Methods,选择可供客户使用的各种UPS配送方式。

    签出期间,这些方法显示在UPS下。 要选择多种方法,请按住Ctrl键(PC)或Command键(Mac)并单击每个选项。

  2. 如果您要提供 免费送货 选项通过UPS,设置免费送货选项:

    • 设置 Free Method 到您要用于免费配送的方法。 如果您不想通过UPS提供免费送货服务,请选择 None.

    • 要要求最低订单金额,以便能够使用UPS免费发运订单,请设置 Enable Free Shipping ThresholdEnable. 然后,输入最小值 Free Shipping Amount Threshold.

  3. 如果需要,请更改 Displayed Error Message.

    此文本框预设了默认消息,但您可以输入在UPS不可用时要显示的其它消息。

    允许的方法 {width="600" modal="regular"}

  4. 设置 Ship to Applicable Countries 更改为以下任一项:

    • All Allowed Countries — 来自所有客户的客户 国家/地区 在商店配置中指定的可使用此投放方法。
    • Specific Countries — 选择此选项时, 发运至特定国家/地区 列表出现。 选择列表中可使用此投放方法的每个国家/地区。
  5. 设置 Show Method if Not Applicable 更改为以下任一项:

    • Yes — 列出结账期间所有可用的UPS配送方式,包括不适用于配送的方法。
    • No — 仅列出适用于发运的UPS发运方法。

    适用的国家/地区 {width="600" modal="regular"}

  6. 要创建包含从您的商店发出的UPS装运详细信息的日志文件,请设置 DebugYes.

  7. 对象 Sort Order,请输入数字以确定在结账期间与其他交付方法一起列出UPS时的显示顺序。

    0 =第一个, 1 =秒, 2 =第三,依此类推。

  8. 单击 Save Config.

步骤6:设置发运来源地址

  1. 确保您的 存储信息 完成。

  2. 管理员 侧栏,转到 Stores > Settings>Configuration.

  3. 在左侧面板中,展开 Sales 并选择 Shipping Settings.

  4. 展开 扩展选择器 Origin ,并配置送货来源地址。

    销售配置 — 发货地址选项 {width="600" modal="regular"}

  5. 单击 Save Config.

NOTE
Commerce在计算运费时不会向UPS声明完整的订单价格。 此行为无法更改。
recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1