黑貓物流 x WooCommerce

外掛功能說明

  • 支援黑貓宅配(常溫、冷藏、冷凍)
  • 支援黑貓快速到店(常溫、冷藏、冷凍)
  • 支援貨態自動查詢更新
  • 支援貨態更新後自動變更訂單狀態
  • 託運單列印(可批次)
  • 支援結帳頁配達時間選擇(宅配)
  • 支援結帳頁超商選擇(快速到店)
  • 後台可重新選擇超商
  • 後台可手動修改包裹尺寸規格

外掛設定

串接設定

安裝完外掛後,請至 WooCommerce→設定→黑貓物流 中的 「一般設定」分頁,請於最下方的 API 設定中輸入黑貓提供的契約客戶代號,和契約客戶授權碼。

image

契約客戶授權碼的取得方式,請參考黑貓提供的文件「統一速達契約客戶印單API授權碼取得方式說明.docx」。若外掛啟用測試模式,請於申請時點選「測試站台」

image

一般設定

image
  1. 除錯紀錄:若啟用,會記錄黑貓外掛的相關執行資訊,建議啟用,方便在出問題時除錯。
  2. 自動建立託運單的訂單狀態:當訂單狀態改變為設定的狀態時,會自動執行建立託運單(即將資料拋單至網站)
  3. 限制使用者角色(可多選):若您要在正式網站上啟用外掛,但因為在測試中不想讓顧客使用,可以先限制使用者角色,這樣只有在設定中的使用者角色可以使用黑貓的運送方式。 測試完成記得取消設定。 若要多選可使用 cmd + click (mac) 或 ctrl + click (win)

商店設定

請輸入商店的基本資訊,這些資訊會在託運單建立時,透過 API 傳送給黑貓,請正確填寫

image

配達時間設定

image
  1. 在結帳頁面上顯示希望配達時間選項:若啟用,則消費者可在結帳頁面選擇希望的配達時間,呈現方式如下圖。
  2. image
  3. 預設配達時間:若沒有啟用結帳頁的配達時間選項功能,則會以這個設定作為配達時間的預設值

託運單設定

image

1.預設商品類別:請根據您商店的商品類別進行設定

2.託運單品名:是否要顯示實際的商品名稱在託運單上

3.自訂託運單品名:若不顯示實際的商品名稱,請輸入自訂的託運單品名,請注意不可包含限制的字元。

貨態與訂單狀態設定

可設定排程查詢貨態和訂單狀態變更的相關設定

image
  1. 當貨態定義為「配送中」時,將訂單狀態變更為:設定貨態定義為配送中的訂單狀態
  2. 當貨態定義為「配送完了」時,將訂單狀態變更為:設定貨態定義為配送完了的訂單狀態
  3. 當貨態定義為「退貨」時,將訂單狀態變更為:設定貨態定義為退貨的訂單狀態
  4. 當貨態定義為「異常」時,將訂單狀態變更為:設定貨態定義為異常的訂單狀態
  5. 貨態查詢時間間隔(以小時為單位):排程查詢貨態的時間間隔,建議時間為6小時,過小的查詢間隔可能造成系統負擔。
💡

詳細的貨態代碼可點擊「檢視貨態代碼表」

運送方式設定

你可以在 WooCommerce→設定→運送方式,來新增網站要提供的運送方式。

image
💡

若您的網站有不同溫層的商品,請先設定運送類別,在於運送方式中設定該類別是否可使用

運送類別是否可用

由於目前外掛不支援不同溫層的商品同時結帳,因此我們需要透過設定運送類別來區分不同的商品。以下圖為例,網站設定包含常溫、冷藏和冷凍三種運送類別。

運送類別設定範例
運送類別設定範例

然後再於「黑貓宅配-常溫」這個運送方式中,將「”常溫”可使用」這個選項啟用,其他運送類別則不啟用。

這樣當購物車中的商品包含了常溫這個運送類別,就能夠使用「黑貓宅配-常溫」這個運送方式

image

當購物車商品中的溫層衝突時

若欲加入購物車的商品溫層和購物車中的商品溫層衝突時,會顯示提示訊息。

以下圖為例,原本購物車中已經有一個溫層為冷凍的商品,此時我們加入了一個常溫的商品,就會無法加入購物車,並顯示提示訊息。

若消費者要購買不同溫層的商品,必須要分開結帳。

image

託運單管理

列印託運單

若網站停用自動託運單建立,則在您完成包貨後,需手動拋單(列印託運單)。

在手動列印託運單之前,您可先確認包裹尺寸是否需要調整,如果需要調整可先進行設定。

確認完包裹尺寸規格後,點擊「列印託運單」按鈕,即可完成拋單。

image

若列印成功,會自動於瀏覽器開啟新分頁,並顯示託運單 PDF,您可下載或直接列印。

image

下載託運單

若您忘記儲存託運單,可於24小時內重新下載託運單,請點擊「下載託運單」按鈕,同樣會於新分頁開啟 PDF 檔案。

image

重新建立託運單

若您未於24小時內下載列印託運單,則需要重新建立託運單。

當訂單內容有調整,例如收件地址變更,或是取件超商變更,同樣需要重新建立託運單。

批次列印託運單

您可於訂單清單中,批次列印託運單。若要列印宅配訂單,請點擊「黑貓宅配批次拋單(列印)」,若要列印快速到店訂單,請點擊「黑貓宅配快速到店批次拋單(列印)」。

點擊後會跳出一個彈出視窗,您可選擇要列印的訂單,然後點擊「列印宅配託運單」或是「列印快速到店託運單」,若成功則會新開分頁顯示託運單PDF

批次列印宅配訂單
批次列印宅配訂單
批次列印快速到店訂單
批次列印快速到店訂單

自訂收件人名稱

根據商店的需求,您可能需要自訂託運單上的收件人名稱,例如於姓名前加上會員編號。您可透過以下的方式來自訂託運單上的收件人名稱。

使用 wpbr_tcat_shipping_recipient_name 這個 filter 來自訂收件人名稱 。包含兩個參數,第一個參數為原始的收件人名稱,第二個參數是訂單物件 (WC_Order),您可透過訂單來得到消費者的使用者 ID,再透過使用者 ID 來讀取對應的資料。

add_filter( 'wpbr_tcat_shipping_recipient_name', 'customer_recipient_name', 10, 2);
function customer_recipient_name( $shipping_name, $order ) {
    $customer_id = $order->get_customer_id();
    $member_id   = get_user_meta( $customer_id, 'member_id', true );
    return $member_id . $shipping_name;
}