物流商/API設定
章節目錄：
一、啟用API串接說明 >
二、建立物流商資料 >
三、啟用物流商API串接
1、【新竹物流】API設定說明
2、【黑貓宅急便】API設定說明
3、【嘉里大榮】API設定說明
一、啟用API串接說明
若不需使用則可略過此步驟提供［新竹物流］／［黑貓］／［嘉里大榮］，可啟用API 串接，依據電商訂單/銷貨單資料 自動上傳託運單並取得託運單號，單號產生號即可直接列印託運標籤，以節省整理核對資料的印單時間，提昇出貨效率
首先請先向物流公司申請API串接需求，並依對方所回覆的API授權資料， 正確填入以下相關資訊，才可順利進行串接
二、建立物流商資料
建立前請先完成【寄件人管理】資料建立
開啟左邊主選單【物流好幫手】-【物流商設定】，然後按【新增】
開啟後建立物流商資料
1、【物流商】：必填，下拉選擇設定的物流商，
目前預設內容有：【新竹物流】、【黑貓宅急便】、【嘉里大榮】
、【宅配通】、【中華郵政】、【便利帶】、【自訂】
【自訂】用於非以上物流的選擇
選擇嘉里大榮時出現提示訊息"注意!!不支援蝦皮預設的嘉里快遞之託運單列印，需由蝦皮後台執行出貨印出"
因蝦皮在物流寄送也有和嘉里大榮配合，若用蝦皮預設的則不能在A1的託運單印，當蝦皮那邊按出貨時也會有大榮的託運號，就要依蝦皮的託運號由蝦皮發起派出的大榮物流來收貨，依蝦皮產生的託運單寄送，才能順利完成蝦皮的出貨，所以蝦皮配合的大榮不可以在A1列印託運單喔！
2、【物流名稱】：請填寫您方便辨識選擇的名稱，一般填寫物流商的公司名稱及可區分寄件的重點文字
3、【溫層】：預設【常溫】，下拉可選【常溫】、【冷藏】、【冷凍】
4、【材積重量】：例如黑貓、宅配通就不需要輸入【材積重量】，新竹物流就只需預設【材積重量】欄不用設定尺寸欄，請依物流商的要求設定資料
5、【尺寸】：內容選項【60cm】、【90cm】、【120cm】及【150cm】
6、【代收金額】：勾選表示會請物流商和客戶收銷貨的貨款金額，因此系統會將銷售的金額預帶在代收金額欄位，若無勾選，則代收金額都會先預設空白，要自行填寫代收金額喔
7、【寄件人】：下拉選單，要先在【寄件人】作業先建立才能下拉選擇
三、啟用物流商API串接
【啟用API串接】：已申請API後打勾填入相關資料
同一物流商，可設定多筆物流資料，可輸入同一組API 帳號/密碼
例如：新竹物流-大物、新竹物流-小物
或若有些單沒有要在A1列印託運單，但要在【待出貨訂單】或【銷貨單】做【託運轉出】產生Excel，則建議格式可分二種，例如新增【物流名稱】為"黑貓(不收款)"及"黑貓(不收款)(API)"，當不列印託運單的單據就可以選擇"黑貓(不收款)"，而需而印【託運單】的部份就可用"黑貓(不收款)(API)"，但是否要區分出來還是可自行決定，只要應用時方便又可符合物流公司要求的規定即可。
1、【新竹物流】API設定說明7、【寄件人】：下拉選單，要先在【寄件人】作業先建立才能下拉選擇
三、啟用物流商API串接
【啟用API串接】：已申請API後打勾填入相關資料
同一物流商，可設定多筆物流資料，可輸入同一組API 帳號/密碼
例如：新竹物流-大物、新竹物流-小物
或若有些單沒有要在A1列印託運單，但要在【待出貨訂單】或【銷貨單】做【託運轉出】產生Excel，則建議格式可分二種，例如新增【物流名稱】為"黑貓(不收款)"及"黑貓(不收款)(API)"，當不列印託運單的單據就可以選擇"黑貓(不收款)"，而需而印【託運單】的部份就可用"黑貓(不收款)(API)"，但是否要區分出來還是可自行決定，只要應用時方便又可符合物流公司要求的規定即可。
【新竹物流】-【啟用API串接】打勾啟用，並將申請到的API資訊填入
(1)【訂單號碼依據】：在託運單列印後的憑證預帶的單號，
建議選擇用【電商訂單單號+3亂碼】
選項預設【銷貨單號+3亂碼】，下拉可選擇【電商訂單單號+3亂碼】
如有電商平台建議可改選為【電商訂單單號+3亂碼】，包貨完貼標時方便以電商單號
核對託運單。
訂單號碼依據為【電商訂單單號+3亂碼】時，若用自行新增的【銷貨單】產生託運單
因無電商訂單單號，此時系統就會自動再以銷貨單號+3碼亂碼帶入列印。
加上3碼亂碼是安全機制，避免發生單號重覆狀況的預防號碼。
(2)【列印單別】：格式可選【A4】、【100*100】或【100*150】，【A4】為標籤列印預設值，請依需求選入(託運單列印時，會依此設定印出)
(3)【公司名稱】：請填入公司名稱(API帳號)
(4)【取託運編號密碼】：請填入相對應資料
(5)【取託運狀態金鑰】：請填入相對應資料
(6)【取託運狀態加密向量】：請填入相對應資料
(7)【取託運狀態v值】：請填入相對應資料
(8)【取託運編號密碼】：請填入相對應資料
(9)【取託運狀態金鑰】：請填入相對應資料
(8)【取託運編號密碼】：請填入相對應資料
(9)【取託運狀態金鑰】：請填入相對應資料
(11)【計費方式】：預設"一般計費"，可下拉選擇"總長計費"
參考 新竹物流 API開通後 核發信件 內容
2、【黑貓宅急便】API設定說明
【黑貓宅急便】-【啟用API串接】打勾啟用，並將申請到的API資訊填入
(1)【訂單號碼依據】：在託運單列印後的憑證預帶的單號，
建議選擇用【電商訂單單號+3亂碼】
選項預設【銷貨單號+3亂碼】，下拉可選擇【電商訂單單號+3亂碼】
如有電商平台建議可改選為【電商訂單單號+3亂碼】，包貨完貼標時方便以電商單號
核對託運單。
訂單號碼依據為【電商訂單單號+3亂碼】時，若用自行新增的【銷貨單】產生託運單
因無電商訂單單號，此時系統就會自動再以銷貨單號+3碼亂碼帶入列印。
加上3碼亂碼是安全機制，避免發生單號重覆狀況的預防號碼。
(2)【列印單別】：為標籤列印預設值，格式提供【A4二模宅配】和【A4三模宅配】，請依需求選入(託運單列印時，會依此設定印出格式)
(3)【契客代號】：請填入契客代號（若有多組契客代號，須分開申請授權碼）
(4)【正式環境授權碼】：請依黑貓回覆mail內容填入
(5)【商品類別】：依需求選擇商品類別
設定完成後按【儲存】存檔。
參考 黑貓 API開通後 核發信件 內容
向窗口申請，若申請不順利可試試
黑貓技術客服電話:02-26275861 (會先詢問契客代號，請先準備好)
申請時要說明是申請API 哦，否則可能會以為是黑貓系統EZCat的授權碼
3、【嘉里大榮】API設定說明
【嘉里大榮】-【啟用API串接】打勾啟用，並將申請到的API資訊填入
(1)【訂單號碼依據】：在託運單列印後的憑證預帶的單號，
建議選擇用【電商訂單單號+3亂碼】
選項預設【銷貨單號+3亂碼】，下拉可選擇【電商訂單單號+3亂碼】
如有電商平台建議可改選為【電商訂單單號+3亂碼】，包貨完貼標時方便以電商單號
核對託運單。
訂單號碼依據為【電商訂單單號+3亂碼】時，若用自行新增的【銷貨單】產生託運單
因無電商訂單單號，此時系統就會自動再以銷貨單號+3碼亂碼帶入列印。
加上3碼亂碼是安全機制，避免發生單號重覆狀況的預防號碼。
(2)【列印單別】：為標籤列印預設值，格式提供【10cm*10cm】, 託運單列印時，會依此設定印出格式
(3)【帳號】：請填入相對應資料
(4)【密碼】：請填入相對應資料
(5)【客戶代號】：請填入相對應資料
參考 大榮 API開通後 內容
向窗口申請，申請時提供【客戶編號】
說明已做好API串接功能，現在要申請API帳號開通
若窗口不明白或無法申請，請於上班時間在系統右上方【我要發問】和客服反應，
會請產品中心確認看看大榮該站所不能申請的情形
信件內容會有：【客編】、【帳號】、【密碼】及一年度由大榮貨運依貴司託運寄送情形做算的託運單號起迄區間
----------------------------------------
正式 API資訊如下再煩請查收謝謝
客編: xxxxxxxx
帳號: xxxxxxxxxxx
密碼: xxxxxxxx
常溫區間起: xxxxxxxxxxx
常溫區間迄: xxxxxxxxxxx