⚠️ 申請物流幕後取號 API 開通
要正常使用外掛功能需要開通物流幕後取號 API 功能，若尚未開通請至統一金流下載申請書。
https://www.payuni.com.tw/docs/web/#/7/245
請將申請書中的 [啟用超商幕後] 和 [啟用物流幕後] 勾選，填寫完其他資料後傳送給統一金流窗口。
設定
設定主要分為以下幾個部分，後續各別說明設定內容
1.一般設定
2.商店設定
3.訂單狀態設定
4.黑貓物流設定
5.API 設定
一般設定
- 除錯紀錄：開啟除錯紀錄會在指定的路徑紀錄物流關資訊，建議開啟，方便出問題時除錯
商店設定
商店設定會在建立物流單時傳送給 PAYUNi
- 寄件人名稱：請輸入商店名稱
- 寄件人電話：請輸入商店的電話或聯絡人電話
訂單狀態設定
當物流貨態有更新時，PAYUNi 會通知網站，當網站收到通知時，可以根據收到的貨態來改變訂單狀態。訂單狀態支援自訂訂單狀態，您可以使用可自訂訂單狀態的外掛來達成，透過訂單狀態的改變，讓消費者可以更清楚目前商品的運送狀況。
目前支援的貨態更新有五個，包含：
- 產生物流編號時(貨態狀態碼 21)：當管理者在後台列印託運單標籤時，就會產生物流追蹤編號，代表商店已經準備出貨了。
- 商品位於物流中心時(貨態狀態碼 22)：此為超商物流才有的貨態，代表消費者的商品目前已經在物流中心。
- 商品運送中 (貨態狀態碼 31)：代表商品正在安排運送或運送中
- 商品抵達取件超商 (貨態狀態碼 32)：此為超商物流才有的貨態，代表消費者的商品已抵達取件超商，消費者可前往取件。
- 買家已取貨或收件 (貨態狀態碼 11)：當消費者已至超商取貨，或是已收到黑貓的包裹，網站即會收到此貨態
更多詳細的貨態請參考 物流貨態狀態碼。
黑貓物流設定
- 希望配達時間：包含三個選項：13:00 之前、14:00~18:00、不指定。此為統一的設定，目前無法讓消費者於結帳時選擇。
- 預計出貨日期：預設出貨日期預設為 1，代表出貨日期為列印標籤後的隔天。而預計到貨日期就會是出貨日期的隔天。假設列印托運單標籤的日期是 D，出貨日就會是 D+1，到貨日就是 D+2。
API 設定
- 測試模式：若開啟測試模式，會傳送資料至測試環境。若啟用，請輸入對應測試環境商店代號、Hash Key 和 Hash IV
- 商店代號、Hash Key 和 IV Key 請至後台 「會員>商店清單>指定商店名稱>串接設定」查詢。如下圖
設定貨態 Notify URL
當啟用超商或黑貓服務時，可設定貨態 Notify URL，請至後台「物流中心>物流設定>指定商店名稱」。點擊要設定的運送方式。
超商物流請設定網址：https://你的網址/wc-api/payuni_shipping_711_notify
黑貓宅配請設定網址：https://你的網址/wc-api/payuni_shipping_tcat_notify
新增運送方式
你可以在後台運送方式設定來新增運送方式，請選擇商店有申請的物流方式
超商店到店結帳流程
當使用者於結帳頁面選擇超取時，會出現選擇超商的按鈕。點擊選擇超商，會導向超商地圖。選擇好取貨超商後，會導回網站，並顯示選擇的超商資訊。
超商詳細資訊會顯示在結帳頁面中的運送資訊
結帳完成會在訂單的運送地址顯示超商資訊
另外會顯示物流資訊
如果是非即時付款(超商代碼繳費、虛擬帳號)，物流單不會馬上建立。當確定完成付款才會建立物流單。
當訂單已完成付款(訂單狀態改變為處理中)，會自動建立物流單，此時會顯示 UNi 物流序號(此序號非供消費者查詢的物流編號)
列印標籤&產生物流編號
當商店人員完成訂單商品包裹後，即可列印託運單標籤，列印托運單會同步產生可供消費者查詢的物流查詢編號。
當物流查詢編號產生，消費者在訂單內容即可看到相關資訊
