黑貓物流 x WooCommerce

外掛功能說明

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

外掛設定

串接設定

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

image

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

image

一般設定

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

商店設定

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

image

配達時間設定

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

託運單設定

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;
}