联合包裹服务(UPS)

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

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

步骤1:打开UPS发运帐户

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

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

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

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

  3. 展开​ UPS ​部分的 扩展选择器

  4. 将​ Enabled for Checkout ​设置为Yes

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

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

    • 将​ Mode ​设置为Live以通过安全连接将数据发送到UPS配送系统。 (开发模式不会通过安全连接发送数据。)

    • 验证发送请求所需的​ Gateway URL。 将沙盒URL (https://wwwcie.ups.com/)用于测试模式,将生产URL用于实时请求(https://onlinetools.ups.com)。 请确保对给定主机中的每个请求都使用各自的端点。

    • 验证获取跟踪信息所需的​ Tracking URL。 将沙盒URL (https://wwwcie.ups.com/)用于测试模式,将生产URL用于实时请求(https://onlinetools.ups.com)。 请确保对给定主机中的每个请求都使用各自的端点。

    • 将​ Origin of the Shipment ​设置为装运来源区域。

    • 如果您对UPS有特殊费率,请将​ Enable Negotiated Rates ​设置为Yes并输入UPS分配给您的六位数​ Shipper Number

    • 将​ Live Account ​设置为以下项之一:

      • Yes — 在生产模式下运行UPS,并将UPS作为配送方式提供给您的客户。 请确保在网关URL和跟踪URL下使用正确的端点。
      • No — 在测试模式下运行UPS。 请确保在网关URL和跟踪URL下使用正确的端点。
    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

    • 若要要求满足订单免费送货条件的最低订单金额,请将​ Enable Free Shipping Threshold ​设置为Enable。 然后,输入​ 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装运详细信息的日志文件,请将​ Debug ​设置为Yes

  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