應用場景：
提供特店查詢及下載對帳報表CSV檔，透過此API可取得物流代收款項之撥款以及物流運費扣款等資訊。
API介接網址：
- 測試環境：https://logistics-stage.ecpay.com.tw
- 正式環境：https://logistics.ecpay.com.tw
HTTPS 傳輸協定
- Content Type ：application/json
- HTTP Method ：POST
特店傳入參數(JSON格式)
PlatformID String(10)
特約合作平台商代號
- PlatformID為與綠界有合作專案的特約平台商身分使用。一般特店或賣家身分(Merchant)，或平台商本身，此參數請帶放空值。
- 若隸屬於特約平台商的一般特店，此參數請帶放平台商的MerchantID。
RqHeader Object
傳入資料 必填
Timestamp String(10)
傳入時間 必填
請將傳輸時間轉換為時間戳(GMT+8)，綠界會利用此參數將當下的時間轉為Unix TimeStamp來驗證此次介接的時間區間。
注意事項：
- 驗證時間區間為 5 分鐘內有效，若超過此驗證時間則此次訂單將無法建立，產生時間戳請參考相關資料。
- 合作特店須進行主機「時間校正」，避免主機產生時差，延伸API無法正常運作。
Data String
加密資料 必填
回傳相關資料，此為加密過JSON格式的資料。加密方法說明
特店傳入參數範例(JSON格式)
{
"MerchantID": "2000132",
"RqHeader": {
"Timestamp": "1525168923"
},
"Data": "加密資料"
}
Data參數說明(JSON格式)
MerchantID String(10)
廠商編號 必填
由綠界科技提供
NumPerPage Int
單頁顯示筆數 必填
API 查詢結果以分頁形式回傳，此參數用於設定每頁的回傳筆數。
注意事項：為了保證系統效能和響應速度，單頁上限為300筆。
ShowingPage Int
顯示的頁數 必填
注意事項：查詢結果會根據[DateFilter]設定的日期類別，按照日期時間較新排列至較舊的。
DataType String(1)
回傳資料類型
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：中華郵政
注意事項：
- 若要查詢全部時，請忽略此一參數
Data參數範例
{
"MerchantID": "2000132",
"NumPerPage": 100,
"ShowingPage": 2,
"DataType": "1",
"DateFilter": "1",
"BeginDate": "2024/10/01",
"EndDate": "2024/10/31"
}
注意事項：當DataType=1時，回傳資料為JSON格式
綠界回傳參數說明(JSON格式)
PlatformID String(10)
特約合作平台商代號
- PlatformID為與綠界有合作專案的特約平台商身分使用。一般特店或賣家身分(Merchant)，或平台商本身，此參數請帶放空值。
- 若隸屬於特約平台商的一般特店，此參數請帶放平台商的MerchantID。
RpHeader Object
回傳資料
Timestamp String(10)
回傳時間
請將傳輸時間轉換為時間戳(GMT+8)，綠界會利用此參數將當下的時間轉為Unix TimeStamp來驗證此次介接的時間區間。
注意事項：
- 驗證時間區間為 5 分鐘內有效，若超過此驗證時間則此次訂單將無法建立，產生時間戳請參考相關資料。
- 合作特店須進行主機「時間校正」，避免主機產生時差，延伸API無法正常運作。
TransCode Int
回傳代碼
1 代表 API 傳輸資料(MerchantID, RqHeader, Data)接收成功，實際的 API 執行結果狀態請參考 RtnCode。
TransMsg String(200)
回傳訊息
Data String
加密資料
回傳相關資料，此為加密過JSON格式的資料。加密方法說明
綠界回傳參數範例
{
"MerchantID": "2000132",
"RpHeader": {
"Timestamp": "1525169058"
},
"TransCode": 1,
"TransMsg": "",
"Data": "加密資料"
}
回傳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
加價費用
FeeHoldStatus Int
預扣物流費用圈存狀態
- 1：保留中
- 2：已歸還
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
Data參數範例
{
"RtnCode": 1,
"RtnMsg": "成功",
"TotalCount": 350,
"ShowingPage": 2,
"LogisticsData":[
{
"TradeDate": "2024/10/30 11:00:42",
"MerchantTradeNo":"20241030215465",
"AllPayLogisticsID": "xxxxxxxxxxxxxx",
"MerchantID": "2000132",
"GoodsAmount": 6800,
"ReceiverName": "",
"ReceiverPhone": "",
"ReceiverCellPhone": "",
"LogisticsType": "CVS",
"LogisticsSubType": "FAMI"
"IsCollection": "N",
"Temperature": "0001",
"Specification": "0001",
"LogisticsStatus":"",
"ShipmentNo":"",
"BookingNote":"",
"CVSPaymentNo":"",
"CVSValidationNo":"",
"DeliveryDate":"",
"GoodsWeight": 2,
"ActualWeight": 2,
"InitShipCharge": 60,
"ActualShipCharge": 60,
"ExtraChargeFee": 0,
"FeeHoldStatus": 1
"ShipChargeDate":"",
"CollectionAmount":0,
"CollectionChargeFee":0,
"CollectionAllocateAmount":0,
"CollectionAllocateDate":""
},
{…},
{…}
]
}
注意事項：當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
備註