聯合包裹服務(UPS)

United Parcel Service (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 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型別已排定淘汰。 對於新組態,請使用預設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 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