應用場景
提供特店查詢及下載對帳報表CSV檔，透過此API可取得物流代收款項之撥款以及物流運費扣款等資訊。
API介接網址
- 測試環境：https://logistics-stage.ecpay.com.tw/
- 正式環境：https://logistics.ecpay.com.tw/
HTTPS傳輸協定
- Accept：text/html
- Content Type：application/x-www-form-urlencoded
- HTTP Method：POST
特店Request參數說明
PlatformID String(10)
特約合作平台商代號
- 由綠界科技提供，此參數為專案合作的平台商使用，一般廠商介接請放空值。
- 若為專案合作的平台商使用時，請帶賣家所綁定的MerchantID。
MerchantID String(10)
廠商編號 必填
由綠界科技提供
NumPerPage Int
單頁顯示筆數 必填
API 查詢結果以分頁形式回傳，此參數用於設定每頁的回傳筆數。
注意事項：為了保證系統效能和響應速度，單頁上限為300筆。
ShowingPage Int
顯示的頁數 必填
注意事項：查詢結果會根據[DateFilter]設定的日期類別，按照日期時間較新排列至較舊的。
DataType Int
回傳資料類型
Response回傳的資料類型
- 1：JSON(預設)
- 2：CSV
DateFilter String(1)
查詢日期條件 必填
要查詢的日期條件
- 1：訂單成立日期
- 2：物流運費扣款日期
- 3：異動後物流費扣/補款日期
- 4：物流代收款項撥款日期
BeginDate String(10)
查詢開始日期 必填
要查詢的開始日期
日期格式為「yyyy/MM/dd」
EndDate String(10)
查詢結束日期 必填
要查詢的結束日期
日期格式為「yyyy/MM/dd」
ShipChargeStatus String(1)
物流運費扣款狀態
查詢物流運費扣款狀態：
- 若為未扣款，請將參數設為 0。
- 若為已扣款，請將參數設為 1。
- 若查詢全部，請忽略此參數設定。
AllocateStatus String(1)
物流代收款項撥款狀態
查詢物流代收款項的撥款狀態：
- 若為未撥款，請將參數設為 0。
- 若為已撥款，請將參數設為 1。
- 若查詢全部，請忽略此參數設定。
LogisticsType String(20)
物流類型
- CVS：超商取貨 (含B2C及C2C)
- HOME：宅配
- 若查詢全部，請忽略此參數設定。
LogisticsSubType String(20)
物流子類型
- 大宗寄倉超商取貨(B2C)
FAMI：全家
UNIMART：7-ELEVEN超商
UNIMARTFREEZE：7-ELEVEN冷凍店取
HILIFE：萊爾富 - 超商門市寄/取貨(C2C)
FAMIC2C：全家店到店
UNIMARTC2C：7-ELEVEN超商交貨便
HILIFEC2C：萊爾富店到店
OKMARTC2C：OK店到店 - 宅配(HOME)
TCAT：黑貓
POST：中華郵政
注意事項：
- 若要查詢全部時，請忽略此一參數
CheckMacValue String
檢查碼 必填
請參考附錄檢查碼機制
注意事項：當DataType=1時，回傳資料為JSON格式
回傳Data參數說明(JSON格式)
RtnCode Int
回應代碼
1 代表 API 執行成功，其餘代碼均為失敗，失敗代碼請參考交易訊息代碼表。
RtnMsg String(200)
回應訊息
TotalCount Int
總筆數
ShowingPage Int
目前顯示的頁數
LogisticsData Array[Object]
物流訂單資料
TradeDate String(20)
訂單成立時間
格式為：yyyy/MM/dd HH:mm:ss
MerchantTradeNo String(20)
廠商訂單編號
AllPayLogisticsID String(20)
綠界物流訂單編號
MerchantID String(9)
廠商編號
GoodsAmount Int
商品金額
ReceiverName String
收件人姓名
ReceiverPhone String(20)
收件人市話
ReceiverCellPhone String(10)
收件人手機
LogisticsType String(20)
物流類型
請參考物流方式一覽表
LogisticsSubType String(20)
物流子類型
請參考物流方式一覽表
IsCollection String(1)
是否代收貨款
- N：純配送，無代收貨款
- Y：貨到付款
Temperature String(4)
溫層
- 0001：常溫
- 0002：冷藏
- 0003：冷凍
Specification String(4)
規格
- 0001：60cm (預設值)
- 0002：90cm
- 0003：120cm
- 0004：150cm
LogisticsStatus String(8)
物流狀態
請參考物流狀態代碼一覽表
ShipmentNo String(25)
配送編號
- 物流類型為CVS才會回傳
- 超商B2C配送編號請讀取此欄位
BookingNote String(50)
托運單號
- 物流類型為HOME才會回傳
CVSPaymentNo String(15)
寄貨編號
- 僅當物流類型為 CVS 時會回傳。
- 超商 C2C 配送編號請使用此欄位，其中 7-ELEVEN 的配送編號需結合 CVSValidationNo 組合生成。
CVSValidationNo String(10)
驗證碼
(C2C) 7-ELEVEN才會回傳
注意事項：7-ELEVEN C2C 交貨便代碼為CVSPaymentNo與CVSValidationNo組合而成。
DeliveryDate String(10)
到店日期
格式為：yyyy/MM/dd
GoodsWeight Number
商品重量
- 當物流子類型[LogisticsSubType]為POST(中華郵政)才會回傳
- 上限20公斤，最多顯示至小數3位
- 單位為公斤(kg)
ActualWeight Number
實際重量
- 當物流子類型[LogisticsSubType]為POST(中華郵政)才會回傳
- 上限20公斤，最多顯示至小數3位
- 單位為公斤(kg)
InitShipCharge Int
初始物流運費
ActualShipCharge Int
實際物流運費
ExtraChargeFee Int
加價費用
- 1：保留中
- 2：已歸還
FeeHoldStatus Int
預扣物流費用圈存狀態
ShipChargeDate String(10)
物流運費扣款日期
格式為：yyyy/MM/dd
CollectionAmount Int
物流代收款項
CollectionChargeFee Int
物流代收金額手續費
CollectionAllocateAmount Int
物流代收款項撥款金額
注意事項：
當回傳值為0元時，以下兩種情況不代表撥款金額為0元：
- 若代收金額[CollectionAmount]大於0，且物流代收款項撥款日期[CollectionAllocateDate]無資料，表示尚未撥款。
- 若代收金額[CollectionAmount]為0元，表示此筆為無代收貨款的訂單。
CollectionAllocateDate String(10)
物流代收款項撥款日期
格式為：yyyy/MM/dd
注意事項：當DataType=2時，回傳資料為CSV檔案
綠界Response參數說明 (CSV檔案)
訂單時間
格式為：yyyy/MM/dd HH:mm:ss
廠商訂單編號
綠界物流訂單編號
商店代號
訂單金額
收件人姓名
收件人手機 / 市話
物流廠商
請參考物流方式一覽表
服務名稱
- 超商門市寄/取貨
- 大宗寄倉超商取貨
- 宅配
純配送 / 貨到付款
- 純配送
- 貨到付款
溫層
- 常溫
- 冷藏
- 冷凍
宅配規格(長+寬+高)
物流狀態
請參考物流狀態代碼一覽表
配送編號 / 托運單號
交貨便代碼 / 店到店編號
到店日期
格式為：yyyy/MM/dd
商品重量
實際重量
初始物流運費
實際物流運費
加價費用
圈存狀態
- 保留中
- 已歸還
物流費扣款日期
格式為：yyyy/MM/dd
物流代收款項
物流代收手續費率
物流代收手續費
物流代收款項撥款金額
注意事項：
當物流代收款項撥款金額為0元時，以下2種情境不代表撥款金額為0元
- 若代收金額不為0且物流代收款項撥款日期無資料，表示尚未撥款
- 若代收金額為0元，表示本訂單為不需代收貨款
物流代收款項撥款日期
格式為：yyyy/MM/dd
備註